當表單設定恰好有兩種狀態,且應以原生 HTML 核取方塊表示時,請產生 CSS 切換開關。
可將它用於深色模式或電子郵件通知等偏好設定,以開關位置顯示選取的狀態。它不適合用於傳送測試電子郵件等一次性指令,也不適合用於需要 radio button 或 select 控制項的多個互斥選項。

讓控制項符合使用者的工作
應依使用者的預定動作選擇元件,而不是依其視覺樣式。開關用來表示目前的二元值;其他控制項則用來表示指令、各自獨立的確認事項或多個選項。
| 控制項 | 適用情境 | 主要差異 |
|---|---|---|
| CSS 切換開關 | 具有兩種相反狀態的設定 | 它顯示目前狀態,而值則由原生核取方塊承載。 |
| 核取方塊 | 各自獨立的確認或選擇加入 | 它可以出現在其他獨立選項旁,而不必表示一組開啟/關閉選項。 |
| 動作按鈕 | 一次性指令 | 它會執行動作,而不是維持在某個啟用狀態。 |
| Radio button 或 select | 多個互斥選項 | 單一開關無法傳達所有可用選項。 |
請命名實際的設定,不要依賴「啟用功能」等一般性標籤。「電子郵件通知」等簡潔標籤能提供使用者更多背景資訊,而「深色模式」則直接描述偏好設定。如果相鄰文字無法清楚顯示目前狀態,且該狀態會帶來重要影響,請加入明確的狀態說法。
另外,請分別決定選取值要儲存在何處,以及它是否必須在瀏覽其他頁面或重新載入頁面後仍然存在。產生的開關只提供外觀與原生互動,並不提供伺服器端持久化功能。應用程式必須負責儲存、回報待處理工作,以及從更新失敗的情況中復原。
在確切的自訂幾何尺寸很重要時產生開關
如果原生核取方塊的外觀符合介面需求,標準核取方塊可能就足夠了。當設計要求特定的軌道、旋鈕、色彩處理、內距或轉場效果,同時又必須保留原生表單語意時,自訂開關會更有用。當審查者需要直接查看最終的像素值,而不是將其隱藏在元件相依性後方時,這種做法也很有用。
CSS Toggle Switch Generator 正好支援這項需求:它會在原生核取方塊周圍建立外觀,並計算旋鈕直徑與選取時的移動距離。它不會以裝飾性元素取代核取方塊,因此控制項仍保留選取狀態、使用 Space 鍵啟動、焦點及表單提交行為。
所有作業都在瀏覽器本機執行。產生器的設定與程式碼不會上傳、持久化或傳送至元件產生服務。其同步輸出結合 CSS 與 HTML,並讓 input 持續巢狀於可見的 label 文字中,使控制項具有無障礙名稱,且整個有標籤的區域都可點選。
產生的 CSS 使用 appearance: none 移除瀏覽器預設的核取方塊繪製效果,而非移除原生行為。MDN 的 CSS appearance 文件說明了此屬性,而 W3C CSS Basic User Interface Level 4則涵蓋外觀切換。未包含 JavaScript,因為基本核取方塊狀態不需要 JavaScript。
逐步建立開關
- 確認互動方式並選擇標籤。 確認工作具有兩種狀態,且開關比核取方塊、按鈕或多選項控制項更清楚。請選擇「電子郵件通知」等簡潔的設定名稱,不要使用範例中的「啟用功能」標籤。
- 開啟 CSS Toggle Switch Generator並輸入設計值。 設定軌道寬度、軌道高度、內距、轉場持續時間,以及分別設定關閉、開啟與旋鈕的顏色。產生器會透過驗證邏輯拒絕無效的尺寸、顏色值與組合。
- 切換預覽。 按一下軌道或標籤,以比較未選取與選取位置。確認旋鈕保持在軌道內、兩個位置在視覺上明顯不同,且選取的顏色能傳達預定狀態。
- 複製 CSS 與 HTML。 「複製 CSS」與「複製 HTML」動作會分別要求剪貼簿權限。如果權限遭拒,仍可從可見的輸出內容中手動選取。
- 將範例標籤替換為實際設定。 保留原生 type="checkbox" input 及其與可見標籤的關聯。不要以經過樣式設定的 div 取代它,否則會移除原生選取狀態、鍵盤啟動、焦點行為與提交語意。
- 整合輸出並在目標頁面中測試。 將 CSS 放入頁面樣式表,並將 HTML 放入適當的表單中。接著驗證可見狀態、鍵盤操作、焦點處理,以及設定與應用程式邏輯連接後的行為。
檢查幾何尺寸與輸入限制
旋鈕直徑的計算方式為軌道高度減去內距的兩倍。未選取時,旋鈕從選定的內距位置開始;選取時,旋鈕會移動軌道寬度減去軌道高度的距離。這能讓兩端維持相同的內距,而不會讓旋鈕緊貼其中一側邊緣。
以一個實際計算為例,28 像素高的軌道搭配 4 像素內距,會產生 28 - (2 × 4) = 20 像素的旋鈕尺寸。
| 輸入 | 可接受的值 | 限制 |
|---|---|---|
| 軌道寬度 | 36-120 整數像素 | 必須至少比軌道高度大 8 像素,兩個位置才會在視覺上明顯不同。 |
| 軌道高度 | 20-64 整數像素 | 同時參與旋鈕尺寸與移動距離的計算。 |
| 內距 | 2-8 整數像素 | 必須讓軌道內保留正向尺寸的旋鈕。 |
| 轉場持續時間 | 0-2,000 整數毫秒 | 零會移除可見的插值效果,但不會改變選取狀態。 |
| 關閉、開啟與旋鈕的顏色 | 完整的六位數 HEX 值 | 每種顏色都必須使用指定的 HEX 格式。 |
無效組合會由純邏輯予以拒絕,而不會產生負數旋鈕尺寸或將旋鈕放在軌道外。由於輸出會直接顯示像素值,您可以檢查幾何尺寸,而不必依賴隱藏的相依性。
軌道會取得等同於其高度一半的藥丸形邊框圓角,圓形旋鈕則使用其自身尺寸的一半作為半徑。背景與旋鈕的 transform 共用選定的持續時間及 ease 計時關鍵字。將持續時間設為零會移除可見的插值效果,但不會改變狀態。複製的基準程式碼不包含減少動態效果媒體查詢,因此如果動態效果僅為裝飾用途,或使用者要求減少動態效果,請在目標樣式表中將轉場持續時間覆寫為零。
在實際設定中測試整合後的控制項
鍵盤使用者應能使用 Tab 鍵將焦點移至開關,並按 Space 鍵。將其整合至 React、Vue 或其他框架後,請再次執行這項測試,因為不相符的 checked 與 change 處理常式可能會讓受控元件中的原生互動失效。如果框架要求使用 className 而非 class,請進行調整,但不要改變 input 與 label 之間的語意關聯。
focus-visible 外框會保留在原生 input 上,與軌道保持偏移,並使用選定的開啟顏色。它不會被移除。請針對實際頁面背景檢查此外框,因為在產生器預覽中明顯的顏色,在其他主題中可能會消失。
也請在 various 縮放層級、強制色彩模式、高對比模式及螢幕閱讀器中進行測試。確認開啟與關閉狀態不只靠顏色區分,尤其是在相鄰文字未顯示目前狀態時。請檢查觸控目標大小,並在切換後果很重要的情況下加入明確的狀態文字。
產生器不會加入獨立的 hover、active、disabled、invalid、loading 或唯讀呈現方式。正式的設定畫面應讓停用的控制項易於理解,並將錯誤或說明文字與相關欄位建立關聯,而不是僅依賴開關的顏色。
將應用程式行為與 CSS 分開
產生的程式碼不會儲存設定。您的應用程式必須決定何時持久化核取方塊的值、回報待處理工作、處理更新失敗,以及在選取狀態與已儲存的伺服器狀態不同時進行復原。如果狀態變更會執行網路操作,請提供清楚的反饋,讓視覺開關不會在變更持久化前就暗示變更已成功。
此工具不會產生應用程式設定邏輯、非原生小工具的 ARIA 狀態同步、分析功能、持久化、API 呼叫或樂觀復原。其零 JavaScript 輸出適合基本核取方塊狀態,但不適合作為應用程式狀態控制器。
- 決定目前的開啟或關閉值儲存在何處,以及何時應提交或持久化。
- 如果框架會控制 input 值,請正確連接原生 checked 與 change 行為。
- 在開關的 CSS 之外顯示待處理、成功與失敗狀態。
- 重新載入、請求遭中斷及更新失敗後,請再次測試持久化功能。
採用簡單的進行/不進行規則
當互動方式是二元設定、自訂視覺外觀確有必要,且可接受使用原生且有標籤的核取方塊時,請產生開關。在推出之前,請確認團隊能在實際頁面中測試無障礙功能,並由團隊負責儲存或套用選取值的邏輯。
- 對於通知功能啟用或停用等兩種相反狀態,請使用開關。
- 對於一次性動作,請使用按鈕;對於多個選項,請使用 radio button 或 select。
- 在檢查鍵盤、焦點、對比、縮放、強制色彩與減少動態效果的行為之前,請勿推出自訂外觀。
如果您正在權衡各種選項,產生 CSS 三角形時,我應該預期什麼結果?有詳細說明。
如果您正在權衡各種選項,避免 CSS 色彩漸層產生器的常見錯誤有詳細說明。