產生 CSS 切換開關後,請在發布前檢查其幾何結構、實際設定標籤、鍵盤操作、聚焦顯示、動態行為及持續保存處理。

即使樣式表有效,仍可能產生不清楚或故障的設定。請將產生的程式碼視為視覺與互動測試的起點,而非完整的應用程式設定系統。請一併檢查外觀、原生核取方塊語意、目的地頁面及儲存狀態流程。

what should i review after i generate css toggle switch
產生 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 切換開關程式碼是否會儲存設定。

執行產生後檢查

  1. 開啟CSS 切換開關產生器,在切換預覽的同時設定軌道寬度、軌道高度、邊距、持續時間,以及關閉、開啟與旋鈕顏色。
  2. 檢查兩種預覽狀態。確認勾選與未勾選位置在視覺上有所區別,且標籤描述的是設定,而不是操作。
  3. 複製 CSS 與 HTML,然後將範例標籤替換為實際的二元設定及必要的狀態文字。
  4. 檢查產生的像素值。確認旋鈕直徑等於高度減去兩倍邊距,且移動距離等於寬度減去高度。
  5. 測試點擊軌道或標籤、使用 Tab 移至輸入項、按下 Space,以及在實際頁面背景上看見可見的聚焦指標。
  6. 在整合後的產品中測試縮放、強制色彩、高對比、減少動態效果、螢幕閱讀器宣告及目標大小。
  7. 將標記整合至目的地應用程式,在任何框架接線後重新測試,並在產生的 CSS 之外驗證持續保存、等待中回饋、失敗處理及復原。

只有在切換開關的幾何結構、意義、互動、聚焦處理、環境行為及儲存狀態回饋全部一致時,才可將其視為已準備好投入生產環境。外觀與應用程式邏輯屬於不同層;在將設定視為完成之前,請檢查兩者。