產生 CSS 切換開關後,請在發布前檢查其幾何結構、實際設定標籤、鍵盤操作、聚焦顯示、動態行為及持續保存處理。
即使樣式表有效,仍可能產生不清楚或故障的設定。請將產生的程式碼視為視覺與互動測試的起點,而非完整的應用程式設定系統。請一併檢查外觀、原生核取方塊語意、目的地頁面及儲存狀態流程。

先檢查意義與文字措辭
先從意義著手,而不是外觀。產生的控制項仍是 input type="checkbox",因為切換開關代表單一二元表單狀態。其可見標籤提供無障礙名稱,並讓標示的區域可點擊。請將範例中的「啟用功能」文字替換為簡潔的設定,例如「電子郵件通知」或「深色模式」。一次性操作仍需使用按鈕,而多項選擇則需要不同的控制項。
接著檢查開啟與關閉狀態是否不僅能透過軌道顏色區分,尤其是鄰近文字未顯示目前設定時。當該設定的後果很重要時,請加入明確的狀態文字。
| 檢查範圍 | 確認方式 | 後續處理 |
|---|---|---|
| 意義與標籤 | 標籤為一個實際的二元設定命名。 | 將範例標籤替換為簡潔且具體的文字。 |
| 狀態傳達 | 勾選與未勾選狀態不需單靠顏色即可理解。 | 在後果重要之處加入鄰近或明確的狀態文字。 |
| 幾何結構 | 旋鈕大小、移動距離及像素宣告符合預期尺寸。 | 修正產生器的輸入項目,而不是只修補單一 CSS 值。 |
| 鍵盤與聚焦 | Tab 可移至輸入項、Space 可變更勾選狀態,且聚焦輪廓保持可見。 | 在最終頁面或框架中再次測試這些行為。 |
| 使用者條件 | 切換開關在縮放、強制色彩及減少動態效果下仍可理解。 | 調整目的地樣式表,或使用更好的設定重新產生。 |
| 持續保存 | 視覺狀態與實際儲存的設定一致。 | 在應用程式中測試等待中、成功及失敗的處理方式。 |
檢查確切的軌道與旋鈕幾何結構
請檢查產生的宣告,而不是只憑肉眼判斷。旋鈕直徑等於軌道高度減去兩倍內側邊距,而勾選狀態的移動距離等於軌道寬度減去軌道高度。
- 軌道寬度可接受 36 至 120 的整數像素。
- 軌道高度可接受 20 至 64 的整數像素。
- 寬度必須至少比高度大 8 像素。
- 邊距可接受 2 至 8 像素,且必須讓軌道內保留正尺寸的旋鈕。
- 持續時間可接受 0 至 2,000 的整數毫秒。
- 關閉、開啟及旋鈕顏色各自都需要完整的六位數 HEX 值。
無效組合會被拒絕,而不會產生負數旋鈕尺寸或將旋鈕置於軌道外。舉一個完整範例,請使用 72px 軌道、36px 高度及 4px 邊距。旋鈕直徑 = 36 − (2 × 4) = 28px,移動距離 = 72 − 36 = 36px。所選的四像素內縮因此會保留在兩端。
另請驗證軌道使用相當於其高度一半的藥丸形圓角,而圓形旋鈕使用其自身尺寸一半作為半徑。產生的輸出會直接提供尺寸,因此請將這些宣告與您輸入的值比對。如果在複製程式碼後變更設計,請重新產生,而不是只變更移動值或軌道寬度。
測試原生互動與聚焦顯示
在預覽中點擊軌道或其標籤,然後使用 Tab 移至控制項,並使用 Space 變更其原生勾選狀態。外觀規則會移除瀏覽器預設的核取方塊繪製,但輸入項仍保留勾選狀態行為、Space 啟用、聚焦及表單提交。MDN 的 appearance 文件說明了用於這項平台外觀變更的樣式屬性。
請針對實際目的地頁面背景檢查 focus-visible 輪廓。產生器會在原生輸入項上保留偏移輪廓,並使用所選的開啟顏色作為輪廓顏色。在預覽中顯眼的顏色,面對其他主題、面板或圖片時可能會消失,因此不要將聚焦顯示視為已獲證明,必須先在實際情境中檢查。
與 React、Vue 或其他框架整合後,請再次進行鍵盤測試。當勾選與變更處理器的受控狀態接線不相符時,可能會干擾原生互動。如果該步驟不清楚,請先檢閱CSS 切換開關產生器支援的鍵盤控制項,再測試整合後的元件。
檢查各種使用者設定與顯示條件下的行為
預覽只是第一個環境。請使用整合後的控制項檢查下列條件:
- 縮放:確認控制項與標籤在產品支援的縮放層級下仍可理解,且不會重疊。
- 強制色彩與高對比:確保狀態與聚焦處理不依賴確切的預覽顏色,仍可理解。
- 減少動態效果:將持續時間設為 0,以移除可見的插值效果而不改變狀態,或在目的地樣式表中覆寫轉場持續時間。
- 螢幕閱讀器與鍵盤順序:確認無障礙名稱、勾選狀態宣告及變更後狀態宣告。
- 觸控目標大小:在周圍介面中評估切換開關;當所選大小在實際情境中不舒適時,請使用更大尺寸重新產生。
複製的基準內容不包含減少動態效果的媒體查詢。如果移動效果屬裝飾用途,或使用者要求減少動態效果,請加入目的地樣式表覆寫,將轉場持續時間設為 0。背景顏色與 transform 通常會共用所選的持續時間及 ease 計時關鍵字,因此單一覆寫即可移除可見的插值效果,而不改變控制項的意義。
整合外觀,但不要將其指派應用程式邏輯
請一併複製 CSS 與 HTML。每個輸出項目都會分別請求剪貼簿權限;如果拒絕存取,仍可手動選取可見的程式碼。所有內容都會在瀏覽器本機執行:產生器不會將您的設定與程式碼上傳、持續保存或傳送至元件產生服務。
| 關注項目 | 產生的輸出 | 目的地產品 |
|---|---|---|
| 視覺外觀 | 軌道、旋鈕、顏色、幾何結構、轉場及同步的 HTML。 | 整合各項宣告並確認算繪結果。 |
| 原生狀態語意 | 具標籤的核取方塊保留勾選狀態、Space 啟用、聚焦及提交行為。 | 保留輸入項與標籤之間的語意關係。 |
| 範例文字 | 供替換的預留標籤。 | 提供實際設定名稱及所需的狀態文字。 |
| 持續保存與網路更新 | 沒有應用程式設定邏輯、API 呼叫、持續保存、分析或樂觀復原。 | 儲存設定,並處理等待中的作業、失敗及復原。 |
| 停用、無效、載入中及唯讀狀態 | 沒有針對這些條件的個別呈現方式。 | 定義清楚且易於理解的狀態,並將錯誤或說明文字與相關欄位連結。 |
| 非原生 ARIA 同步 | 不會為裝飾性 div 等替代元件產生 ARIA 同步。 | 保留原生核取方塊,或實作獨立的狀態同步。 |
如果變更切換開關會觸發網路請求,請在 CSS 之外管理等待中與失敗狀態。視覺控制項不應在產品確認變更成功前,就表示變更已成功。請讓停用的控制項保持易於理解,並在更新失敗時提供明確回饋。如需了解產生的呈現方式與已儲存應用程式狀態之間的界線,請參閱產生的 CSS 切換開關程式碼是否會儲存設定。
執行產生後檢查
- 開啟CSS 切換開關產生器,在切換預覽的同時設定軌道寬度、軌道高度、邊距、持續時間,以及關閉、開啟與旋鈕顏色。
- 檢查兩種預覽狀態。確認勾選與未勾選位置在視覺上有所區別,且標籤描述的是設定,而不是操作。
- 複製 CSS 與 HTML,然後將範例標籤替換為實際的二元設定及必要的狀態文字。
- 檢查產生的像素值。確認旋鈕直徑等於高度減去兩倍邊距,且移動距離等於寬度減去高度。
- 測試點擊軌道或標籤、使用 Tab 移至輸入項、按下 Space,以及在實際頁面背景上看見可見的聚焦指標。
- 在整合後的產品中測試縮放、強制色彩、高對比、減少動態效果、螢幕閱讀器宣告及目標大小。
- 將標記整合至目的地應用程式,在任何框架接線後重新測試,並在產生的 CSS 之外驗證持續保存、等待中回饋、失敗處理及復原。
只有在切換開關的幾何結構、意義、互動、聚焦處理、環境行為及儲存狀態回饋全部一致時,才可將其視為已準備好投入生產環境。外觀與應用程式邏輯屬於不同層;在將設定視為完成之前,請檢查兩者。