跳到內容
開始使用

清單面板

內容 List Panel

慈濟志工關懷行動

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

執行長讚 | 分享

<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>
import { TcListPanel } from '@tzuchi/react';
<TcListPanel label="內部觀點:領航慈濟" variant="brand">
<article>
<h3>目前做的事情原因與做法</h3>
<p>2023-06-15 | 執行長</p>
</article>
</TcListPanel>;

brand(預設)為品牌主色標題列、白字;plain 為淡色標題列、內文色標題,適合次要區塊:

慈濟全球資訊網

慈濟月刊

自訂標題(header 插槽)

章節連結:自訂標題(header 插槽)

需要圖示或更複雜的標題時,用 header 插槽覆寫 label:

內部觀點:領航慈濟

用願力與行動翻轉人生

2023-06-15 | 執行長

下表自 Custom Elements Manifest 自動產生:

Attribute Type Default Description
label string '' 標題列文字(亦可用 `header` 插槽覆寫)。
variant 'brand' | 'plain' 'brand' 視覺變體:`brand`(品牌主色標題列、白字)或 `plain`(淡色標題列、內文色)。
width string '' 面板寬度(CSS 長度,如 `320px` 或 `100%`)。未設定時由內容/容器決定。
  • 標題列以 <h2> 呈現,建立頁面標題層級;使用 header 插槽時請放入適當的標題標籤。
  • 清單項目為使用者提供的內容,建議用語意化標籤(如 <article>)並維持標題層級。
  • 分隔線僅為視覺輔助,不影響朗讀順序。