CSS 切換開關是以核取方塊實作的,因為原生 input 本身已提供二元狀態與互動語意;若改用純視覺開關,就必須自行重新建立這些功能。

重要的區別在於元素的語意與外觀。CSS Toggle Switch Generator 會將原生 input type="checkbox" 保留在可見的 label 內,再使用 appearance: none 移除瀏覽器預設的核取方塊繪製。Custom CSS 負責建立軌道、旋鈕、顏色與移動效果,但不會取代底層的表單控制項。

因此,這個控制項可以看起來像開/關切換開關,同時保有 checked 狀態、Space 鍵啟動、焦點處理與表單提交行為。其可見的 label 也提供了無障礙名稱,並讓整個標示區域都可點擊。因此,產生的結果是具有樣式的原生核取方塊,而不是假裝成表單控制項的裝飾元素。

這種做法符合 MDN 的 appearance 文件以及 W3C CSS Basic User Interface Level 4 的 appearance-switching 定義所述的區別:控制項的原生繪製方式可以自訂,而不必放棄與該元素相關聯的平台行為。

why is the control implemented as a checkbox when i generate css toggle switch
為什麼 CSS 切換開關是以核取方塊建構的?

在開關樣式之下仍然保持原生的部分

CSS 控制核取方塊的繪製方式,但不會取代 input 的操作模型。checked 屬性會驅動 CSS 規則,以選擇開啟或關閉的外觀,而焦點與鍵盤啟動仍由瀏覽器處理。應用程式則負責解讀提交的值,並將其帶入產品狀態。

層提供的功能自訂會改變的部分
原生核取方塊Checked 狀態、Space 鍵啟動、焦點與表單提交視覺繪製,而非底層狀態模型
可見的 label無障礙名稱與可點擊的標示區域由 label 指定的設定
CSS軌道、旋鈕、顏色、轉場與 focus-visible 外框外觀與移動方式
應用程式持久化、網路更新、錯誤與框架狀態這些行為不會產生

純裝飾用的 div 不會繼承核取方塊的原生狀態與鍵盤行為。若改變其外觀,應用程式就必須負責重新建立這些保障,並正確公開狀態。保留原生 input 可避免為基本二元互動增加額外的同步層。

仍然有效的輸入值與幾何尺寸

產生器會將旋鈕直徑計算為軌道高度減去兩倍的內側 padding。在未選取的位置,旋鈕會從所選的 padding 開始。在選取的位置,transform 會將它移動軌道寬度減去軌道高度所得到的距離。加上旋鈕尺寸後,這段移動距離可讓軌道兩端維持相同的 padding。

軌道使用等於自身高度一半的藥丸形邊角半徑,而旋鈕則使用自身尺寸的一半形成圓形。背景顏色與 transform 共用所選的轉場時間及 ease 計時關鍵字。將時間設為零會移除可見的插值,但不會改變任一狀態。

控制項接受的值其他規則
軌道寬度36 到 120 之間的整數像素必須至少比高度大 8 像素
軌道高度20 到 64 之間的整數像素必須符合寬度對高度的規則
內側 padding2 到 8 之間的整數像素必須讓軌道內能容納尺寸為正的旋鈕
轉場時間0 到 2000 之間的整數毫秒零會停用可見的插值
顏色完整的六位數 HEX 值關閉、開啟與旋鈕顏色必須分別指定

無效的組合會由產生器的尺寸邏輯拒絕,而不是產生負數旋鈕尺寸或將旋鈕放在軌道外。這些是此工具透明呈現的本機限制,而非適用於每種切換開關設計的通用規則。

產生、標示並整合控制項

使用下列工作流程,從視覺預覽進行整合設定:

  1. 設定視覺值。輸入軌道寬度、軌道高度、內側 padding、轉場時間,以及關閉狀態、開啟狀態與旋鈕的完整六位數 HEX 顏色。寬度必須至少比高度大 8 像素。
  2. 測試兩種預覽狀態。點擊軌道或 label 來切換預覽。確認旋鈕保持在軌道內、開啟與關閉顏色可清楚區分,且轉場效果適合該設定。
  3. 複製 CSS 與 HTML。Copy CSS 與 Copy HTML 控制項各自獨立要求剪貼簿存取權限。成功狀態訊息會指出已複製的輸出;如果剪貼簿存取遭拒,仍可手動選取可見的程式碼。
  4. 替換範例 label。將 Enable feature 替換為實際的二元設定,例如 Email notifications 或 Dark mode。將 input 巢狀於可見的 label 文字中,讓控制項保有無障礙名稱與可點擊的標示區域。
  5. 整合兩部分。將複製的 CSS 加入頁面,並將產生的 HTML 放在相關的表單或設定介面中。由於產生的程式碼片段不含應用程式邏輯,因此核取方塊的基本狀態不需要 JavaScript。
  6. 驗證最終介面。將程式碼放入實際頁面後,檢查狀態文字、鍵盤操作、焦點對比、縮放、強制色彩、減少動態效果與持久化行為。

