2026-06-15
清單面板
2026-06-12
用法
章節連結:用法清單面板是一塊有標題列的直式清單:上面一條彩色的標題列說明這一組是什麼,下面一列一列排出項目,項目之間自動加上細分隔線,常放在首頁側欄,例如「最新消息」。重要的區塊用品牌主色的標題列(上方第一個),次要的區塊例如「相關連結」用淡色的標題列(上方第二個)。每一則都需要圖片和摘要時,請改用「文章卡片」;要讓讀者並排挑選的項目用「卡片」。
組成
章節連結:組成| 部位 | 說明 |
|---|---|
| 標題列 | 面板最上方的一條。品牌主色底配白字(brand),或淡色底配一般文字色(plain)。螢幕閱讀器會把它當成這一區的標題。需要圖示時可以換成自訂的標題。 |
| 清單項目 | 標題列下方的一列一列內容,例如標題加日期。每一則是一列,內容由網站自己放。 |
| 分隔線 | 項目之間的細線,自動加上,不必自己畫。 |
| 外框 | 整個面板的細外框和圓角,顏色跟著主題。 |
該做與不該做
章節連結:該做與不該做| 類型 | 說明 |
|---|---|
| 建議 | 標題列用幾個字說出這一組是什麼,例如「最新消息」「相關連結」。它也是這一區給螢幕閱讀器的標題。 |
| 建議 | 每一列的寫法保持一致,例如都是「標題+日期」,讀者才能很快往下掃。 |
| 建議 | 一個頁面上,主要的面板用品牌主色的標題列,次要的面板用淡色標題列,讀者一眼分得出輕重。 |
| 避免 | 不要在清單面板裡放大圖或長摘要;每一則需要圖片和摘要時,改用「文章卡片」。 |
| 避免 | 不要讓標題列空白。沒有標題的面板,讀者和螢幕閱讀器都不知道這一區在講什麼。 |
在目前主題下的樣子
章節連結:在目前主題下的樣子目前顯示:DefaultGreen Natural(示意)。在頁首的「主題」可以切換。 查看所有主題
- 預設變體: 用元件本身的預設變體。
- 和預設主題不同的地方: 沒有。這就是預設主題,其他主題沒有特別指定的地方都沿用它。
- 預設變體: 主題不決定預設變體:用元件本身的預設變體(各網站自己的預設變體要等網站設定檔,還沒有實作)。
- 和預設主題不同的地方: (以下都是示意值)只有這個元件用到的顏色:主色、主色上的文字。其餘和預設主題一樣。 看完整的顏色對照
清單面板還沒有各主題的對照範例;上方的大預覽會跟著頁首的「主題」和「色彩模式」一起變。
給工程師
章節連結:給工程師以下是給工程師的安裝與 API 說明,美編(設計)、網站的編輯和致遠(廠商)可以略過。
Storybook(給工程師逐一檢查元件狀態的工具網站,在本機用 pnpm run heroui:storybook 開啟)目前只收錄 HeroUI 的元件,還沒有 <tc-list-panel> 的頁面;這一段的範例和 API 表就是它的說明。
<tc-list-panel> 是標題面板:上方為彩色標題列(brand 變體為品牌主色底、白字),下方為由預設插槽提供的垂直清單,項目間自動加上細分隔線。標題以 label 屬性設定,或用 header 插槽覆寫。用 width 屬性控制寬度(CSS 長度)。下方為可互動的真實元件:
目前做的事情原因與做法
2023-06-15
執行長讚 | 分享
目前做的事情原因與做法
2023-06-15
執行長讚 | 分享
純 HTML
章節連結:純 HTML<link rel="stylesheet" href="@tzuchi/tokens/tokens.css" /><script type="module" src="@tzuchi/components/cdn"></script>
<tc-list-panel label="內部觀點:領航慈濟"> <article> <h3>目前做的事情原因與做法</h3> <p>2023-06-15 | 執行長</p> </article> <article> <h3>用願力與行動翻轉人生</h3> <p>2023-06-15 | 執行長</p> </article></tc-list-panel>React
章節連結:Reactimport { TcListPanel } from '@tzuchi/react';
<TcListPanel label="內部觀點:領航慈濟" variant="brand"> <article> <h3>目前做的事情原因與做法</h3> <p>2023-06-15 | 執行長</p> </article></TcListPanel>;變體(variant)
章節連結:變體(variant)brand(預設)為品牌主色標題列、白字;plain 為淡色標題列、內文色標題,適合次要區塊:
慈濟全球資訊網
慈濟月刊
自訂標題(header 插槽)
章節連結:自訂標題(header 插槽)需要圖示或更複雜的標題時,用 header 插槽覆寫 label:
內部觀點:領航慈濟
用願力與行動翻轉人生
2023-06-15 | 執行長
API
章節連結:API下表自 Custom Elements Manifest 自動產生:
| Attribute | Type | Default | Description |
|---|---|---|---|
label | string | '' | 標題列文字(亦可用 `header` 插槽覆寫)。 |
variant | 'brand' | 'plain' | 'brand' | 視覺變體:`brand`(品牌主色標題列、白字)或 `plain`(淡色標題列、內文色)。 |
width | string | '' | 面板寬度(CSS 長度,如 `320px` 或 `100%`)。未設定時由內容/容器決定。 |
無障礙(Accessibility)
章節連結:無障礙(Accessibility)- 標題列以
<h2>呈現,建立頁面標題層級;使用header插槽時請放入適當的標題標籤。 - 清單項目為使用者提供的內容,建議用語意化標籤(如
<article>)並維持標題層級。 - 分隔線僅為視覺輔助,不影響朗讀順序。