書籍卡片
用法
章節連結:用法書籍卡片以封面為主:封面圖佔卡片的大部分,下面只有書名、一行副標和「更多」這類連結,適合書籍、出版品和「每日一叮嚀」這類以一張圖為主角的內容。封面可以是直式(3:4,上方前兩張)或方形(1:1,上方第三張)。圖片不是主角、需要較長說明或按鈕的項目用「卡片」;新聞、文章列表用「文章卡片」。
組成
章節連結:組成| 部位 | 說明 |
|---|---|
| 容器 | 卡片的底色、圓角和淡淡的陰影,顏色跟著主題。 |
| 封面 | 卡片上方的大圖,依設定裁成直式(3:4)或方形(1:1);比例不合的圖片,超出的部分會被裁掉。 |
| 標題 | 書名,用品牌主色的粗體字,最多顯示兩行,超過的部分會被截掉並顯示「…」。 |
| 副標 | 可省略。標題下方的淡色小字,只顯示一行,超過的部分會被截掉。 |
| 動作區 | 可省略。最下方的連結或按鈕,例如「更多」;整張卡片可以點時,這裡仍然可以單獨按。 |
| 整張可點 | 可省略。整張卡片連到另一頁時,滑過卡片陰影會變深、標題變色。注意:這個舊元件給螢幕閱讀器的連結名稱是英文的「book card link」,不是書名;正式網站要用之前,請工程處理。 |
| 焦點框 | 用鍵盤選到可點的卡片時出現的外框,讓不用滑鼠的人知道目前在哪裡。 |
該做與不該做
章節連結:該做與不該做| 類型 | 說明 |
|---|---|
| 建議 | 封面圖照卡片的比例準備:書籍用直式 3:4,方形的書影或相片用 1:1。比例不合的圖片會被裁掉邊緣,書名可能被切到。 |
| 建議 | 同一排的書籍卡片用同一種封面比例和相同寬度,排起來才整齊。 |
| 建議 | 封面圖要寫替代文字,至少寫出書名,看不到圖片的讀者也知道這是哪一本。 |
| 避免 | 副標只顯示一行,不要把作者、出版日期、價格等重要資訊都擠在副標裡。 |
| 避免 | 書名不要超過兩行。超過的部分會被截掉,讀者看不到完整書名。 |
在目前主題下的樣子
章節連結:在目前主題下的樣子目前顯示:DefaultGreen Natural(示意)。在頁首的「主題」可以切換。 查看所有主題
- 預設變體: 用元件本身的預設變體。
- 和預設主題不同的地方: 沒有。這就是預設主題,其他主題沒有特別指定的地方都沿用它。
- 預設變體: 主題不決定預設變體:用元件本身的預設變體(各網站自己的預設變體要等網站設定檔,還沒有實作)。
- 和預設主題不同的地方: (以下都是示意值)只有這個元件用到的顏色:主色、主色(滑鼠移上時;連結文字也用它)、焦點框(用鍵盤選到時的外框)。其餘和預設主題一樣。 看完整的顏色對照
書籍卡片還沒有各主題的對照範例;上方的大預覽會跟著頁首的「主題」和「色彩模式」一起變。
給工程師
章節連結:給工程師以下是給工程師的安裝與 API 說明,美編(設計)、網站的編輯和致遠(廠商)可以略過。
Storybook(給工程師逐一檢查元件狀態的工具網站,在本機用 pnpm run heroui:storybook 開啟)目前只收錄 HeroUI 的元件,還沒有 <tc-book-card> 的頁面;這一段的範例和 API 表就是它的說明。
<tc-book-card> 是以封面圖為主的直式卡片,適用於書籍封面與「證嚴上人 每日一叮嚀」。封面圖在上、下方為標題(粗體品牌色)/副標(淡色)與 footer 動作區。封面依 ratio(portrait 直式 3/4 或 square 方形)裁切並貼齊頂部圓角。下方為可互動的真實元件(圖片以色塊代替):
純 HTML
章節連結:純 HTML<link rel="stylesheet" href="@tzuchi/tokens/tokens.css" /><script type="module" src="@tzuchi/components/cdn"></script>
<tc-book-card> <img slot="cover" src="cover.jpg" alt="書籍封面" /> <span slot="title">證嚴上人 每日一叮嚀</span> <span slot="subtitle">世間祥和在於心</span> <tc-link slot="footer" href="/more">更多</tc-link></tc-book-card>React
章節連結:Reactimport { TcBookCard } from '@tzuchi/react';
<TcBookCard href="/books/1"> <img slot="cover" src="cover.jpg" alt="" /> <span slot="title">證嚴上人 每日一叮嚀</span> <span slot="subtitle">世間祥和在於心</span></TcBookCard>;封面比例(ratio)
章節連結:封面比例(ratio)ratio="portrait"(預設)為 3/4 直式封面;ratio="square" 為 1/1 方形封面:
寬度(width)
章節連結:寬度(width)width 接受任何 CSS 長度(如 240px、100%),等同設定 --tc-book-card-width。
連結模式(Stretched Link)
章節連結:連結模式(Stretched Link)設定 href 後,整張卡片透過覆蓋層 <a> 變成連結;footer 內的控制項(如「更多」連結)仍可獨立點擊,不會被連結攔截:
API
章節連結:API下表自 Custom Elements Manifest 自動產生:
| Attribute | Type | Default | Description |
|---|---|---|---|
interactive | boolean | false | 是否可互動(無 href 時:host 可聚焦並回應 Enter/Space)。 |
href | string | '' | 連結目標。設定後整張卡片以 stretched-link 方式變成連結。 |
ratio | 'portrait' | 'square' | 'portrait' | 封面長寬比:portrait(直式 3/4)或 square(方形 1/1)。 |
width | string | '' | 卡片寬度(CSS 長度,如 `240px` 或 `100%`)。未設定時由內容/容器決定。 |
無障礙(Accessibility)
章節連結:無障礙(Accessibility)href模式以原生<a>為焦點與互動目標,支援鍵盤 Enter。interactive(無href)模式下,host 取得tabindex="0"與role="button",並以 Enter/Space 觸發tc-book-card-click。footer內的可以用鍵盤選到的控制項不會被巢狀於連結中,可獨立鍵盤操作。:focus-visible焦點環使用--tc-focus-ring-*token。