跳到內容
開始使用

按鈕

動作 Button

送出取消更多停用

按鈕讓讀者做一件事,例如送出表單、確認報名、前往下一步。每個區塊裡最重要的動作用實心按鈕,其他動作用外框或淡底按鈕,讀者一眼就知道該先按哪一個;如果只是帶讀者去讀另一頁的內容,請改用「連結」。

部位說明
容器按鈕的底色和外框。實心按鈕用主色,外框按鈕只有邊框,淡底按鈕用淡淡的品牌底色。
文字必填。寫出按下去會發生什麼,例如「送出」「立即捐款」。螢幕閱讀器也會唸這段文字。
前後圖示可省略。放在文字前面或後面的小圖示,用來補充文字,不能取代文字。
焦點框用鍵盤選到按鈕時出現的外框,讓不用滑鼠的人知道目前在哪裡。顏色跟著主題。
停用狀態暫時不能按時變淡。最好在旁邊寫出為什麼不能按,以及怎麼樣才能按。
類型 說明
建議 每一個區塊(例如頁首、主視覺、表單)只放一個實心按鈕,留給那裡最重要的動作;其他動作用外框或淡底按鈕。
建議 按鈕文字寫出動作本身,例如「送出報名」「立即捐款」,讓讀者不用猜按下去會怎樣。
建議 同一組按鈕的順序在整個網站保持一致,例如「送出」永遠在「取消」的左邊。
避免 不要只寫「確定」「點這裡」這類看不出動作的文字。
避免 不要用按鈕帶讀者去讀另一頁的內容(例如「看全部消息」);那是連結的工作。報名、捐款這類主要行動,就算會換頁,也用按鈕。
避免 不要把兩件事放進同一個按鈕,例如「送出並分享」;一個按鈕只做一件事。

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

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

上方的大預覽會跟著頁首的「主題」和「色彩模式」一起變。下面把目前選的主題的淺色和深色並排,方便比較;元件只有一份,每個主題只換外觀的數值。

Default・淺色
送出 取消 更多
Default・深色
送出 取消 更多

示意 Green Natural 主題的顏色是示意值,做法還待核定。

Green Natural・淺色 示意
送出 取消 更多
Green Natural・深色 示意
送出 取消 更多

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

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

<tc-button> 是主要按鈕,提供三種變體與 form-associated 表單送出。頁面最上方的大預覽就是可互動的真實元件。

<link rel="stylesheet" href="@tzuchi/tokens/tokens.css" />
<script type="module" src="@tzuchi/components/cdn"></script>
<tc-button variant="filled">送出</tc-button>
import { TcButton } from '@tzuchi/react';
<TcButton variant="filled" onClick={handleSubmit}>送出</TcButton>;

type="submit" 時,tc-button 透過 Form-Associated Custom Elements(ElementInternals)送出所屬 <form>:

送出表單

下表自 Custom Elements Manifest 自動產生:

Attribute Type Default Description
variant 'filled' | 'outlined' | 'tonal' 'filled'
type 'button' | 'submit' | 'reset' 'button'
disabled boolean false
full-width boolean false
  • 內含原生 <button>,支援鍵盤 Enter / Space。
  • :focus-visible 焦點環使用 --tc-focus-ring-* token。
  • disabled 透過停用內部的原生控制項實作(非 pointer-events:none)。