連結
想先看看日期?歡迎
用法
章節連結:用法連結帶讀者前往另一個頁面或網站,常放在一段文字中間,或一整排列在頁尾、選單裡。預設連結是品牌色的粗體字,讀者一眼就看得出可以點;隱性連結(subtle)平常是內文的顏色,滑過時才變色,適合放在頁尾這類一整排都是連結、讀者本來就知道可以點的地方。如果是送出、報名這類「做一件事」的動作,請改用「按鈕」。
組成
章節連結:組成| 部位 | 說明 |
|---|---|
| 連結文字 | 必填。寫出點下去會到哪裡,例如「查看活動行事曆」。字型大小跟著周圍的文字,所以可以直接放在段落裡。 |
| 顏色 | 預設連結是品牌色粗體,隱性連結是內文的顏色。滑鼠移上去時變色並出現底線。 |
| 焦點框 | 用鍵盤選到連結時出現的外框,讓不用滑鼠的人知道目前在哪裡。 |
| 停用狀態 | 變成淡灰色、點了不會換頁;螢幕閱讀器仍然唸得到這段文字。 |
該做與不該做
章節連結:該做與不該做| 類型 | 說明 |
|---|---|
| 建議 | 連結文字寫出會到哪裡,例如「查看活動行事曆」「下載報名表」;不要只寫「這裡」「更多」。螢幕閱讀器的使用者常常只聽連結文字。 |
| 建議 | 只挑最能說明去向的幾個字做成連結,不要把整句或整段文字都做成連結。 |
| 建議 | 會開到其他網站或新視窗的連結,在文字裡說清楚,例如「慈濟基金會官網(另開新視窗)」。 |
| 避免 | 不要在段落中間用隱性連結。它平常和內文同色,讀者看不出可以點;用手機時也沒有滑鼠移上去變色的提示。 |
| 避免 | 不要用連結做送出、報名、捐款、分享這類主要行動;請用「按鈕」。 |
在目前主題下的樣子
章節連結:在目前主題下的樣子目前顯示:DefaultGreen Natural(示意)。在頁首的「主題」可以切換。 查看所有主題
- 預設變體: 用元件本身的預設變體。
- 和預設主題不同的地方: 沒有。這就是預設主題,其他主題沒有特別指定的地方都沿用它。
- 預設變體: 主題不決定預設變體:用元件本身的預設變體(各網站自己的預設變體要等網站設定檔,還沒有實作)。
- 和預設主題不同的地方: (以下都是示意值)只有這個元件用到的顏色:主色(滑鼠移上時;連結文字也用它)、焦點框(用鍵盤選到時的外框)。其餘和預設主題一樣。 看完整的顏色對照
上方的大預覽會跟著頁首的「主題」和「色彩模式」一起變;這個元件還沒有淺色、深色並排的範例。
給工程師
章節連結:給工程師以下是給工程師的安裝與 API 說明,美編(設計)、網站的編輯和致遠(廠商)可以略過。
Storybook(給工程師逐一檢查元件狀態的工具網站,在本機用 pnpm run heroui:storybook 開啟)目前只收錄 HeroUI 的元件,還沒有 <tc-link> 的頁面;這一段的範例和 API 表就是它的說明。
<tc-link> 是行內文字連結,內部使用原生 <a>,保留原生點擊與導覽行為。下方為可互動的真實元件:
行內使用
章節連結:行內使用tc-link 為 display: inline,可直接置於段落文字之中:
慈濟基金會在全球推動慈善志業,歡迎您
純 HTML
章節連結:純 HTML<link rel="stylesheet" href="@tzuchi/tokens/tokens.css" /><script type="module" src="@tzuchi/components/cdn"></script>
<tc-link href="/about">了解更多</tc-link><tc-link href="https://example.org" target="_blank">外部連結</tc-link>React
章節連結:Reactimport { TcLink } from '@tzuchi/react';
<TcLink href="/about">了解更多</TcLink>;API
章節連結:API下表自 Custom Elements Manifest 自動產生:
| Attribute | Type | Default | Description |
|---|---|---|---|
href | string | '' | 連結目標網址。 |
target | string | '' | `<a target>`,例如 `_blank`。 |
rel | string | '' | `<a rel>`。`target="_blank"` 時自動補上 `noopener noreferrer`。 |
variant | 'default' | 'subtle' | 'default' | 視覺變體:`default`(品牌色)或 `subtle`(內文色,hover 變品牌色)。 |
disabled | boolean | false | 停用:改以 `<span aria-disabled>` 呈現,無法點擊或導覽。 |
無障礙(Accessibility)
章節連結:無障礙(Accessibility)- 內含原生
<a>,支援鍵盤 Enter 與螢幕閱讀器的連結語意。 :focus-visible焦點環使用--tc-focus-ring-*token。disabled時改以<span aria-disabled="true">呈現,無法點擊或導覽(非pointer-events:none,AT 仍可讀取)。target="_blank"會自動補上rel="noopener noreferrer",可由rel屬性覆寫。