跳到內容
開始使用

卡片

內容 Card

歲末冬令發放

募款至 12 月 31 日

捐款
環保志工招募

每週六上午,歡迎加入

卡片把一張圖片、一個標題、一兩行說明和按鈕收成一塊,讓讀者可以並排瀏覽、挑一個點進去,例如專案、活動或募款項目。上方第一張是有陰影的卡片(elevated);第二張是只有外框、沒有陰影的卡片(outlined),看起來比較平。如果是新聞或文章列表,需要分類、摘要和日期,請改用「文章卡片」;以封面為主的書籍或出版品用「書籍卡片」;沒有圖片的純文字清單用「清單面板」。

部位說明
容器卡片的底色和圓角。有陰影(elevated)或只有外框(outlined)兩種,顏色跟著主題。
圖片可省略。放在卡片最上方、和卡片一樣寬。
標題卡片的名稱,用品牌主色的粗體大字。標題不會自動截短,字太多時卡片會被撐高。
內文可省略。標題下方的說明,例如日期、來源或一兩句介紹。
動作區可省略。放在最下方的按鈕,例如「捐款」。按鈕排成一列,不會換行。
整張可點可省略。整張卡片連到另一頁時,滑過卡片陰影會變深、標題變色;動作區的按鈕仍然可以單獨按。注意:這個舊元件給螢幕閱讀器的連結名稱是英文的「card link」,不是卡片標題;正式網站要用之前,請工程處理。
焦點框用鍵盤選到可點的卡片時出現的外框,讓不用滑鼠的人知道目前在哪裡。
類型 說明
建議 同一排並排的卡片用同一種樣式(有陰影或只有外框)和相同寬度,標題長度也接近,排起來才整齊。
建議 標題寫短一點,最好在 15 個字以內;卡片標題不會自動截短,太長會讓這一張比旁邊的高。
建議 整張卡片要帶讀者到另一頁時,就讓整張卡片可以點,不要只讓標題可以點;需要另外的動作(例如「分享」)放在動作區。
建議 圖片要寫替代文字,說明圖片的內容;只是裝飾的圖片才留空。
避免 動作區不要放超過兩個按鈕。按鈕排成一列、不會換行,卡片窄的時候會擠出卡片外。
避免 卡片裡的按鈕不要用實心按鈕;用外框或淡底按鈕,實心留給整頁最重要的動作。卡片並排時,每張都有實心按鈕,讀者就看不出哪個最重要。

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

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

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

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

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

<tc-card> 是卡片容器,提供 media/headline/內文/footer 插槽,以及 elevated 與 outlined 兩種變體。互動時提升陰影(elevation)。用 width 屬性控制寬度(CSS 長度)。下方為可互動的真實元件(圖片以色塊代替):

專案名稱

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

捐款
文章標題(建議字數在 15 字以內)

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

<link rel="stylesheet" href="@tzuchi/tokens/tokens.css" />
<script type="module" src="@tzuchi/components/cdn"></script>
<tc-card variant="elevated">
<img slot="media" src="cover.jpg" alt="" />
<span slot="headline">專案名稱</span>
<p>卡片內文</p>
<tc-button slot="footer">捐款</tc-button>
</tc-card>
import { TcCard } from '@tzuchi/react';
<TcCard variant="elevated" href="/news/1">
<span slot="headline">專案名稱</span>
<p>卡片內文</p>
</TcCard>;

width 接受任何 CSS 長度(如 320px、100%),等同設定 --tc-card-width:

240px 卡片
章節連結:連結模式(Stretched Link)

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

點整張卡片即可前往

footer 按鈕仍可獨立點擊

分享

下表自 Custom Elements Manifest 自動產生:

Attribute Type Default Description
variant 'elevated' | 'outlined' 'elevated' 視覺變體:elevated(陰影)或 outlined(邊框)。
interactive boolean false 是否可互動(無 href 時:host 可聚焦並回應 Enter/Space)。
href string '' 連結目標。設定後整張卡片以 stretched-link 方式變成連結。
width string '' 卡片寬度(CSS 長度,如 `320px` 或 `100%`)。未設定時由內容/容器決定。
  • href 模式以原生 <a> 為焦點與互動目標,支援鍵盤 Enter。
  • interactive(無 href)模式下,host 取得 tabindex="0" 與 role="button",並以 Enter/Space 觸發 tc-card-click。
  • footer 內的可以用鍵盤選到的控制項不會被巢狀於連結中,可獨立鍵盤操作。
  • :focus-visible 焦點環使用 --tc-focus-ring-* token。