版心容器
用法
章節連結:用法版心容器決定一段內容最寬可以到多寬,並把內容放在畫面中間,左右再留一點空白,讀者在大螢幕上不用左右轉頭讀很長的一行字。它本身看不見,上面的預覽用虛線框標出不同寬度的版心。整個網站的頁面區塊都用它包住主要內容,寬度才會一致;要把內容排成好幾欄,請在版心容器裡面再放「格線」。
組成
章節連結:組成| 部位 | 說明 |
|---|---|
| 外層 | 佔滿它所在位置的整個寬度。滿版的底色可以放在這一層,底色會延伸到畫面兩邊,文字仍留在版心裡。 |
| 版心 | 內容真正所在的區域,有最大寬度,預設放在中間。最大寬度有五種,從窄到寬是 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)
章節連結:尺寸(size)size 設定最大寬度,對應 --tc-container-* 斷點寬度原語。full 對應 1920px 寬版(桌機全幅)。
內距(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。
純 HTML
章節連結:純 HTML<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>React
章節連結:Reactimport { 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>API
章節連結:API下表自 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`)。 |
無障礙(Accessibility)
章節連結:無障礙(Accessibility)<tc-container>純為版面(layout)容器,不引入額外的語意角色;請在其內容中使用適當的地標(如<main>、<section>)與標題結構。- 內距與最大寬度皆使用設計 token(
--tc-container-*、--tc-space-*),確保跨頁面一致的版心與留白。