按鈕
用法
章節連結:用法按鈕讓讀者做一件事,例如送出表單、確認報名、前往下一步。每個區塊裡最重要的動作用實心按鈕,其他動作用外框或淡底按鈕,讀者一眼就知道該先按哪一個;如果只是帶讀者去讀另一頁的內容,請改用「連結」。
組成
章節連結:組成| 部位 | 說明 |
|---|---|
| 容器 | 按鈕的底色和外框。實心按鈕用主色,外框按鈕只有邊框,淡底按鈕用淡淡的品牌底色。 |
| 文字 | 必填。寫出按下去會發生什麼,例如「送出」「立即捐款」。螢幕閱讀器也會唸這段文字。 |
| 前後圖示 | 可省略。放在文字前面或後面的小圖示,用來補充文字,不能取代文字。 |
| 焦點框 | 用鍵盤選到按鈕時出現的外框,讓不用滑鼠的人知道目前在哪裡。顏色跟著主題。 |
| 停用狀態 | 暫時不能按時變淡。最好在旁邊寫出為什麼不能按,以及怎麼樣才能按。 |
該做與不該做
章節連結:該做與不該做| 類型 | 說明 |
|---|---|
| 建議 | 每一個區塊(例如頁首、主視覺、表單)只放一個實心按鈕,留給那裡最重要的動作;其他動作用外框或淡底按鈕。 |
| 建議 | 按鈕文字寫出動作本身,例如「送出報名」「立即捐款」,讓讀者不用猜按下去會怎樣。 |
| 建議 | 同一組按鈕的順序在整個網站保持一致,例如「送出」永遠在「取消」的左邊。 |
| 避免 | 不要只寫「確定」「點這裡」這類看不出動作的文字。 |
| 避免 | 不要用按鈕帶讀者去讀另一頁的內容(例如「看全部消息」);那是連結的工作。報名、捐款這類主要行動,就算會換頁,也用按鈕。 |
| 避免 | 不要把兩件事放進同一個按鈕,例如「送出並分享」;一個按鈕只做一件事。 |
在目前主題下的樣子
章節連結:在目前主題下的樣子目前顯示:DefaultGreen Natural(示意)。在頁首的「主題」可以切換。 查看所有主題
- 預設變體: 用元件本身的預設變體。
- 和預設主題不同的地方: 沒有。這就是預設主題,其他主題沒有特別指定的地方都沿用它。
- 預設變體: 主題不決定預設變體:用元件本身的預設變體(各網站自己的預設變體要等網站設定檔,還沒有實作)。
- 和預設主題不同的地方: (以下都是示意值)只有這個元件用到的顏色:主色、主色(滑鼠移上時;連結文字也用它)、品牌底色(襯在內容後的品牌色塊)、品牌底色(滑鼠移上時)、主色上的文字、焦點框(用鍵盤選到時的外框)。其餘和預設主題一樣。 看完整的顏色對照
上方的大預覽會跟著頁首的「主題」和「色彩模式」一起變。下面把目前選的主題的淺色和深色並排,方便比較;元件只有一份,每個主題只換外觀的數值。
示意 Green Natural 主題的顏色是示意值,做法還待核定。
給工程師
章節連結:給工程師以下是給工程師的安裝與 API 說明,美編(設計)、網站的編輯和致遠(廠商)可以略過。
Storybook(給工程師逐一檢查元件狀態的工具網站,在本機用 pnpm run heroui:storybook 開啟)目前只收錄 HeroUI 的元件,還沒有 <tc-button> 的頁面;這一段的範例和 API 表就是它的說明。
<tc-button> 是主要按鈕,提供三種變體與 form-associated 表單送出。頁面最上方的大預覽就是可互動的真實元件。
純 HTML
章節連結:純 HTML<link rel="stylesheet" href="@tzuchi/tokens/tokens.css" /><script type="module" src="@tzuchi/components/cdn"></script>
<tc-button variant="filled">送出</tc-button>React
章節連結:Reactimport { TcButton } from '@tzuchi/react';
<TcButton variant="filled" onClick={handleSubmit}>送出</TcButton>;表單
章節連結:表單type="submit" 時,tc-button 透過 Form-Associated Custom Elements(ElementInternals)送出所屬 <form>:
API
章節連結:API下表自 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)。