在產生 CSS 切換開關之前,請將軌道寬度、軌道高度、內部邊距、轉場時間、關閉 color、開啟 color 和旋鈕 color 與您真正需要控制的二進位設定相比較。CSS 切換開關產生器會在原生 HTML 核取方塊外建立 stylish 的開啟/關閉外觀,因此每個可見像素都取決於這些數值與十六進位色碼之間的關係。事先比較這些項目可讓幾何尺寸保持一致:旋鈕直徑等於軌道高度減去兩倍的內部邊距,而勾選時的移動距離等於軌道寬度減去軌道高度;這也是寬度必須至少比高度多八個像素的原因。將色彩對比與您實際的頁面背景相比較也很重要,因為在預覽中看似顯眼的開啟 color,放到較深色的主題中可能會消失。您也應比較每一層的功能,以及產品必須處理的項目:空白鍵啟用來自原生輸入元素;產生的 CSS 會在輸入元素上保留 focus-visible 外框;減少動態效果可以透過將時間設為零,或在目標樣式表中覆寫 transition-duration 來處理;整合後也必須檢查框架連接。

軌道寬度、軌道高度與八像素規則
決定開關形狀的因素中,有兩個測量值比其他項目更重要:軌道寬度與軌道高度。產生器可接受的寬度為 36 到 120 個整數像素,高度則為 20 到 64 個整數像素。較寬的軌道可讓旋鈕有移動空間;較高的軌道能讓開關具有較扎實的感覺,同時不會使可點擊範圍過度膨脹。由於勾選時的移動距離是依寬度減去高度計算,這兩個值會共同決定旋鈕滑動的距離。
兩者之間的最小差距固定為八個像素。這項規則是為了讓開啟與關閉位置在視覺上維持明顯差異。如果寬度和高度太接近,切換時旋鈕幾乎不會移動,使用者只會看到一個近乎靜止的藥丸形狀。在確定設計之前,先比較預定的寬度與高度,可避免這種移動距離過短的問題。
以下是一個實際組合的計算範例:
- 軌道寬度 = 56 px,軌道高度 = 28 px,內部邊距 = 4 px
- 旋鈕直徑 = 高度 − 2 × 邊距 = 28 − 8 = 20 px
- 移動距離 = 寬度 − 高度 = 56 − 28 = 28 px
- 驗證:邊距 + 旋鈕 + 移動距離 + 邊距 = 4 + 20 + 28 + 4 = 56 px,正好等於軌道寬度
如果您的設計改為要求寬度 60、高度 32、邊距 4,這些方程式會得出直徑 24 像素的旋鈕和 28 像素的移動距離,而且同樣的邊距會緊貼在軌道左右兩端的內側。在不同主題中維持這項等式不變,正是讓開關無論選擇哪一種開啟 color 都能維持視覺平衡的關於。這些數值之間如何關聯的更深入說明,請參閱配套指南中的旋鈕移動距離計算。
內部邊距與轉場時間
內部邊距是軌道邊緣與旋鈕之間的間距。產生器可接受 2 到 8 個像素,並要求計算結果能在軌道內留下正值的旋鈕空間。將邊距設為 2,會產生幾乎在垂直方向填滿軌道的旋鈕;設為 8,則會產生緊貼邊緣的細長條。大多數設定畫面採用 3 到 5 的範圍,因為這能讓旋鈕在視覺上與啟用的填色明顯區分,同時又不會讓開關顯得空洞。
轉場時間控制旋鈕與背景 color 在關閉和開啟狀態之間進行插值的速度。產生器可接受 0 到 2000 個整數毫秒。較短的時間,例如 120 到 200 ms,會帶來快速回應的感覺;超過 500 ms 的較長時間,對二進位控制而言開始顯得遲緩。將時間設為零可完全移除插值,而不會影響底層的狀態變更;當動態效果僅屬裝飾用途,且您打算維持這種設定時,這項功能會很有用。
複製出的基準程式碼不包含 prefers-reduced-motion 媒體查詢。如果您的產品應尊重這項使用者偏好,請規劃在目標樣式表中將 transition-duration 覆寫為零。用來隱藏原生核取方塊繪製內容之底層 appearance 屬性的 CSS 規格,可參閱 MDN 的 appearance 參考資料。
需要評估的關閉、開啟與旋鈕 color
有三種彼此獨立的 color 會驅動視覺狀態:關閉 color(未勾選時的軌道背景)、開啟 color(勾選時的同一背景),以及旋鈕 color(會移動的圓形指標)。三者都必須輸入完整的 6 位數十六進位色碼。在產生之前沿三個獨立軸比較這些色彩,可避免您稍後還得重新繪製。
先從開啟 color 開始,因為它也會驅動 focus-visible 外框。外框偏移可讓指標在軌道邊緣保持可見,因此開啟 color 必須與您實際的頁面背景具有足夠的對比。請在開關實際所在的頁面表面,透過Color Contrast Checker 檢查這個組合。WCAG 2.2 並未針對焦點外框規定單一比例,但外框與相鄰表面之間採用 3:1 的比例,是合理的基準值。
比較開啟與關閉狀態,確保狀態變更不只靠 color 就能辨識。當開啟 color 和關閉 color 都是明度相近的灰色時,唯一線索就會變成旋鈕的位置;這對難以追蹤動態效果的使用者而言並不合格。在軌道和旋鈕上重複使用單一 color 也是一種失效情況:旋鈕會消失在軌道中。使用獨立且較亮或較暗的旋鈕 color,可讓指標清楚易讀。
如何透過正確比較產生 CSS 切換開關
- 開啟CSS Toggle Switch Generator,先設定軌道寬度和軌道高度,並確認寬度至少比高度多八個像素。
- 選擇能讓旋鈕明顯區分的內部邊距,以及能帶來快速回應感的轉場時間;如果產品稍後會覆寫動態效果,請使用 0 ms。
- 將關閉 color、開啟 color 和旋鈕 color 輸入為完整的 6 位數十六進位色碼,然後點擊預覽,在未勾選與已勾選狀態之間切換。
- 分別使用 Copy CSS 和 Copy HTML;每個操作都會獨立要求剪貼簿權限,如果拒絕存取,您仍可手動選取可見的程式碼。然後將範例標籤文字替換為實際二進位設定的簡潔說明,例如「Email notifications」或「Dark mode」。
- 驗證狀態用語、透過 Tab 和 Space 鍵盤操作、與實際背景的焦點對比、200 percent 縮放行為、forced-colors 模式、減少動態效果,以及產品實際使用的持續儲存層。
無障礙與整合檢查
自訂開關除了有效的 CSS 之外,還需要無障礙與可用性檢查。發行前請比較下列項目,因為產生器不會自動為您產生這些內容:
- 狀態用語。確認開啟與關閉狀態不只靠 color 就能區分,尤其是相鄰的標籤文字未清楚說明後果時。如果設定會變更資料、帳單或可見性,請加入「On」或「Off」等明確的狀態文字。
- 鍵盤順序與啟用。Tab 應將焦點移至原生輸入元素,Space 應切換狀態,而 focus-visible 外框應保留在輸入元素上,不得被 appearance 樣式移除。另請驗證觸控目標大小與螢幕閱讀器的播報內容。
- 對比、縮放與強制色彩。請在 200 percent 縮放,以及 Windows High Contrast 或 forced-colors 模式中測試對比;使用者代理可能會完全覆寫您的背景 color。
- 等待中與失敗狀態。產生器不包含 hover、active、disabled、invalid 或 read-only 的顯示方式。如果設定會觸發網路操作,請在產品程式碼中建立等待中與錯誤指標,不要讓視覺開關暗示某項變更已生效,實際上卻未持續儲存。
框架接線與持續保存
產生的程式碼片段不包含 JavaScript,因為基本核取方塊狀態不需要它。這個選擇會帶來一個後果:當你將標記貼入 React、Vue 或其他框架時,如果 checked 與 onChange 處理常式不相符,受控狀態的接線可能會使原生互動失效。整合後,按 Tab 鍵將焦點移至開關,再按一次空白鍵,以確認視覺效果與模型值都已更新。框架使用者可以將 class 重新命名為 className,但輸入項目與可見標籤之間的語意關係應維持不變。
此片段也不會儲存設定。工具只提供外觀與原生互動;持續保存、樂觀復原與失敗復原皆屬於使用此控制項的應用程式。如果你將儲存功能接到變更事件,請為伺服器與使用者的樂觀狀態不一致時,規劃載入指示器與復原路徑。此接線階段的常見錯誤,是讓視覺開關在網路請求仍在進行時翻回先前的顏色,這可能使使用者再次點擊並造成重複更新。能移除原生核取方塊繪製效果而不破壞其語意的外觀規格,說明於 CSS Basic User Interface Level 4 appearance 區段。
事先比較這些輸入項目與行為,正是讓開關除了單獨看起來正確之外,也能順利交付的關鍵。下方的幾何規格表彙整了可接受的範圍,方便你快速檢視。
| 輸入項目 | 可接受的類型 | 範圍或規則 |
|---|---|---|
| 軌道寬度 | 整數像素 | 36 至 120 |
| 軌道高度 | 整數像素 | 20 至 64 |
| 寬度與高度 | 關係 | 寬度必須至少為高度 + 8 |
| 內部邊距 | 整數像素 | 2 至 8,必須留下正值的旋鈕 |
| 轉場持續時間 | 整數毫秒 | 0 至 2000 |
| 關閉、開啟與旋鈕顏色 | 十六進位字串 | 必須提供完整的六位數十六進位值 |
對於開關是否確實是適當的控制項,也有一個快速的判斷界線。下表將開關與鄰近的表單控制項進行比較,讓你在產生任何內容前選擇正確的形狀。
| 控制項 | 適用情況 | 不適用情況 |
|---|---|---|
| 切換開關 | 二元開啟或關閉設定 | 預期執行一次性動作,或存在兩個以上的選項 |
| 單一核取方塊 | 確認、選擇加入或同意,且為較大型表單的一部分 | 變更值會觸發使用者尚未理解的副作用 |
| 按鈕 | 儲存、傳送或刪除等一次性動作 | 點擊後,系統狀態應持續顯示 |
| 單選按鈕群組或選取控制項 | 三個或以上互斥的選項 | 只有兩個值,而且第二個值意味著第一個值 |
執行這些比較、產生標記,並在你自己的產品中驗證行為。產生器會提供 CSS 與 HTML;整合後,負責交付該畫面的團隊必須驗證原生鍵盤操作與焦點對比,而應用程式必須處理持續保存與失敗復原。
若想深入瞭解,請參閱常見的 CSS 三角形產生成錯誤檢查項目。