當您需要可重複使用、尺寸精確的原生核取方塊控制項,而且否則就得手動重複撰寫軌道、旋鈕、顏色與轉場 CSS 時,請產生 CSS 切換開關。

對於獨立設計、既有設計系統元件,或需要超出產生工具基本範圍之互動行為的開關,手動 CSS 仍是較好的選擇。實務上的問題不在於產生工具整體而言是否「較好」,而在於其可重複使用的幾何結構、同步的標記與受控的自訂選項,是否能省下比手動撰寫及維護相同細節更多的工作。

when should i generate css toggle switch instead of doing it manually
何時應產生 CSS 切換開關,而非手動撰寫 CSS

依工作量比較兩種做法

當多個頁面、主題或表單面板都需要相同的控制項,且要刻意調整其尺寸或顏色時,產生開關最有用。當旋鈕位置必須維持數學一致性時,它也很有幫助。手動 CSS 能讓您完全掌控不尋常的結構與狀態,但接下來每個變體的計算、測試與維護都必須由您負責。

情況 產生開關 手動撰寫 CSS
相同的二元控制項出現在多個位置 建立一個經審核的基準,再複製到每個實作中。 只有在每個位置都需要真正不同的結構或行為時才有用。
軌道、內距、旋鈕與移動距離必須保持對齊 產生工具會計算旋鈕與移動距離的幾何關係,並以像素宣告公開這些值。 您必須自行計算並檢查相同的關係。
CSS 與 HTML 必須以相同結構為基礎 工具會複製與標示原生核取方塊相互對應的 CSS 與 HTML。 您必須撰寫樣式表,並讓標記保持一致。
控制項需要懸停、作用中、停用、載入或唯讀樣式 將輸出作為起點,再擴充或取代這些狀態。 通常這是較直接的選項,因為產生工具並未提供這些呈現方式。
設定必須儲存至伺服器 視覺程式碼不會執行儲存。 手動 CSS 也不會執行儲存;兩種做法都需要應用程式碼。

這項比較也釐清了一項重要限制:產生功能取代的是重複的樣式設定工作,而非產品開發。複製的程式碼片段是視覺與原生輸入項的基礎,而不是完整的設定功能。

產生 CSS 的最有力理由

精確的幾何關係是最明顯的優勢。開關即使內部測量值有誤,看起來仍可能很平衡,因此手動撰寫的值應依定義明確的公式進行審核。產生工具會將旋鈕直徑計算為軌道高度減去兩倍內距,並將移動距離計算為軌道寬度減去軌道高度。接著,它會在輸出中直接公開這些測量值,而不是將其隱藏在元件相依性後方。

第二項優勢是更快速的視覺反覆調整。可在預覽於不同狀態間切換時,調整軌道寬度、軌道高度、內距、轉場時間、關閉顏色、開啟顏色與旋鈕顏色。當產品需要數種相關外觀時,這特別有用,因為每項變更都繫結至相同的原生勾選狀態結構,而不需要另建裝飾性的小工具。

需要組合的初始標記也更少。產生的 HTML 會以可見的標籤文字包覆 input type="checkbox"。這能為控制項提供無障礙名稱、讓帶有標籤的區域可點擊,並保留瀏覽器原生的勾選狀態、Space 鍵啟用、聚焦行為與表單提交功能。MDN 對 CSS appearance 屬性的文件會說明用來抑制預設核取方塊繪製,同時保留原生輸入項的樣式設定機制。

對於關心專案資料的團隊而言,其運作模式很直接:工具會在瀏覽器本機執行,設定與程式碼不會上傳、保存或傳送至元件產生服務。因此,適合用來實驗尺寸與顏色,而不必將未完成的介面程式碼放入外部產生流程。

適合手動撰寫 CSS 的情況

當控制項只出現一次,且沒有可重複使用的樣式標準時,手動實作較為合理。當所需尺寸超出產生工具可接受的範圍、旋鈕或軌道需要非標準結構,或既有元件已涵蓋該設計時,手動實作也較合適。

當您需要自訂的懸停、作用中、停用、無效、載入或唯讀呈現方式時,請選擇手動做法。產生工具不會建立這些獨立狀態,因此必須將它們加入目標樣式表,或從一開始就加以設計。若您刻意遠離原生核取方塊語意,手動建立的實作也能提供更多自由,但這項變更會增加無障礙方面的工作。

不要只是因為切換開關看起來現代,就使用切換開關。「立即刪除」等一次性動作,較適合以按鈕表示;而數個互斥選項間的選擇,則應使用 radio group、select 或其他多選項控制項。切換開關適合用於意義可表達為開啟或關閉的二元設定。

