當您需要為原生 HTML 核取方塊套用自訂視覺樣式,以及需要可貼入實際表單的相符 CSS 與 HTML 時,請產生 CSS 核取方塊。此產生器是樣式設定輔助工具,不能取代對完成表單的測試。

適合產生的情況
當專案需要特定的方塊尺寸、邊框、圓角與三色樣式,而您想在複製程式碼前先行評估時,請使用產生器。當共用樣式表規則必須讓多個核取方塊呈現相同外觀時,這項功能尤其實用。由於預覽使用的是實際產生的樣式表,您可以在將程式碼帶入頁面前先做出視覺決策。
| 專案需求 | 使用產生器? | 原因 |
|---|---|---|
| 自訂方形外觀 | 產生 | 可在即時預覽中一併調整尺寸、邊框、圓角與顏色。 |
| 可重複使用的 CSS 與 HTML | 產生 | 此工具會顯示預覽所使用的實際樣式表與加上標籤的 HTML。 |
| 可接受瀏覽器的預設核取方塊 | 通常略過 | 自訂外觀可能增加樣式設定工作,卻未符合實際的設計需求。 |
| 停用、錯誤、必要或未確定的行為 | 作為起點使用 | 基準樣式不會模擬這些狀態,因此必須在目標表單中新增並驗證。 |
| 動態效果或非標準互動 | 僅靠產生器並不足夠 | 它提供 CSS 外觀,但不含內嵌指令碼;自訂行為應在周邊應用程式中實作。 |
當原生控制項已符合視覺需求時,就不需要產生。較複雜的表單仍需在 外觀 之外進行實作與審查,因此請將產生的程式碼視為受控的起點,而不是無障礙認證。
產生結果包含哪些內容
輸出內容會為實際的 input type="checkbox" 套用樣式,而不是將它取代為一般元素。CSS 會套用 appearance: none 以移除瀏覽器的預設繪製方式,而原生元素在周邊應用程式正確使用這些功能時,仍可提供勾選狀態、鍵盤焦點、表單參與及停用行為。範例 HTML 會將 input 巢狀放置於可見的 label 內,讓核取方塊具有無障礙名稱,並讓標籤文字可切換控制項。
- 預覽與複製的程式碼會共用範圍限定的類別 lizely-checkbox。如果您的專案需要不同的命名空間,請在兩份輸出內容中一併重新命名。
- CSS 包含 box-sizing: border-box,因此所選的方形尺寸包含可見邊框。
- 只有在 input 處於勾選狀態時,才會使用 ::after 偽元素繪製核取符號。其尺寸與邊框粗細會依所選方塊尺寸等比例縮放。
- 核取符號使用右邊框與下邊框、45 度旋轉及等比例位移。這些比例是特定產品的設計選擇,並非通用的 CSS 需求。
- 輸出內容會保留具有位移的 focus-visible 外框,以及指標、勾選狀態、定位與顏色宣告。
產生與複製作業完全在目前的瀏覽器分頁中進行。沒有帳戶、上傳、樣式表服務或已儲存的設計狀態,因此若您需要在之後重現,請將複製的程式碼與專案保存在一起。HTML 刻意不含內嵌指令碼;核取方塊狀態由瀏覽器與周邊表單管理。
在支援的範圍內選擇設定
複製任一輸出內容前,請先設定幾何圖形與顏色控制項。產生器接受有範圍限制的整數值與嚴格的 HEX 顏色,而不會在未告知的情況下產生令人誤解的程式碼。
| 設定 | 接受的值 | 實作細節 |
|---|---|---|
| 方形尺寸 | 16–64 整數像素 | 由於輸出採用 border-box 尺寸設定,因此包含可見邊框。 |
| 邊框寬度 | 1–6 整數像素 | 此值會影響所選尺寸與邊緣外觀。 |
| 圓角 | 0–50 整數百分比 | 此百分比以方塊尺寸為基準。 |
| 強調色、背景與核取符號顏色 | 完整的六位數 HEX 值 | 三個顏色控制項各自都需要完整的 HEX 值。 |
格式錯誤的顏色、需要整數卻有小數的值,以及超出支援範圍的幾何尺寸都會被拒絕。瀏覽器的顏色控制項通常會提供有效的值,而數字控制項則會限制一般指標與鍵盤變更。在不尋常的縮放比例、裝置像素比或極端邊框設定下,反鋸齒可能使其中一條邊緣看起來稍粗;請在目標環境中判斷該外觀,而不要將它視為幾何錯誤。
產生、複製並整合核取方塊
- 開啟 CSS 核取方塊產生器,在支援的範圍內調整方形尺寸、邊框寬度、圓角、強調色、背景色與核取符號顏色。
- 檢查預覽的兩種狀態。點選方塊或預覽標籤,以測試勾選與未勾選的外觀,並確認所選尺寸與顏色符合預定的表單設計。
- 複製 CSS 與 HTML。兩個複製動作會分別要求剪貼簿權限,成功訊息會指出已複製哪份輸出內容。如果權限遭拒,兩個程式碼區塊仍會保持可見,方便手動選取,而且工具不會回報虛假的成功訊息。
- 將 CSS 貼入受控的專案樣式表。讓 CSS 與 HTML 使用一致的類別名稱,或在部署前於兩處一併重新命名。
- 將 HTML 貼入實際表單,並將範例標籤文字替換為實際選項的適當描述。保留原生 input 及其無障礙標籤關聯,不要在正式環境中留下一般性的範例文字。
- 如果使用框架,請在需要時將 class 轉換為 className,並依需求連結 checked 或 onChange。框架語法不應移除原生核取方塊,也不應將控制項與其標籤分離。
- 將完成的控制項複製到目標頁面,並執行下方說明的無障礙檢查。內嵌的產生器頁面包含許多可聚焦的控制項,因此其預覽無法確立實際表單的焦點順序或操作指示。
保留原生行為與可見焦點
這種方法的主要優點在於,CSS 只會改變控制項的繪製方式,不會取代其底層語意。MDN 的 appearance 參考資料會說明此屬性及其相容性考量,而 CSS Basic User Interface Level 4則定義標準層級的行為。
產生的 CSS 不會移除焦點。內含的 focus-visible 外框可協助鍵盤使用者辨識哪些控制項會回應空白鍵,其顏色也會與所選強調色相符。您的目標頁面可能需要不同的外框顏色或寬度,才能與實際頁面背景達到足夠的對比,因此請在貼入程式碼後調整此細節。請勿移除可見的指示器,除非另提供合適的替代方案。
請保持 input 原生的勾選狀態與表單參與行為不變。如果產品需要驗證訊息、情境指示、停用選項或特定於應用程式的行為,請在產生的控制項周邊實作並測試,不要假設自訂繪製方式會提供這些功能。
在目標表單中驗證控制項
預覽適合用來比較產生的外觀,但目標頁面才提供實際的周邊環境、內容與互動順序。整合後請測試核取方塊,不要只根據產生器頁面核准。
- 鍵盤焦點:使用 Tab 鍵,確認核取方塊會依預定順序取得焦點,且焦點指示器仍然清楚可見。
- 空白鍵啟動:當核取方塊具有焦點時按下空白鍵,確認其會切換為預期的勾選狀態。
- 對比:檢查強調色、背景、核取符號、邊框、焦點指示器與周邊頁面。產生器不會執行這項評估;色彩對比檢查器可以依 WCAG 對比規則評估前景與背景配對。
- 縮放:以 200% 縮放比例測試,確認方塊、核取符號、標籤與焦點指示器仍可使用,且不會被裁切或遮蔽相鄰內容。
- 錯誤與必要欄位行為:測試無效或必要的選項,並在完整表單中驗證相關錯誤文字與狀態。
- 停用行為:確認停用選項的外觀不同、無法啟用,且周邊指示能正確辨識其狀態。
- 強制色彩:在啟用作業系統強制色彩的情況下檢視頁面,確認控制項仍能清楚理解。
最後,請使用實際的標籤文字、表單順序、說明內容與輔助科技進行測試。外觀美觀的核取方塊並不會自動具備無障礙性,目標表單才是驗證完整使用體驗的適當位置。
新增預覽無法模擬的狀態
產生的基準樣式涵蓋未勾選、已勾選與 focus-visible 外觀,但不會模擬未確定、無效、必要、停用、唯讀、高對比或強制色彩狀態。這項限制並不表示原生 input 缺少瀏覽器語意;它表示產生器無法呈現這些狀態在您的產品中會呈現的外觀或行為。
請新增並驗證實際表單要求的每種狀態。在強制色彩模式下,作業系統或瀏覽器可能會覆寫自訂顏色。這項覆寫對依賴系統層級無障礙設定的使用者可能有益,因此除非有充分理由,否則請勿抑制它。同一原則也適用於焦點外框:必要時加以調整,但仍要保留清楚可見的指示器。
做出最終的正式環境決策
當設計需要特定的視覺處理,且你需要同步的 CSS 和 HTML 來開始實作時,請產生核取方塊。若原生控制項的外觀已經合適,請略過自訂圖層;也不要期望產生的內容能提供複雜狀態、動態效果、驗證邏輯或表單行為。
產生後,請將輸出內容貼到受控的樣式表中,保留原生輸入元素和無障礙標籤,並使用真實內容及輔助技術驗證完整表單。產生器會提供起始點;最終測試環境才能決定完成的核取方塊是否已準備好推出。
若要深入瞭解,請參閱 何時應產生 CSS Cubic Bezier,而非自行輸入。
若要深入瞭解,請參閱 何時應產生 CSS 切換開關?。