產生 CSS 核取方塊後,在上線前應檢查其視覺樣式、原生核取方塊語意、無障礙標籤、鍵盤焦點與 Space 鍵啟用、對比、縮放行為、錯誤與停用狀態,以及強制色彩模式行為。 CSS 核取方塊產生器會產生同步的 CSS 與 HTML,以建立外觀自訂的原生核取方塊,因此產生的程式碼片段只是起點,不能證明該控制項已準備好上線。其即時預覽會套用輸出內容中顯示的相同樣式表與限定範圍類別,方便檢查程式碼,但預覽頁面也包含許多可聚焦控制項,且並未重現真實表單中的每種情況。因此,有用的檢查應分別提出兩個問題:程式碼是否保留瀏覽器的核取方塊行為,以及完成後的控制項在目的地頁面上是否仍容易理解並可操作?先在複製的標記與 CSS 中確認第一點,再使用真實標籤、周邊說明、表單邏輯、鍵盤導覽,以及使用者可能已啟用的作業系統設定來確認第二點。這個順序可避免把外觀精緻的方塊當成無障礙特性的證據。

產生器已處理的內容
此產生器會改變核取方塊的繪製方式,而不會以一般元素取代控制項。複製的 HTML 使用 type=checkbox 的 input,而 appearance: none 會抑制瀏覽器的預設繪製。當周邊應用程式正確使用這些功能時,瀏覽器仍會保留核取狀態、鍵盤啟用、表單參與及停用行為。MDN 的 appearance 參考資料與 W3C CSS Basic User Interface Level 4提供此屬性及其相容性考量在瀏覽器層面的相關背景資訊。
- 原生 input:輸出內容會保留 type=checkbox 的 input,而不會以一般 div 取代。
- 自訂繪製:相對定位的 input 會使用 ::after 偽元素,僅在核取方塊被選取時繪製核取標記。
- 明確定義的幾何規格:CSS 會使用 box-sizing: border-box,因此所選尺寸包含可見邊框,也包含 cursor: pointer、選取狀態的背景與邊框顏色。
- 可見焦點:帶有偏移量的 focus-visible 外框會與強調色相符。焦點並未移除,但外框可能需要依目的地頁面進行調整。
- 具名範例:input 會巢狀於可見的標籤文字中,使範例具有無障礙名稱,並讓使用者能點選文字來切換方塊。HTML 中不包含內嵌指令碼。
確認產生的 CSS 與 HTML
- 在允許的範圍內設定幾何規格。選擇介於 16 至 64 像素的整數像素尺寸、介於 1 至 6 像素的整數像素邊框,以及介於 0 至 50 百分比的圓角半徑。當需要整數時,產生器會拒絕小數,也會拒絕超出範圍的幾何規格,而不會默默產生誤導性的值。
- 輸入三個完整的六位數 HEX 顏色。這些顏色分別控制強調色、背景與核取標記。格式錯誤的顏色字串會被拒絕,因此除了透過瀏覽器色彩控制項選擇的值,也應檢查輸入或貼上的值。
- 切換即時預覽。點選方塊或其預覽標籤,以比較未選取與已選取的繪製效果。預覽會在限定範圍的 lizely-checkbox 類別下算繪相同的產生樣式表。請將標記的比例寬度、高度、粗細與偏移量視為產品層面的選擇,而非通用標準;定義的最小值可確保標記在支援的最小尺寸下仍然可見。
- 檢查實作細節。確認 HTML 仍保留 type=checkbox 且具有關聯可見標籤的 input。CSS 應保留 appearance: none、box-sizing: border-box、cursor: pointer、相對定位、選取狀態的背景與邊框顏色,以及帶有偏移量的 focus-visible 外框。::after 標記應僅出現在選取狀態,且不應移除焦點。
- 分別複製 CSS 與 HTML。每次複製操作都會各自要求剪貼簿權限,成功訊息會指出已複製的區塊。如果權限遭拒,兩個程式碼區塊仍會保持可見,供手動選取,頁面也不會回報不實的成功訊息。產生與複製作業完全在目前的瀏覽器分頁中進行,不涉及帳戶、上傳、樣式表服務或儲存的設計狀態。
- 將輸出內容整合至真實表單。將 CSS 放入受控制的樣式表,並把 HTML 插入目的地頁面。將範例標籤替換為實際選項的適當文字。如果重新命名 lizely-checkbox,請同時更新 CSS 選擇器與 HTML 類別。使用框架的使用者可以依需求將 class 轉換為 className,並連結 checked 或 onChange,同時保留原生 input 與無障礙標籤關聯。
比較預覽與正式環境狀態
預覽涵蓋控制項的基準外觀,但未涵蓋正式表單可能需要的每種狀態。請利用此比較,區分產生的輸出內容已提供的部分,以及必須在目的地驗證的部分。
| 狀態或區域 | 產生器涵蓋範圍 | 目的地檢查 |
|---|---|---|
| 未選取與已選取 | 顯示於互動式預覽中 | 使用真實標籤與周邊內容檢查兩種狀態。 |
| Focus-visible | 包含為基準外框 | 確認其在實際周邊環境中仍清晰可見。 |
| 停用 | 未模擬為專屬的視覺狀態 | 在真實 input 上設定停用狀態,並測試其外觀與行為。 |
| 無效與必填 | 未模擬 | 加入真實限制、驗證、錯誤文字及情境說明。 |
| 未確定與唯讀 | 未模擬 | 另行實作這些狀態;產生的核取標記並不代表這些狀態。 |
| 強制色彩 | 未模擬 | 測試作業系統的覆寫設定,並保留有用的無障礙行為。 |
當周邊表單設定 disabled 屬性時,原生 input 仍可停用,但這不表示產生器已測試你的停用設計。同樣地,已選取的偽元素本身並未說明無效、必填、未確定或唯讀行為。請在產品中加入這些狀態,並使用真實表單邏輯加以驗證。選取狀態仍由瀏覽器與周邊表單管理,而非由片段中的內嵌指令碼管理。
執行目的地表單測試
內嵌預覽無法取代對目的地表單焦點順序、說明、驗證及完整使用者流程的測試。
- 鍵盤順序:使用 Tab 鍵瀏覽實際表單,確認核取方塊會在預期位置取得焦點。
- 焦點可見性:檢查 focus-visible 外框是否存在、未受遮蔽,且能與核取方塊的其他狀態清楚區分。
- Space 鍵啟用:讓 input 取得焦點,按下 Space 鍵,並確認其選取狀態有所變更。點選可見標籤也應能切換控制項。
- 縮放:在 200 percent 縮放下測試,確認方塊、核取標記、標籤、焦點外框及鄰近說明仍可見,且不會遭到裁切。
- 表單狀態:觸發必填與無效情況,檢查相關錯誤文字,並在完整表單的情境中測試停用選項。
- 懸停與指標行為:在最終主題中檢查產生的指標游標及懸停處理方式。必要時,加入或調整應用程式專屬的懸停樣式。
- 真實內容:將示範文字替換為實際選項,加入任何必要的說明,並使用輔助科技驗證完成的表單。
檢查顏色與平台覆寫
請檢查完整的顏色關係,而非逐一孤立地檢查色塊。檢查強調色、背景、核取標記、邊框、焦點指示器、周邊頁面、懸停狀態、錯誤文字及停用狀態。產生的外框會與強調色相符,但你的頁面可能需要不同的外框顏色或寬度,才能在實際背景上達到足夠的對比。請使用 色彩對比檢查器,依 WCAG AA 與 AAA 準則評估相關前景與背景組合,然後在實際情境中檢查焦點與邊框狀態。
作業系統與瀏覽器在強制色彩模式下可能會覆寫自訂顏色。這種差異屬預期行為,且可能改善需要系統色彩的使用者的可見性。請測試此模式,除非有充分理由,否則避免抑制有用的覆寫。如果某個自訂顏色消失,請修改 CSS,不要假設原始 HEX 值遭到忽略。
核取標記的比例是產生器刻意定義的,並非由通用設計標準強制規定。在不尋常的縮放比例、裝置像素比或極端邊框設定下,反鋸齒可能使其中一條邊緣看起來稍重。基準版本不會產生動態效果,因此產生的結果不需要處理動態偏好設定。
做出發布決定
只有在程式碼層面與目的地層面的檢查結果一致時,產生的核取方塊才適合發布。
- 標記中仍包含原生核取方塊,以及有意義且可見的標籤。
- 限定範圍的 CSS 包含產生的幾何規格、選取狀態繪製、尺寸規則及保留的焦點樣式。
- 在目的地中,Tab 鍵、Space 鍵、點選標籤與 200 percent 縮放皆可正常運作。
- 已實作並測試必填、無效、停用,以及任何需要的未確定狀態。
- 在最終主題與強制色彩模式中,顏色關係仍容易理解。
- 已使用真實內容與適當的輔助技術檢查完整表單。
如果幾何規格或顏色有誤,請調整產生器設定並重新複製輸出內容。如果基準版本運作正確,但缺少某項產品狀態,請在應用程式的 CSS 與表單邏輯中實作該狀態。無論是哪一種情況,都應保留原生 input 與無障礙標籤關聯,並記錄最終產生的設定與測試條件,以便日後變更主題時,能依相同檢查清單進行核對。
相關閱讀:產生 CSS Cubic Bezier 後,我應該檢查什麼?。
相關閱讀:CSS 切換開關產生器:從預覽到正式環境。