當顏色或幾何值未通過嚴格的格式或範圍驗證時,CSS Checkbox Generator 就會顯示無效輸入錯誤。這是欄位層級的驗證訊息,並非宣告原生核取方塊無法套用樣式。
此頁面採用刻意受限的一組值。如此一來,產生的 CSS 會較可預測,但這也意味著小數尺寸、超過支援上限的半徑或縮短的 HEX 顏色等值,都會被視為無效。修正方式是將遭拒絕的值恢復為可接受的格式、檢查更新後的預覽,然後在目標表單中測試複製的輸出。

無效輸入訊息正在檢查什麼
此產生器會對其幾何與顏色欄位套用嚴格驗證,而不會直接從格式錯誤的輸入默默產生程式碼。數值幾何必須使用支援範圍內的整數,而三個顏色控制項都必須包含完整的六位數 HEX 值。
| 欄位 | 必要格式 | 可接受的值 | 輸入遭拒絕的原因 |
|---|---|---|---|
| 大小 | 整數像素 | 16 到 64 | 小數、低於 16 的值或高於 64 的值 |
| 邊框 | 整數像素 | 1 到 6 | 小數、低於 1 的值或高於 6 的值 |
| 半徑 | 整數百分比 | 0 到 50 percent | 小數、負值或高於 50 percent 的值 |
| 強調色 | 完整的六位數 HEX | 任何有效的六位數 HEX 值 | 三位數簡寫、具名顏色、RGB 文字、HSL 文字或不完整的值 |
| 背景顏色 | 完整的六位數 HEX | 任何有效的六位數 HEX 值 | 格式並非完整的六位數 HEX 值 |
| 勾號顏色 | 完整的六位數 HEX | 任何有效的六位數 HEX 值 | 格式並非完整的六位數 HEX 值 |
一般使用時,瀏覽器本身的顏色控制項通常會提供有效值,而數值控制項則會限制正常以滑鼠或鍵盤變更的範圍。因此,無效輸入最可能是某個值經過編輯,或以不符合產生器規格的格式輸入。產生作業完全在目前的瀏覽器分頁中進行,因此這項驗證不涉及任何上傳或樣式表服務。
產生器驗證與瀏覽器表單有效性不同
產生的 HTML 會保留 input type="checkbox"。CSS 使用 appearance: none 改變控制項的繪製方式,但瀏覽器仍會管理其勾選狀態與原生表單參與行為。MDN appearance 參考資料說明了此屬性及其相容性考量,而W3C CSS Basic User Interface 規格則從標準層面定義 appearance 的行為。
診斷錯誤時,這項區別很重要。產生器會驗證自己的大小、邊框、半徑與顏色欄位,但不會模擬無效或必填的核取方塊、停用的控制項、唯讀狀態、高對比模式或強制顏色。複製的 HTML 也沒有包含內嵌指令碼;核取方塊狀態與表單驗證仍由瀏覽器及周圍的應用程式負責。
因此,編輯產生器時顯示的無效輸入訊息,與其受限欄位中的某個值有關。若訊息只在產生的程式碼放入頁面後才顯示,則可能來自在核取方塊周圍加入的應用程式規則,例如必填欄位或其他原生有效性限制。
辨識遭拒絕之值的線索
- 數值欄位中出現小數:大小、邊框與半徑都需要整數幾何值。像 24.5 像素這樣的值,不符合可接受的整數格式。
- 數值剛好超出邊界:大小必須介於 16 到 64 像素之間,邊框必須介於 1 到 6 像素之間,半徑則必須介於 0 到 50 percent 之間。
- 顏色看似正確卻是縮寫:產生器要求完整的六位 HEX 數字。像 #FFF 這樣的值並非完整的六位數 HEX 值,即使瀏覽器可以解讀 CSS 簡寫。
- 顏色以其他表示法撰寫:具名顏色、RGB 表示法與 HSL 表示法都不符合必要的 HEX 輸入格式。
- 目標位置仍包含先前的值:複製的輸出會直接放入你的專案中,而且不會自動更新,因為產生器並未儲存設計狀態。
修正產生器中的無效輸入
- 開啟CSS Checkbox Generator,檢查大小、邊框、半徑、強調色、背景顏色與勾號顏色欄位。在替換整個設計之前,先找出格式不符可接受範圍的項目。
- 將大小設為 16 到 64 像素之間的整數。移除任何小數尾數,並確認結果仍位於支援的最小值與最大值之間。
- 將邊框設為 1 到 6 像素之間的整數。將半徑設為 0 到 50 percent 之間的整數百分比。這兩個控制項都需要整數,而非小數幾何值。
- 將每個顏色替換為完整的六位數 HEX 值,並包含開頭的 #。例如,#1A73E8 與 #FFFFFF 符合可接受的格式,而 #FFF 與具名顏色則不符合。
- 確認修正後即時核取方塊預覽已更新。點選預覽方塊或其標籤,以測試勾選與未勾選狀態,並檢查可見輸出是否仍符合預期的大小、邊框、半徑與顏色。
- 使用 Copy CSS 與 Copy HTML 傳輸同步後的輸出。這兩個複製動作會分別要求剪貼簿權限。如果權限遭拒,兩個程式碼區塊仍會保持可見,供手動選取,頁面也不會錯誤回報成功。
- 將更新後的程式碼貼到目標專案中,並以描述實際表單選項的文字取代範例標籤。保留原生核取方塊輸入及其無障礙標籤關聯。在框架中,如果應用程式有需要,請將 class 等屬性轉換為 className,並連接 checked 或 onChange 行為。
整合後出現錯誤時檢查目標位置
如果產生器接受所有欄位,但目標位置仍回報無效輸入,請檢查周圍的表單,而不要反覆變更有效的幾何值。基準產生的程式碼涵蓋未勾選、已勾選與 focus-visible 的呈現方式,但不會建立實際產品可能需要的無效、必填、停用或唯讀狀態。
- 如果程式碼是在最後一次修正前複製的,請在目標程式碼中搜尋舊的大小、邊框、半徑或顏色值。
- 檢查應用程式加入的 required 或其他有效性屬性。這些規則會作用於目標位置中的原生輸入,並與產生器的欄位驗證分開。
- 確認 HTML 仍包含 type="checkbox" 的輸入,而不是用來模仿核取方塊的一般元素。
- 檢查 CSS 選擇器是否仍符合套用至輸入的 class,尤其是在框架或建置程序重新命名屬性之後。
- 確認輸入仍與可見的標籤文字相關聯。產生器的範例會將輸入放在標籤內,但其範例文字不應保留於正式產品中。
修正值後驗證無障礙功能
有效的值可提供可用的起始點,但並不代表已完成無障礙功能認證。內嵌工具頁面含有許多可聚焦的控制項,因此其預覽無法取代對目標表單的 Tab 順序、說明與錯誤行為的測試。
- 在目標位置使用 Tab,確認核取方塊會顯示可見的焦點指示器,然後按 Space 變更其勾選狀態。
- 檢查強調色、背景、勾號、邊框、焦點外框與周圍頁面是否具有足夠的對比。產生的焦點外框會符合強調色,但你的網站可能需要不同的外框顏色或寬度,才能適合實際的周圍環境。
- 在 200 percent 縮放下測試頁面,並確認方塊、標籤、焦點指示器與鄰近內容仍可使用。
- 當實際產品需要時,新增並驗證錯誤文字、停用行為、必填行為與情境式說明。
- 在作業系統的強制顏色模式下測試控制項。系統可能會覆寫自訂顏色,而這可支持使用者的無障礙偏好;除非有充分理由,否則不應對抗此設定。
- 在推出前,使用真實內容與輔助科技測試完整表單。
如需更深入了解,請參閱為何 CSS cubic-bezier() 的 x1 與 x2 必須介於 0 和 1 之間。
如需更深入了解,請參閱為何 CSS Toggle Switch 是由 Checkbox 建構而成?。