框架整合需要額外檢查。React、Vue 與類似系統可以將 class 換成 className,但 input 與 label 之間的語意關係應維持不變。受控狀態的接線在 checked 與 change 事件處理器不相符時,也可能破壞原生互動,因此整合到應用程式後,請再次測試 Tab 與 Space 鍵。

將外觀與已儲存的應用程式狀態分開

產生的程式碼只處理切換開關的外觀與原生互動。它不會產生應用程式設定邏輯、分析、持久化、API 呼叫、樂觀復原,或非原生小工具的 ARIA 狀態同步。雖然 CSS 讓控制項看起來像切換開關,但輸出仍保留原生核取方塊的語意。

產生器中的所有內容都會在本機瀏覽器中執行。設定與產生的程式碼不會上傳、持久化或傳送至元件產生服務。然而,本機執行並不會使輸出變成儲存系統:如果某項設定必須在重新載入頁面後保留,或必須傳送至伺服器,目的地應用程式就必須實作該行為。

對於以網路支援的設定,待處理工作與失敗復原應置於 CSS 之外。當更新失敗或仍在處理中時,視覺切換開關不應讓人誤以為變更已儲存。產生器也不會加入個別的 hover、active、disabled、invalid、loading 或 read-only 呈現方式。正式產品的設定畫面應讓停用的控制項容易理解,將錯誤或說明文字與正確的欄位建立關聯,並在使用者收到明確回饋前避免變更伺服器狀態。這項界線摘要於 Does the Generated CSS Toggle Switch Code Save a Setting?。

在最終頁面測試行為與無障礙功能

有效的預覽只是起點。請依最終主題、內容與框架,透過相符的檢查來測試產生的控制項:

  • 鍵盤:使用 Tab 鍵移至切換開關,然後按下 Space 鍵。點擊軌道或可見的 label 也應變更原生核取方塊狀態。
  • 焦點:確認 focus-visible 外框在實際頁面背景上仍然清晰可見,而不只是在產生器預覽中可見。
  • 狀態:確保開啟與關閉不只靠顏色就能區分。旋鈕位置也有所幫助,但當後果很重要時,可能需要明確的狀態文字。
  • 顯示條件:測試縮放、forced-colors 模式、高對比設定與減少動態效果偏好。
  • 更廣泛的使用:檢查螢幕閱讀器播報、觸控目標可用性、停用行為與非同步失敗。

產生的 focus-visible 外框會留在原生 input 上,與軌道保持偏移,並使用所選的開啟顏色。此顏色在某個預覽中可能很明顯,但在另一個主題中卻可能消失,因此必須在實際情境中評估對比。Keyboard Controls a CSS Toggle Switch Generator Supports 檢查清單提供了一种聚焦的方式,可在部署前檢視原生互動。

複製的基準程式碼不包含減少動態效果的媒體查詢。若要提供無動態行為,請將產生器的時間設為零,或在使用者的減少動態效果偏好應停用插值時,在目的地樣式表中將 transition-duration 覆寫為零。

選擇符合設定的控制項

切換開關適合用於可表示為關閉或開啟的二元表單狀態。它無法取代一次性動作按鈕或多選項選擇控制項。如果實際任務是這些內容,選擇其他控制項才能更準確地表達可用動作。

對於真正的二元設定,請使用簡潔的實世界名稱為控制項命名,並讓人無須只依賴顏色就能理解其目前狀態或後果。之後,原生核取方塊便可處理即時的視覺狀態,而周圍的產品程式碼則決定該狀態要儲存、同步、復原或確認。這種分工可讓產生的元件保持可重複使用,而不會假裝單靠 CSS 就能管理應用程式資料。