跳到內容
開始使用

版心容器

版面 Container

sm
md
lg
xl(預設)

版心容器決定一段內容最寬可以到多寬,並把內容放在畫面中間,左右再留一點空白,讀者在大螢幕上不用左右轉頭讀很長的一行字。它本身看不見,上面的預覽用虛線框標出不同寬度的版心。整個網站的頁面區塊都用它包住主要內容,寬度才會一致;要把內容排成好幾欄,請在版心容器裡面再放「格線」。

部位說明
外層佔滿它所在位置的整個寬度。滿版的底色可以放在這一層,底色會延伸到畫面兩邊,文字仍留在版心裡。
版心內容真正所在的區域,有最大寬度,預設放在中間。最大寬度有五種,從窄到寬是 sm、md、lg、xl(預設)和 full。
左右內距版心兩邊的空白,手機最小,平板和桌機逐步加大,文字不會貼著螢幕邊緣。可以關掉,讓滿版圖片貼齊版心邊界。
內容放進版心容器的任何東西:標題、文章、格線、卡片等。版心容器不改變它們的樣子。

每種寬度和內距的實際數值,見下方「給工程師」。

類型 說明
建議 同一個網站的頁面區塊用同一種版心寬度,讀者在頁面之間移動時,內容的左右邊界才會對齊。
建議 需要滿版底色的區塊(例如一整條淡色背景),把底色設在版心容器的外層,文字和按鈕仍留在版心裡。
建議 以文字為主的長篇內容,可以選比較窄的寬度,一行字不會太長,比較好讀。
避免 不要在版心容器裡再放一個版心容器:左右內距會加兩次,內容會比旁邊的區塊窄。
避免 不要為了某一個區塊自己訂一個新的寬度;先從五種寬度裡選,需要新的寬度請和美編(設計)、工程討論。
避免 不要把左右內距關掉後還放文字:在手機上文字會貼著螢幕邊緣。關掉內距只用在要貼齊邊緣的滿版圖片。

目前顯示:DefaultGreen Natural(示意)。在頁首的「主題」可以切換。 查看所有主題

  • 預設變體: 用元件本身的預設變體。
  • 和預設主題不同的地方: 沒有。這就是預設主題,其他主題沒有特別指定的地方都沿用它。
  • 預設變體: 主題不決定預設變體:用元件本身的預設變體(各網站自己的預設變體要等網站設定檔,還沒有實作)。
  • 和預設主題不同的地方: 沒有。這個元件本身沒有顏色,主題不會改變它。

版心容器的寬度和內距目前所有主題都一樣;上方預覽裡的色塊會跟著頁首的「主題」和「色彩模式」一起變。

以下是給工程師的安裝與 API 說明,美編(設計)、網站的編輯和致遠(廠商)可以略過。

Storybook(給工程師逐一檢查元件狀態的工具網站,在本機用 pnpm run heroui:storybook 開啟)目前只收錄 HeroUI 的元件,還沒有 <tc-container> 的頁面;這一段的範例和 API 表就是它的說明。

<tc-container> 是版心(layout)容器:將內容約束在最大寬度內、水平置中,並提供隨視窗增長的左右內距(gutter)。size 對應設計系統的斷點寬度(--tc-container-sm/md/lg/xl/full),分別為 375 / 768 / 1024 / 1280 / 1920px。下方為可互動的真實元件(虛線框示意版心邊界):

版心容器 size=“lg”(最大寬度 1024px,水平置中,左右內距隨視窗增長)

size 設定最大寬度,對應 --tc-container-* 斷點寬度原語。full 對應 1920px 寬版(桌機全幅)。

sm · 375px
md · 768px
lg · 1024px

內距(gutter)與置中(centered)

章節連結:內距(gutter)與置中(centered)

gutter(預設開啟)提供隨視窗增長的左右內距:行動裝置 --tc-space-16、平板(≥768px)--tc-space-24、桌機(≥1024px)--tc-space-32。gutter 是布林屬性——移除整個屬性即可關閉內距(例如讓全幅媒體貼齊邊緣);以 JS 設定 el.gutter = false 亦可。centered(預設開啟)以 margin-inline:auto 水平置中。

注意:gutter 與 centered 為布林屬性,屬性存在即為 true(gutter="false" 仍為開啟)。需關閉時請移除屬性或以 property 設為 false。

無 gutter:內容貼齊版心邊界
<link rel="stylesheet" href="@tzuchi/tokens/tokens.css" />
<script type="module" src="@tzuchi/components/cdn"></script>
<tc-container size="xl">
<h1>頁面標題</h1>
<p>版心內容會被約束在最大寬度內並水平置中。</p>
</tc-container>
import { TcContainer } from '@tzuchi/react';
<TcContainer size="lg">
<h1>頁面標題</h1>
<p>版心內容</p>
</TcContainer>;

size 變體會設定內部的 --tc-container-max;若需自訂任意寬度,可直接覆寫此變數:

<tc-container style="--tc-container-max: 960px">…</tc-container>

下表自 Custom Elements Manifest 自動產生:

Attribute Type Default Description
size 'sm' | 'md' | 'lg' | 'xl' | 'full' 'xl' 最大寬度尺寸:`sm`/`md`/`lg`/`xl`/`full`,對應 `--tc-container-*` 斷點寬度。
gutter boolean true 是否套用隨視窗增長的左右內距(gutter)。
centered boolean true 是否水平置中(`margin-inline:auto`)。
  • <tc-container> 純為版面(layout)容器,不引入額外的語意角色;請在其內容中使用適當的地標(如 <main>、<section>)與標題結構。
  • 內距與最大寬度皆使用設計 token(--tc-container-*、--tc-space-*),確保跨頁面一致的版心與留白。