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

what should i compare before i generate css toggle switch
產生 CSS 切換開關前應比較哪些項目

軌道寬度、軌道高度與八像素規則

決定開關形狀的因素中,有兩個測量值比其他項目更重要:軌道寬度與軌道高度。產生器可接受的寬度為 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 切換開關

  1. 開啟CSS Toggle Switch Generator,先設定軌道寬度和軌道高度,並確認寬度至少比高度多八個像素。
  2. 選擇能讓旋鈕明顯區分的內部邊距,以及能帶來快速回應感的轉場時間;如果產品稍後會覆寫動態效果,請使用 0 ms。
  3. 將關閉 color、開啟 color 和旋鈕 color 輸入為完整的 6 位數十六進位色碼,然後點擊預覽,在未勾選與已勾選狀態之間切換。
  4. 分別使用 Copy CSS 和 Copy HTML;每個操作都會獨立要求剪貼簿權限,如果拒絕存取,您仍可手動選取可見的程式碼。然後將範例標籤文字替換為實際二進位設定的簡潔說明,例如「Email notifications」或「Dark mode」。
  5. 驗證狀態用語、透過 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 三角形產生成錯誤檢查項目。