跳到內容
開始使用

書籍卡片

內容 Book Card

每日一叮嚀世間祥和在於心更多
靜思語選輯心寬念純
環保手冊方形封面

書籍卡片以封面為主:封面圖佔卡片的大部分,下面只有書名、一行副標和「更多」這類連結,適合書籍、出版品和「每日一叮嚀」這類以一張圖為主角的內容。封面可以是直式(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 方形)裁切並貼齊頂部圓角。下方為可互動的真實元件(圖片以色塊代替):

證嚴上人 每日一叮嚀世間祥和在於心……更多
靜思語選輯(建議標題在 15 字以內)心寬念純,福慧雙修……更多
<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>
import { 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="portrait"(預設)為 3/4 直式封面;ratio="square" 為 1/1 方形封面:

方形封面適用相片或方形書影

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

章節連結:連結模式(Stretched Link)

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

點整張卡片即可前往footer 連結仍可獨立點擊更多

下表自 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%`)。未設定時由內容/容器決定。
  • href 模式以原生 <a> 為焦點與互動目標,支援鍵盤 Enter。
  • interactive(無 href)模式下,host 取得 tabindex="0" 與 role="button",並以 Enter/Space 觸發 tc-book-card-click。
  • footer 內的可以用鍵盤選到的控制項不會被巢狀於連結中,可獨立鍵盤操作。
  • :focus-visible 焦點環使用 --tc-focus-ring-* token。