文章卡片
志工走入社區,為長者送上熱食與生活物資,並協助打掃居家環境。
2026-03-21 | 慈善新聞用法
章節連結:用法文章卡片是新聞、文章列表裡的一則:一張圖片,加上分類、標題、兩三行摘要和日期,讀者看一眼就知道要不要點進去讀。同一個元件可以排成圖片在上的直式(上方的預覽)或圖片在左的橫式,也可以放大成凸顯最重要一則的焦點版式,或在圖片上疊一個播放鈕表示影片(下面是橫式和影片的樣子)。不需要分類、摘要和日期的一般項目(例如專案、募款項目)用「卡片」;以封面為主的書籍用「書籍卡片」;側欄裡只有標題和日期的短清單用「清單面板」。
彙整本週各服務據點的活動與成果,並摘要下週重點行程。
2026-03-15組成
章節連結:組成| 部位 | 說明 |
|---|---|
| 容器 | 卡片的底色、圓角和淡淡的陰影,顏色跟著主題。 |
| 圖片 | 可省略。直式時放在最上方;橫式時放在左邊,約佔卡片寬度的四成。 |
| 播放鈕 | 只有影片卡片才有:疊在圖片中央的圓形播放鈕。它只是給眼睛看的提示,螢幕閱讀器不會唸出來。 |
| 分類標籤 | 可省略。標題上方的小標籤,例如「慈善」「影片」。用「徽章」,不用可以點的「膠囊標籤」。 |
| 標題 | 品牌主色的粗體字,最多顯示兩行,超過的部分會被截掉並顯示「…」。焦點版式的標題比較大。 |
| 摘要 | 可省略。一般文字色,最多顯示三行,超過的部分會被截掉。 |
| 日期與來源 | 可省略。最下方的小字,用比較淡的次要文字色。 |
| 動作區 | 可省略。例如「讚」「分享」的小按鈕;整張卡片可以點時,這些按鈕仍然可以單獨按。注意:整張卡片可以點時,這個舊元件給螢幕閱讀器的連結名稱是英文的「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 慈善新聞網純 HTML
章節連結:純 HTML<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>React
章節連結:Reactimport { 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)
章節連結:焦點文稿(featured)featured 放大標題並適合搭配較大的主視覺:
在多個國家展開的援助計畫,集結志工與在地夥伴的力量,將關懷送達最需要的地方。
2022-03-21 | TCnews 慈善新聞網橫向版式(horizontal)
章節連結:橫向版式(horizontal)orientation="horizontal" 將媒體置於 inline-start(約 40% 寬),文字內容並列於右側:
彙整本週各服務據點的活動與成果,並摘要下週重點行程。
2022-03-21影片卡片(video)
章節連結:影片卡片(video)video 於媒體上方疊加置中的圓形播放鈕;可與 href 一起使用:
連結模式與動作區(Stretched Link + actions)
章節連結:連結模式與動作區(Stretched Link + actions)設定 href 後整張卡片透過覆蓋層 <a> 變成連結;actions 內的控制項(如讚/分享)仍可獨立點擊,不會被連結攔截:
API
章節連結:API下表自 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%`)。未設定時由內容/容器決定。 |
無障礙(Accessibility)
章節連結:無障礙(Accessibility)href模式以原生<a>為焦點與互動目標,支援鍵盤 Enter。interactive(無href)模式下,host 取得tabindex="0"與role="button",並以 Enter/Space 觸發tc-card-click。actions內的可以用鍵盤選到的控制項不會被巢狀於連結中,可獨立鍵盤操作。- 影片播放鈕為純視覺提示(
aria-hidden),實際播放語意由媒體或連結目標承載。 :focus-visible焦點環使用--tc-focus-ring-*token。