卡片
募款至 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 慈善新聞網
2022-03-21 | TCnews 慈善新聞網
純 HTML
章節連結:純 HTML<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>React
章節連結:Reactimport { TcCard } from '@tzuchi/react';
<TcCard variant="elevated" href="/news/1"> <span slot="headline">專案名稱</span> <p>卡片內文</p></TcCard>;寬度(width)
章節連結:寬度(width)width 接受任何 CSS 長度(如 320px、100%),等同設定 --tc-card-width:
連結模式(Stretched Link)
章節連結:連結模式(Stretched Link)設定 href 後,整張卡片透過覆蓋層 <a> 變成連結;footer 內的控制項仍可獨立點擊,不會被連結攔截:
footer 按鈕仍可獨立點擊
API
章節連結:API下表自 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%`)。未設定時由內容/容器決定。 |
無障礙(Accessibility)
章節連結:無障礙(Accessibility)href模式以原生<a>為焦點與互動目標,支援鍵盤 Enter。interactive(無href)模式下,host 取得tabindex="0"與role="button",並以 Enter/Space 觸發tc-card-click。footer內的可以用鍵盤選到的控制項不會被巢狀於連結中,可獨立鍵盤操作。:focus-visible焦點環使用--tc-focus-ring-*token。