跳到內容
開始使用

文章卡片

內容 Article Card

慈善志工寒冬送暖,關懷獨居長者

志工走入社區,為長者送上熱食與生活物資,並協助打掃居家環境。

2026-03-21 | 慈善新聞

文章卡片是新聞、文章列表裡的一則:一張圖片,加上分類、標題、兩三行摘要和日期,讀者看一眼就知道要不要點進去讀。同一個元件可以排成圖片在上的直式(上方的預覽)或圖片在左的橫式,也可以放大成凸顯最重要一則的焦點版式,或在圖片上疊一個播放鈕表示影片(下面是橫式和影片的樣子)。不需要分類、摘要和日期的一般項目(例如專案、募款項目)用「卡片」;以封面為主的書籍用「書籍卡片」;側欄裡只有標題和日期的短清單用「清單面板」。

週報本週志業簡報:各據點服務成果

彙整本週各服務據點的活動與成果,並摘要下週重點行程。

2026-03-15
影片紀實影片:志工早會現場2026-03-21 | 影片 03:24
部位說明
容器卡片的底色、圓角和淡淡的陰影,顏色跟著主題。
圖片可省略。直式時放在最上方;橫式時放在左邊,約佔卡片寬度的四成。
播放鈕只有影片卡片才有:疊在圖片中央的圓形播放鈕。它只是給眼睛看的提示,螢幕閱讀器不會唸出來。
分類標籤可省略。標題上方的小標籤,例如「慈善」「影片」。用「徽章」,不用可以點的「膠囊標籤」。
標題品牌主色的粗體字,最多顯示兩行,超過的部分會被截掉並顯示「…」。焦點版式的標題比較大。
摘要可省略。一般文字色,最多顯示三行,超過的部分會被截掉。
日期與來源可省略。最下方的小字,用比較淡的次要文字色。
動作區可省略。例如「讚」「分享」的小按鈕;整張卡片可以點時,這些按鈕仍然可以單獨按。注意:整張卡片可以點時,這個舊元件給螢幕閱讀器的連結名稱是英文的「article link」,不是文章標題;正式網站要用之前,請工程處理。
焦點框用鍵盤選到可點的卡片時出現的外框,讓不用滑鼠的人知道目前在哪裡。
類型 說明
建議 標題在兩行以內把重點講完。超過兩行的部分會被截掉,讀者在列表上看不到。
建議 摘要用一兩句話說明這篇在講什麼,超過三行的部分會被截掉。
建議 影片卡片在分類、標題或日期那一行寫出「影片」或片長。播放鈕只是圖案,看不到畫面的讀者聽不到它。
建議 同一個列表裡的卡片用同一種方向(都是直式或都是橫式),讀者比較容易往下掃。
避免 不要整個列表都用焦點版式。焦點是用來凸顯最重要的那一則,一個區塊通常只放一則。
避免 不要把重要資訊只放在日期與來源那一行。這一行字小、顏色淡,目前的次要文字色對比還不夠,正等美編(設計)修正。

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

  • 預設變體: 用元件本身的預設變體。
  • 和預設主題不同的地方: 沒有。這就是預設主題,其他主題沒有特別指定的地方都沿用它。
  • 預設變體: 主題不決定預設變體:用元件本身的預設變體(各網站自己的預設變體要等網站設定檔,還沒有實作)。
  • 和預設主題不同的地方: (以下都是示意值)只有這個元件用到的顏色:主色、主色(滑鼠移上時;連結文字也用它)、焦點框(用鍵盤選到時的外框)。其餘和預設主題一樣。 看完整的顏色對照

文章卡片還沒有各主題的對照範例;上方的大預覽會跟著頁首的「主題」和「色彩模式」一起變。

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

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

<tc-article-card> 是文稿型內容卡片,以 orientation(vertical/horizontal)、featured(焦點放大)與插槽組合涵蓋焦點文稿、一般文稿、互動式文稿、公告、影片、志工早會與週報等版式。提供 media/badge/headline/excerpt/meta/actions 插槽,支援影片播放遮罩(video)、可互動(interactive)與整張卡片連結(href,stretched link)模式。下方為可互動的真實元件(圖片以色塊代替):

慈善慈濟志工於寒冬中送暖,關懷獨居長者與弱勢家庭

志工們走入社區,為長者送上熱食與生活物資,並協助清掃居家環境,傳遞關懷與溫暖。

2022-03-21 | TCnews 慈善新聞網
<link rel="stylesheet" href="@tzuchi/tokens/tokens.css" />
<script type="module" src="@tzuchi/components/cdn"></script>
<tc-article-card href="/news/1">
<img slot="media" src="cover.jpg" alt="" />
<tc-badge slot="badge" tone="brand">慈善</tc-badge>
<span slot="headline">文章標題</span>
<p slot="excerpt">摘要內文</p>
<span slot="meta">2022-03-21</span>
</tc-article-card>
import { TcArticleCard } from '@tzuchi/react';
<TcArticleCard orientation="horizontal" href="/news/1">
<img slot="media" src="cover.jpg" alt="" />
<span slot="headline">文章標題</span>
<p slot="excerpt">摘要內文</p>
<span slot="meta">2022-03-21</span>
</TcArticleCard>;

featured 放大標題並適合搭配較大的主視覺:

焦點文稿焦點報導:跨越國界的人道援助行動

在多個國家展開的援助計畫,集結志工與在地夥伴的力量,將關懷送達最需要的地方。

2022-03-21 | TCnews 慈善新聞網

orientation="horizontal" 將媒體置於 inline-start(約 40% 寬),文字內容並列於右側:

週報本週志業簡報:各據點服務成果彙整

彙整本週各服務據點的活動與成果,並摘要下週重點行程。

2022-03-21

video 於媒體上方疊加置中的圓形播放鈕;可與 href 一起使用:

影片紀實影片:志工早會現場直擊2022-03-21 | 03:24
章節連結:連結模式與動作區(Stretched Link + actions)

設定 href 後整張卡片透過覆蓋層 <a> 變成連結;actions 內的控制項(如讚/分享)仍可獨立點擊,不會被連結攔截:

互動式文稿點整張卡片即可前往,動作區仍可獨立點擊2022-03-21♥↗

下表自 Custom Elements Manifest 自動產生:

Attribute Type Default Description
orientation 'vertical' | 'horizontal' 'vertical' 版面方向:vertical(媒體置頂)或 horizontal(媒體置於 inline-start)。
featured boolean false 焦點文稿:放大標題並使用較大的主視覺媒體。
video boolean false 影片卡片:在媒體上方疊加置中的圓形播放鈕。
href string '' 連結目標。設定後整張卡片以 stretched-link 方式變成連結。
interactive boolean false 是否可互動(無 href 時:host 可聚焦並回應 Enter/Space)。
width string '' 卡片寬度(CSS 長度,如 `320px` 或 `100%`)。未設定時由內容/容器決定。
  • href 模式以原生 <a> 為焦點與互動目標,支援鍵盤 Enter。
  • interactive(無 href)模式下,host 取得 tabindex="0" 與 role="button",並以 Enter/Space 觸發 tc-card-click。
  • actions 內的可以用鍵盤選到的控制項不會被巢狀於連結中,可獨立鍵盤操作。
  • 影片播放鈕為純視覺提示(aria-hidden),實際播放語意由媒體或連結目標承載。
  • :focus-visible 焦點環使用 --tc-focus-ring-* token。