跳到內容
開始使用

連結

動作 Link

想先看看日期?歡迎查看活動行事曆,或下載報名表。

預設連結隱性連結停用連結

連結帶讀者前往另一個頁面或網站,常放在一段文字中間,或一整排列在頁尾、選單裡。預設連結是品牌色的粗體字,讀者一眼就看得出可以點;隱性連結(subtle)平常是內文的顏色,滑過時才變色,適合放在頁尾這類一整排都是連結、讀者本來就知道可以點的地方。如果是送出、報名這類「做一件事」的動作,請改用「按鈕」。

部位說明
連結文字必填。寫出點下去會到哪裡,例如「查看活動行事曆」。字型大小跟著周圍的文字,所以可以直接放在段落裡。
顏色預設連結是品牌色粗體,隱性連結是內文的顏色。滑鼠移上去時變色並出現底線。
焦點框用鍵盤選到連結時出現的外框,讓不用滑鼠的人知道目前在哪裡。
停用狀態變成淡灰色、點了不會換頁;螢幕閱讀器仍然唸得到這段文字。
類型 說明
建議 連結文字寫出會到哪裡,例如「查看活動行事曆」「下載報名表」;不要只寫「這裡」「更多」。螢幕閱讀器的使用者常常只聽連結文字。
建議 只挑最能說明去向的幾個字做成連結,不要把整句或整段文字都做成連結。
建議 會開到其他網站或新視窗的連結,在文字裡說清楚,例如「慈濟基金會官網(另開新視窗)」。
避免 不要在段落中間用隱性連結。它平常和內文同色,讀者看不出可以點;用手機時也沒有滑鼠移上去變色的提示。
避免 不要用連結做送出、報名、捐款、分享這類主要行動;請用「按鈕」。

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

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

上方的大預覽會跟著頁首的「主題」和「色彩模式」一起變;這個元件還沒有淺色、深色並排的範例。

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

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

<tc-link> 是行內文字連結,內部使用原生 <a>,保留原生點擊與導覽行為。下方為可互動的真實元件:

詳細了解我們所做的隱性連結停用連結

tc-link 為 display: inline,可直接置於段落文字之中:

慈濟基金會在全球推動慈善志業,歡迎您 詳細了解我們所做的 ,一起成就善的循環。

<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>
import { TcLink } from '@tzuchi/react';
<TcLink href="/about">了解更多</TcLink>;

下表自 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>` 呈現,無法點擊或導覽。
  • 內含原生 <a>,支援鍵盤 Enter 與螢幕閱讀器的連結語意。
  • :focus-visible 焦點環使用 --tc-focus-ring-* token。
  • disabled 時改以 <span aria-disabled="true"> 呈現,無法點擊或導覽(非 pointer-events:none,AT 仍可讀取)。
  • target="_blank" 會自動補上 rel="noopener noreferrer",可由 rel 屬性覆寫。