以受控流程建立開關

  1. 確認控制項代表一項二元設定。在設計前,先寫下開啟與關閉狀態的意義。使用「電子郵件通知」或「深色模式」等簡潔措辭,並避免使用「啟用功能」等語意含糊的範例標籤。如果互動只會執行一次,請改用按鈕。
  2. 開啟CSS Toggle Switch Generator並設定視覺參數。輸入軌道寬度、軌道高度、內距、轉場時間、關閉顏色、開啟顏色與旋鈕顏色。三種顏色皆使用完整的六位數 HEX 值,並讓尺寸維持在下表列出的可接受範圍內。
  3. 切換預覽以檢查兩種狀態。確認旋鈕的起點與終點都位於軌道內、移動看起來平衡,且選定的顏色在實際情境中仍能清楚區分。預覽也能讓您快速察覺不適當的時間長度,再複製程式碼。
  4. 複製 CSS 與 HTML。兩個複製動作會各自獨立要求剪貼簿權限。如果權限遭拒,仍可使用可見程式碼進行手動選取。將範例標籤替換為實際的二元設定,並保留原生輸入項與其可見標籤之間的關係。
  5. 整合原生輸入項,而非以裝飾性元素取代它。產生的 CSS 會使用 appearance: none 移除瀏覽器的預設核取方塊繪製,但輸入項仍負責勾選狀態、Space 鍵啟用、聚焦與表單提交。未包含 JavaScript,因為基本的核取方塊狀態不需要它。在 React、Vue 或其他框架中,請使用適當的 class 屬性語法,例如 React 中的 className,並在連接狀態處理常式後再次測試控制項。
  6. 在採用該控制項的產品中進行驗證。檢查狀態措辭、鍵盤操作、聚焦對比、縮放、forced-colors 行為、reduced-motion 行為與持久化。測試 Tab 鍵導覽與 Space 鍵啟用,檢查聚焦外框與實際頁面背景的對比,並確認開啟與關閉不僅能靠顏色區分。當變更需要呼叫網路時,請在 CSS 之外處理等待中與失敗狀態,讓切換開關不會暗示設定已儲存,即使實際上並未儲存。

可接受的值與精確幾何關係

產生工具的限制刻意清楚呈現,讓設計在進入正式環境前就能接受檢查。尺寸必須為整數像素,顏色必須為嚴格的六位數 HEX 值,而不相容的測量值不會產生負數旋鈕或旋鈕位於軌道之外的輸出。

設定 可接受的值或關係 實務意義
軌道寬度 36 至 120 整數像素 定義旋鈕及其移動距離可使用的水平空間。
軌道高度 20 至 64 整數像素 定義軌道的垂直尺寸與旋鈕的最大直徑。
寬度與高度的關係 寬度必須至少比高度大 8 像素 讓勾選與未勾選的位置在視覺上明顯不同。
內距 2 至 8 整數像素 必須在軌道內保留正尺寸的旋鈕空間。
轉場時間 0 至 2,000 整數毫秒 控制共用的 background-color 與 knob-transform 插值效果。
關閉、開啟與旋鈕顏色 完整的六位數 HEX 值 確保顏色輸入明確且有效。
旋鈕直徑 軌道高度減去兩倍內距 決定圓形旋鈕的大小。
旋鈕移動距離 軌道寬度減去軌道高度 讓旋鈕在未勾選與勾選位置之間移動。

軌道使用等於其高度一半的藥丸形邊角半徑,圓形旋鈕則以其自身尺寸的一半作為半徑。在未勾選狀態下,旋鈕從選定的內距開始。在勾選狀態下,transform 會依計算出的移動距離移動旋鈕,並在兩端保留選定的內距。

背景顏色與旋鈕 transform 都會使用選定的時間長度,並採用 ease 時間函式關鍵字。時間長度為零時,會移除可見的插值效果,但不會改變控制項的狀態。產生的基準內容未包含 reduced-motion 媒體查詢,因此如果動態效果僅為裝飾用途,請在目標樣式表中為要求 reduced motion 的使用者加入 transition-duration: zero 的覆寫值。

將原生互動與應用程式行為分開

產生的元件會處理原生核取方塊的外觀,但正式介面仍需要 CSS 單獨無法完成的檢查。focus-visible 外框會保留在原生輸入項目上,並使用所選的開啟顏色。由於它與軌道之間有偏移,因此請確認相對於實際頁面背景仍然可見,而不要依賴產生器的預覽環境。

整合時請規劃下列檢查:

  • 確認使用者可以使用 Tab 鍵到達控制項,並使用 Space 鍵變更設定,同時驗證其在鍵盤順序中的位置合理。
  • 在完成的介面中測試對比度、縮放、觸控目標大小、螢幕閱讀器播報、forced-colors 模式及高對比行為。
  • 讓開啟與關閉狀態在不完全依賴顏色的情況下仍能清楚理解。當設定的後果很重要時,請加入明確的狀態文字。
  • 檢查停用狀態的意義,並確保錯誤或說明文字仍與相關表單欄位保持關聯。
  • 一起驗證由框架控制的選取狀態與變更處理;受控狀態的連接方式不相符可能會破壞原生互動。
  • 將網路請求、等待中指示、失敗訊息、持久化及復原功能與產生的 CSS 分開。此工具並未提供應用程式設定邏輯、API 呼叫、樂觀復原,或非原生小工具的 ARIA 狀態同步。

在向使用者提供明確回饋之前,視覺狀態不應暗示伺服器端已經變更。產生的開關可以呈現目前的選擇,但產品必須確認該選擇已被接受並儲存。除非周圍的產品能以易於理解的方式呈現這些狀態,否則也不應讓它看起來像是停用、載入中、無效或唯讀。

依正式需求做出最終選擇

當您想從已經審查的幾何尺寸、同步的 CSS 與 HTML、帶標籤的原生核取方塊,以及可調整的預覽開始,而不必從頭建立所有這些層級時,請產生開關。複製結果、調整實際標籤,並整合至應用程式現有的狀態與錯誤處理系統。

當控制項確實是一次性的、超出核准尺寸、屬於既有元件庫,或需要產生的基準未包含的互動狀態時,請維持手動實作。不論採取哪種途徑,只有在產品中測試過開關的行為,也就是使用者會遇到它的產品中測試過,才算完成。

相關閱讀:產生 CSS 三角形之前,我應該先比較什麼?。

相關閱讀:HTML 顏色名稱圖表:選擇 CSS 格式。