當您需要可重複使用且具有精確 CSS 與 HTML 的自訂樣式時,請產生 CSS checkbox;若是一次性例外情況,或既有設計系統讓手動整合更為簡潔,則請手動撰寫。
實務上的答案通常是「先產生,再手動微調」。產生器在起點階段最有價值:它將選定的幾何形狀與顏色轉換為同步的程式碼,同時讓結果核心保留真正的 checkbox 輸入。當您的專案已有維護中的 checkbox 模式、需要基準以外的狀態,或適應單一特殊控制項比將其標準化更省事時,手動 CSS 會是較理想的選擇。

產生器與手動方式的實務比較
| 因素 | 適合產生的情境 | 適合手動撰寫的情境 |
|---|---|---|
| 重複使用 | 多個表單需要一致的方形 checkbox 樣式。 | 此控制項是既有元件的罕見例外。 |
| 設計設定 | 您需要大小、邊框、圓角與三種顏色的基準設定。 | 您的專案已有權杖、選擇器與命名規則。 |
| 視覺回饋 | 您想在複製程式碼前比較選取與未選取的狀態。 | 您已掌握確切的 CSS,只需要小幅編輯。 |
| 狀態需求 | 基準設定已足夠,而且您可以在目的地驗證其他狀態。 | 您需要新增並自行維護未選取、無效、必填、停用、唯讀或自訂動畫行為。 |
| 整合 | 您需要為原型或新元件建立同步的 CSS 與 HTML。 | 框架繫結、現有的層疊規則或元件庫讓直接整合更為簡潔。 |
| 維護責任 | 您會審閱、調整並維護貼上的程式碼。 | 此樣式必須永久納入維護中的設計系統。 |
當您需要可靠的起點,並會在實際表單中進行測試時,請選擇產生。當與周邊系統的相容性比速度更重要時,請選擇手動方式。產生的結果是供審閱與調整的程式碼,而非完整的表單元件。
產生方式更適合的情境
當您想要自訂方形 checkbox,卻尚未擁有經過驗證的 CSS 配方時,CSS Checkbox Generator 是實用的起點。它可讓您設定方形大小、邊框寬度、圓角、強調色、背景色與勾號顏色,並同時顯示精確的 CSS 與無障礙 HTML。
- 相同的方形 checkbox 外觀會在多個表單或頁面中重複使用。
- 您想在將程式碼寫入樣式表前先查看即時預覽。
- 您需要精確且同步的 CSS 與 HTML,而不是分別組合各部分。
- 您想保留原生 checkbox 輸入,而不是使用一般元素模擬 checkbox。
- 您正在開始建立新元件,之後可以使用實際內容測試結果。
產生與複製作業完全在目前的瀏覽器分頁中進行。不需要帳戶、不需上傳,也沒有外部樣式表服務或已儲存的設計狀態。這讓產生器便於用來產生程式碼,但不會將它變成設計系統儲存庫。如果您建立多個變體,請將核准的尺寸與顏色提升為自有專案權杖。
手動 CSS 更適合的情境
當您的程式碼庫已定義顏色、間距、圓角、邊框與焦點權杖時,手動 CSS 通常更為簡潔。手寫規則可以遵循這些慣例,而不需新增另一個類別與一組重複的值。對於幾何形狀已知的單次控制項,手動方式也適合,尤其是在產生並調整大型程式碼區塊比撰寫最終規則更費工時。如果瀏覽器的原生 checkbox 已符合視覺與行為需求,兩種自訂方式都不需要採用。
當應用程式行為超出產生的基準設定時,請選擇手動方式。預覽不會模擬未選取、無效、必填、停用、唯讀、高對比或強制顏色狀態。您可以手動加入相關標記、樣式與處理方式,但之後最終行為由您負責,而且必須加以驗證。這並不表示產生的 checkbox 失去原生語意:CSS appearance: none 會抑制瀏覽器的預設繪製,但當周邊應用程式正確使用這些功能時,原生元素仍會提供選取狀態、鍵盤焦點、表單參與及停用行為。MDN 的 appearance 屬性參考資料與 CSS Basic User Interface Level 4 會說明此屬性及其相容性考量。
手動整合也適合需要框架專屬繫結或自訂動態效果的專案。請將 class 轉換為 className,並依需求連結 checked 或 onChange,但保留原生輸入與無障礙標籤的關聯。手動作業是指手寫整合,而不是以一般 div 取代 checkbox。
建立產生的 checkbox
- 開啟產生器,在觀看即時預覽的同時,選擇方形大小、邊框寬度、圓角與三種顏色。大小可接受 16 至 64 的整數像素,邊框可接受 1 至 6 像素,圓角可接受 0 至 50 百分比,每種顏色都必須是完整的六位數 HEX 值。產生器會拒絕格式錯誤的顏色、在需要整數時使用的小數,以及超出範圍的幾何形狀,而不會默默產生誤導性的程式碼。
- 點選方框或預覽標籤以切換預覽,讓您能檢查未選取與選取狀態。focus-visible 樣式會持續存在,而勾號只會在輸入處於選取狀態時以 ::after 偽元素繪製。其比例會依選定的方框大小縮放;這些比例是刻意的產品選擇,而非通用設計標準。
- 審閱並複製 CSS 與 HTML。兩個複製動作會分別要求剪貼簿權限,成功訊息會指出已複製的是哪個輸出。如果權限遭拒,兩個程式碼區塊仍會保持可見,讓您手動選取,頁面也不會回報虛假的成功訊息。HTML 程式碼片段不含內嵌指令碼。
- 將 CSS 貼入受控的樣式表,並將 HTML 放入目的地表單。預覽使用限定範圍的 likely-checkbox 類別;如果您的專案需要不同名稱,請重新命名,並同步更新對應的 CSS 與 HTML 參照。請讓輸入維持 type="checkbox",並保留將其置於含有可見文字的 label 內的範例結構。請將範例標籤替換為實際選項的具體描述,而不是在正式環境中留下一般性文字。
- 只調整您的框架所需的部分。將 class 轉換為 className,並視需要連結 checked 或 onChange,同時保留原生輸入與無障礙標籤的關聯。周邊應用程式仍須負責處理選取資料與表單提交。
- 在目的地表單中測試複製的結果。在將產生的程式碼視為可供正式環境使用之前,請檢查鍵盤焦點、Space 鍵啟用、對比、縮放、錯誤、停用狀態與強制顏色。預覽有助於比較外觀,但無法取代對實際頁面的測試。
在目的地測試結果
內嵌的產生器頁面含有許多可聚焦控制項,因此其預覽無法確立最終的 Tab 順序或表單周邊的說明文字。請使用實際標籤、說明文字、錯誤與提交資料測試目的地。
- 使用 Tab 鍵將焦點移至控制項,並確認 focus-visible 外框及其偏移量清楚可見。使用 Space 鍵變更選取狀態。請勿僅為符合視覺設計而移除焦點指示。
- 確認可見標籤為 checkbox 提供無障礙名稱,點選文字可切換輸入,且輸入仍會參與表單。
- 在完整主題中評估強調色、背景、勾號、邊框、焦點指示、周邊頁面、hover 狀態、錯誤文字與停用狀態。
- 以 200 百分比縮放進行測試。在不尋常的縮放層級、裝置像素比或極端邊框設定下,抗鋸齒可能使勾號的某個邊緣看起來稍微較粗。
- 使用實際內容驗證錯誤與停用行為。CSS Checkbox Generator 停用與錯誤狀態指南 會說明為什麼預覽涵蓋範圍與目的地涵蓋範圍是各自不同的考量。
- 測試作業系統的強制顏色。瀏覽器與作業系統可能會覆寫自訂顏色;除非有充分理由,請避免抑制有用的覆寫設定。
外觀美觀的 checkbox 並不會自動具備無障礙性。完整的驗證需要使用實際內容與輔助科技測試完成的表單。
將樣式標準化之前,先規劃限制
產生的基準設定著重於未選取、選取與 focus-visible 外觀。它不會模擬未選取、無效、必填、停用、唯讀、高對比或強制顏色狀態。請將這些缺漏視為新增並驗證產品所需狀態的提示,而不是原生 checkbox 無法支援它們的證據。
輸出使用 box-sizing: border-box,因此選定的尺寸包含可見邊框。它也會保留 focus-visible 外框,其顏色與選定的強調色相符。周邊環境可能需要不同的外框顏色或寬度,因此必要時請調整該規則,並依頁面背景測試結果。
勾號尺寸、邊框粗細、偏移與旋轉角度都是本產品自行定義的選擇,而非外部規定的標準。由於此工具不會產生動態效果,基準設定不需要處理動畫偏好;日後加入的自訂動態效果應另行評估。最後,請記得強制顏色模式可能會刻意取代選定的顏色。
採用簡單的團隊決策規則
當您需要符合工具支援控制項的視覺一致基準,且能在目的地進行驗證時,請產生。當整合至既有權杖、支援應用程式專屬狀態,或處理一次性例外情況時,請手動撰寫。產生的程式碼一旦進入產品,就請像其他 CSS 一樣對待:必要時重新命名、記錄核准值、補上缺少的狀態,並像審閱正式環境程式碼一樣審查變更。
這能消除自動化與手工製作之間的虛假二選一。產生可減少重複的視覺設定工作,而手動審閱則能讓結果符合產品的無障礙性、框架與設計系統需求。