只要輸入值超出可接受範圍,CSS Checkbox Generator 就會拒絕產生核取方塊,而這種拒絕也是訪客認為工具故障的最常見原因。產生器僅接受介於十六至六十四整數像素之間的尺寸值、介於一至六像素之間的邊框寬度、介於零至五十百分比之間的圓角半徑,以及每個色彩欄位皆須使用完整的六位數 HEX 色碼,例如 #1E90FF。其他任何值,包括三位數的短版 hex、dodgerblue 這類具名色彩、rgb() 值、17.5 這類小數值,或設定為七像素的邊框,都會使輸出停止更新。請將這種停滯視為刻意的驗證訊息,而非錯誤;如此一來,復原流程就會變成一份清楚的檢查清單,而不必靠猜測。CSS Checkbox Generator 頁面會透過控制項顯示這些範圍,因此可在追查不存在的錯誤之前輕鬆確認。

哪些因素會阻止 CSS Checkbox Generator 產生程式碼
工具拒絕算繪新輸出,是你所能掌握的最明確訊號。以下三項檢查幾乎涵蓋所有回報「無法產生」的情況,而且這三項都能在 CSS Checkbox Generator 的即時預覽窗格中看到。首先,確認每個色彩欄位都包含六位十六進位數字。#fff 這類簡短形式、royalblue 這類具名關鍵字,以及任何 rgb() 或 hsl() 值都不會被解析;產生器刻意採取嚴格處理。其次,檢查數值控制項。以像素表示的尺寸、以像素表示的邊框寬度,以及以百分比表示的半徑,各自都有上限,分別為六十四、六、五十;螢幕上的控制項會強制執行這些上限,但貼入或透過指令碼輸入的值仍可能超過上限,導致預覽停滯。第三,留意色彩欄位是否只選取部分內容或出現非預期值;嚴格的驗證器會拒絕這些值,而不會默默產生損壞的 CSS。
此頁面也會在複製的輸出內容中直接顯示所套用的類別名稱 lizely-checkbox。如果目標文件中的 CSS 區塊已定義 .lizely-checkbox 規則,或任何同等或較高特異性的選擇器(例如 form .custom-checkbox),較舊的規則便會勝出,導致複製的程式碼看似沒有作用。重新命名產生的類別,或將其置於更具特異性的選擇器之下,即可解決衝突,而無須重新產生任何內容;該規則已經存在且是正確的。
調整滑桿前先快速診斷輸入值
請使用這份診斷表,將看到的症狀對應至最可能 responsible 的輸入值。這些界限直接取自產生器記載的限制,而非一般 CSS 規則,而且僅適用於此工具內。
| 欄位 | 可接受範圍 | 輸入錯誤時的症狀 |
|---|---|---|
| 方塊尺寸 | 16 至 64 px,僅限整數像素 | 預覽看似空白,或方塊無法顯示 |
| 邊框寬度 | 1 至 6 px | 邊框消失或擴張超過方塊邊緣 |
| 圓角半徑 | 0 至 50% | 方塊維持完全方正,或圓角遭到裁切 |
| 強調色 | 六位數 HEX (#RRGGBB) | 切換時未顯示任何選取狀態色彩 |
| 背景色彩 | 六位數 HEX | 選取填色變成透明或沒有色彩 |
| 勾號色彩 | 六位數 HEX | 繪製的標記融入填色而消失 |
如果其中一列與你看到的情況相符,請先只重設該欄位。一次重設所有內容,會浪費你已經核准的樣式設計工作。
如何透過五個步驟恢復正常產生內容
請依循這個確切順序進行,避免在修正錯誤輸入時失去現有外觀。工具完全在目前的瀏覽器分頁中執行,不需要帳戶、不會上傳內容,也沒有樣式表服務或已儲存的設計狀態,因此隨時重新載入都很安全。
- 在新的瀏覽器分頁中重新開啟 CSS Checkbox Generator。產生與複製作業只會在目前的分頁中進行,也沒有任何內容儲存在伺服器上需要還原。
- 點選欄位、輸入允許的最小整數(尺寸為十六、邊框為一、半徑為零),然後按 Tab 確認,以重設每個數值控制項。欄位層級的驗證器會拒絕其他任何值。
- 使用原生選擇器重新設定每個色塊的顏色,讓數值直接來自瀏覽器內建色彩控制項;正常使用時,它會提供有效的六位數 HEX 值。
- 緩慢拖曳滑桿 through 支援範圍,並在每次放開後觀察即時預覽是否更新。只有當每個欄位皆有效時,輸出才會更新;預覽凍結是重新檢查單一輸入值的訊號,而非軟體故障。
- 分別點選 Copy CSS 與 Copy HTML。每個按鈕都會各自要求剪貼簿權限。若權限遭拒,兩個程式碼區塊仍會顯示,可供手動選取,而不會回報錯誤的成功訊息。
如果完成步驟 four 後預覽有更新,但兩個複製按鈕看似都沒有作用,表示頁面本身並未故障——剪貼簿權限已遭拒絕,或瀏覽器已封鎖目前工作階段的剪貼簿存取。請從頁面上的程式碼區塊手動選取程式碼,將其貼入你的樣式表與表單範本,再從該處繼續執行測試計畫。
看似產生器錯誤的瀏覽器端阻擋因素
有些問題源自瀏覽器,而非產生器。長時間開啟的頁面可能會讓鍵盤焦點停留在某個已不再符合目前狀態的按鈕上,尤其是在瀏覽器擴充功能覆蓋輸入項時尤其如此。點選預覽的空白區域,再點選核取方塊一次,確認選取與未選取狀態仍可切換。點選範例標籤文字的效果完全相同;依照設計,輸入項位於 label 元素內,這也是控制項開箱即用便具備無障礙名稱的原因。
作業系統的強制色彩模式可能會覆蓋目標頁面所選用的調色盤;這是使用者可調整的行為,而非產生器缺陷。產生 CSS 核取方塊時可能發生哪些問題指南會說明影響目標樣式表、而非產生器本身的相關故障模式。
程式碼已產生但外觀錯誤時
複製作業成功,但內容在目標頁面上仍顯示錯誤時,通常是三種外部因素之一所致。目標頁面現有的 CSS 使用了與 .lizely-checkbox 同等或較高特異性的選擇器;頁面上的 box-sizing 重設移除了產生器所包含的 box-sizing: border-box 規則,使所選尺寸無法包含可見邊框;或父層容器具有 overflow: hidden,裁切了 focus-visible 外框。每種問題都能在目標樣式表中修正——提高選擇器特異性、還原尺寸規則,或將溢出限制移至焦點區域下方——而且都不需要重新產生核取方塊。
輸出內容刻意保留原生 input 元素。產生器的 CSS 會使用 appearance: none 隱藏瀏覽器的預設繪製效果,但原生元素仍會提供選取狀態、鍵盤啟用、表單參與及停用行為,前提是周圍的應用程式正確使用這些功能。若將 input 換成 div 來修正樣式不符,就會在單次變更中移除所有上述行為。如果你正在框架中作業,請依框架要求將 class 轉換為 className,並連接 checked 與 onChange,但請保留 input 與 label 的關聯。CSS Checkbox Generator 的輸出是否為原生控制項指南會完整說明此工具保留的所有行為。
讓復原的核取方塊維持無障礙
產生的核取方塊即使可以切換,也不會自動具備無障礙功能。勾號是使用 CSS ::after 虛擬元素繪製,只有在輸入項處於選取狀態時才會算繪;在不尋常的縮放比例或裝置像素比下,記載的抗鋸齒行為可能使標記其中一側看起來稍粗——這是按比例建構邊框所造成的已知效果,並非需要用指令碼繞過的缺陷。請使用鍵盤測試控制項:Tab 應能將焦點移至輸入項、可見的焦點環應出現,而 Space 應能切換選取狀態。:focus-visible 的外框色彩預設會與強調色相符,因此如果該強調色與周圍頁面的對比不足,請分別變更外框,不要將其移除。焦點並未移除,而這點很重要,因為鍵盤使用者需要可見的提示,得知哪個控制項會回應 Space。
發布前,請使用專用檢查工具檢查所選色彩——強調色、背景、勾號與焦點指示器,都必須分別針對周圍頁面進行檢查。產生器不會模擬不確定、無效、必要、停用、唯讀、高對比或強制色彩狀態,因此請自行在目標表單上加入並驗證這些狀態。MDN 記載了此處用來抑制原生算繪的 appearance 屬性,以及它所帶來的相容性考量;該參考資料是此產生器在繪製與行為之間做出所有選擇時,所依據的標準層級基礎。外觀美觀的核取方塊仍然只是起點:將其貼入受控的樣式表、必要時重新命名類別、保留原生語意,並使用真實內容與輔助技術驗證完整表單。