只有在目的、幾何尺寸、無障礙設計與整合行為皆已明確定義後,才應產生 CSS 切換開關,並將旋鈕大小設為軌道高度減去兩倍的內距。這項預先檢查的決策很重要,因為開關代表的是二元設定,而非一次性操作或選項選單。CSS 切換開關產生器可解決這項任務的呈現層面:它將原生 HTML 核取方塊包裝成自訂的開/關外觀,計算旋鈕直徑與勾選時的移動距離,並回傳同步的 CSS 與 HTML。外觀樣式會移除預設的核取方塊繪製效果,但不會移除原生勾選狀態、Space 鍵啟用、焦點或表單提交功能。在使用輸出結果前,請先決定控制項會變更哪項設定、撰寫簡潔的可見標籤、選擇在實際頁面上仍能清楚辨識的顏色,並決定動態效果、儲存狀態及更新失敗時應如何運作。產生器並非應用程式設定邏輯:它不會儲存數值、產生 API 呼叫、為非原生控制項同步 ARIA,亦不提供樂觀復原。將這些視為各自的產品責任,可避免外觀精緻的預覽畫面承諾複製後的程式碼無法提供的行為。所有作業皆在瀏覽器本機執行,此工具不會上傳、儲存或將設定與程式碼傳送至元件產生服務。

確認設定確實為二元狀態
當控制項代表某項持續性設定的目前狀態,例如電子郵件通知或深色模式時,開/關切換開關便很適用。它不適合取代用於儲存、刪除、開啟或提交內容的按鈕,因為這些控制項執行的是命令,而非顯示持續狀態。當使用者要從數個選項中進行選擇時,也不應以它取代單選按鈕、核取方塊或選取選單。這份選擇切換開關的決策指南可在開始套用樣式前, 提供更全面的方式來評估互動方式。
產生的標記刻意保留 input type checkbox,因為開關代表的是二元表單狀態。原生核取方塊已提供勾選狀態、Space 鍵啟用、焦點與表單提交語意,而裝飾性元素並不具備這些功能。input 會巢狀於可見的 label 文字中,因此整個標記區域皆可點選,控制項也能取得無障礙名稱。請將範例中的「Enable feature」標籤替換為簡潔的實際設定,例如「Email notifications」或「Dark mode」。關於基礎瀏覽器行為,MDN 的 appearance 參考資料與W3C CSS Basic User Interface 的 appearance-switching 規格提供了有用的技術背景。
設定尺寸、間距、顏色與時間
請將開關 input 視為單一的幾何尺寸系統。每個欄位都有明確的界限,無法產生有效軌道與旋鈕的組合會由邏輯排除,而不會產生負數尺寸或位於軌道外的旋鈕。
| 產生器輸入項目 | 接受的格式 | 限制或規則 |
|---|---|---|
| 軌道寬度 | 整數像素 | 36–120 px;至少比軌道高度大 8 px |
| 軌道高度 | 整數像素 | 20–64 px |
| 內距 | 整數像素 | 2–8 px;必須讓旋鈕在軌道內保留正數空間 |
| 轉場持續時間 | 整數毫秒 | 0–2,000 ms |
| 關閉、開啟與旋鈕顏色 | 完整的六位數 HEX | 三種顏色都必須使用完整 HEX 格式 |
以上是產生器本身的本機輸入限制與幾何規則,而非通用的開關設計要求。產生器會將旋鈕大小計算為軌道高度減去兩倍的內距。勾選時的移動距離等於軌道寬度減去軌道高度。在未勾選狀態下,旋鈕會從所選的內距位置開始;在勾選狀態下,translateX 轉換會將它移動所計算的距離。這些方程式可讓兩端保留相同的內距。軌道採用藥丸形邊角半徑,其值等於軌道高度的一半;圓形旋鈕則以自身大小的一半作為半徑。背景顏色與轉換會共用所選的持續時間及 ease 時間函式。
如需一個完整的幾何尺寸範例,請使用寬度 72 px、高度 40 px 及內距 4 px。旋鈕大小為 40 − (4 × 2) = 32 px,勾選時的移動距離則為 72 − 40 = 32 px。旋鈕在未勾選時從 4 px 開始,勾選後移動至 36 px,使右邊緣位於 68 px,並在軌道結束前保留 4 px 的空間。
產生、複製並調整輸出結果
- 開啟產生器並設定開關。設定軌道寬度、軌道高度、內距、轉場持續時間、關閉顏色、開啟顏色與旋鈕顏色。使用預覽比較兩種狀態。你可以點選軌道或標籤切換預覽,所有處理作業皆在瀏覽器本機完成。
- 檢查計算出的幾何尺寸。確認預覽中的開啟與關閉位置有明顯差異,且軌道與旋鈕皆位於所選界限內。複製的 CSS 會直接以像素宣告呈現尺寸,因此不必反向解析元件相依性,就能檢查軌道寬度、軌道高度、內距、旋鈕大小與移動距離。
- 複製 CSS 與 HTML。Copy CSS 與 Copy HTML 動作會各自獨立要求剪貼簿權限。成功時的狀態訊息會指出已複製的輸出內容。如果剪貼簿存取遭拒,仍可透過可見的程式碼手動選取內容。
- 替換範例標籤。將「Enable feature」變更為控制項實際代表的二元設定,例如「Email notifications」或「Dark mode」。請讓文字保持簡潔,以便快速辨識開關,同時提供無障礙名稱。
- 整合程式碼片段,但不要改變其語意。將複製的 CSS 加入目標樣式表,並將產生的 HTML 與控制項一起放置。讓 input 持續巢狀於可見的 label 中。在 React、Vue 或其他框架中,必要時請將 class 轉換為 className,但應保留原生 input 與 label 的關聯。由於基本核取方塊狀態不需要 JavaScript,因此不會包含 JavaScript。
- 將控制項連接至應用程式行為。如果設定必須儲存,請在產品中加入相關的狀態與持久化邏輯。如果變更設定會觸發網路操作,請在產生的 CSS 之外加入待處理、成功、失敗與復原處理。
驗證鍵盤、焦點、狀態與動態效果
請在產品中測試控制項,而非只依賴產生器預覽。指標使用者應能點選軌道或可見標籤切換開關。鍵盤使用者應能以 Tab 鍵將焦點移至 input,並按下 Space 鍵。與框架整合後,請再次執行測試,因為當勾選與變更處理函式不相配時,受控狀態的連接可能會破壞原生互動。
focus-visible 外框會保留在原生 input 上,並使用所選的開啟顏色。它會與軌道保持偏移而非被移除,但其可見性仍取決於目標頁面。請以外框對照實際背景與主題進行檢查,因為在預覽中醒目的顏色,到了其他地方可能會消失。另請確認開啟與關閉狀態不僅能透過顏色區分,尤其是在鄰近文字無法清楚顯示目前狀態時。當該狀態的後果很重要時,請加入明確的狀態文字。
請測試縮放、觸控目標大小、螢幕閱讀器公告、forced-colors 模式、高對比顯示、停用行為與任何非同步失敗。產生器不會加入特殊的懸停、啟用、停用、無效、載入中或唯讀樣式,因此必須在周邊產品中讓這些狀態清楚易懂。錯誤訊息與說明文字應持續與其相關欄位保持關聯。
動態效果需要另行進行無障礙決策。將持續時間設為零會移除可見的插值效果,但不會改變勾選狀態。如果動態效果僅為裝飾用途,或使用者要求減少動態效果,請在適當時於目標樣式表中將 transition-duration 覆寫為零。複製的基準樣式不包含媒體查詢,因此這份從產生的 CSS 切換開關移除轉場效果的指南會說明整合步驟。
將應用程式行為保持在 CSS 之外
產生的控制項提供外觀與原生互動,但不會管理完整的設定工作流程。實作時,請清楚劃分每一層的責任歸屬。
| 關注事項 | 產生器提供的功能 | 產品必須處理的內容 |
|---|---|---|
| 外觀 | 自訂軌道與旋鈕、計算的幾何尺寸,以及同步的 CSS 與 HTML | 配置、回應式版面配置,以及目標主題整合 |
| 原生互動 | 具備勾選狀態、Space 鍵啟用、焦點與提交功能的標記核取方塊 | 框架事件連接與受控狀態的一致性 |
| 動態效果 | 所選的轉場持續時間與 ease 時間函式 | 基準樣式不應播放動畫時,覆寫為減少動態效果 |
| 狀態與持久化 | 原生勾選狀態與可見標籤 | 狀態文字、儲存、載入與持久化 |
| 網路更新 | 沒有 API 呼叫或樂觀復原 | 待處理回饋、失敗處理、復原,以及清楚的確認訊息 |
| 特殊狀態 | 沒有專用的停用、無效、載入中、唯讀、懸停或啟用樣式 | 清楚的視覺狀態,以及相關的錯誤或說明文字 |
此工具不會產生應用程式設定邏輯、分析功能、持久化、API 呼叫,亦不會為非原生控制項同步 ARIA 狀態。如果控制項被替換為裝飾性元素,這些缺少的語意便會成為應用程式的責任。不要讓視覺上的開關承諾實際上未儲存的變更。正式環境中的設定畫面應避免在使用者收到清楚回饋前變更伺服器狀態,而非同步作業在結果確定前,也應持續以可見方式顯示為待處理狀態。
進行出貨前最終審查
出貨整合控制項之前,請確認完整行為,而不只是複製的宣告:
- 此開關代表真正的二元設定,其可見標籤清楚指出該設定。
- 所選尺寸與內距會產生大小適中的旋鈕,以及視覺上明顯不同的終止位置。
- Tab 鍵可將焦點移至輸入項目,Space 鍵可變更其狀態,而焦點外框在實際頁面上仍然可見。
- 開啟與關閉狀態,包括任何可見的狀態文字,即使不依賴顏色也能理解。
- 在縮放以及強制色彩或高對比度條件下,版面仍可使用。
- 目的地樣式表會遵循減少動態效果的偏好設定。
- 框架狀態處理器仍與原生核取狀態保持一致。
- 保存、待處理作業、失敗、停用的控制項及相關訊息,在產品中的行為均符合預期。