使用 CSS Checkbox Generator 建立的核取方塊,在強制色彩模式下可能會呈現不同外觀,因為作業系統或瀏覽器可能會以無障礙調色盤取代其自訂色彩。

視覺差異通常是有意設計,而不是 CSS 損壞的證據。強制色彩模式的設計目的,是當作業系統要求使用受限的高對比調色盤時,協助使用者區分控制項與內容。產生的核取方塊仍包含原生 input type="checkbox",但在該模式啟用時,其自訂背景、邊框、核取標記與焦點外框可能會經過調整。

why can the control look different in forced colors mode when using css checkbox generator
強制色彩為何會改變 CSS Checkbox Generator 的輸出

強制色彩模式會改變哪些內容

強制色彩模式會對作者指定的色彩套用由系統控制的調整。視瀏覽器與作業系統而定,這可能會影響背景、文字、邊框、外框,以及用來繪製自訂核取標記的色彩。由於可用的系統調色盤與算繪行為可能因平台而異,因此確切結果在不同平台上並不相同。

此行為與 CSS appearance 屬性無關。Generator 會使用 appearance: none 抑制瀏覽器一般核取方塊的繪製,同時保留原生元素的基礎狀態與行為。MDN 的 appearance 文件說明了該屬性及其相容性考量,而CSS Basic User Interface Level 4 規格則在標準層級定義了 appearance switching。

面向 一般色彩模式 強制色彩模式
色彩來源 依作者設定使用 Generator 選取的強調色、背景、核取標記、邊框與焦點色彩。 作業系統或瀏覽器可能會以受限的無障礙調色盤取代這些色彩。
核取方塊繪製 依產生的 CSS 繪製自訂方框與已選取 pseudo-element。 自訂繪製仍會保留,但經調整的色彩可能會改變其視覺重量與對比。
互動 原生元素提供選取狀態、鍵盤啟用與表單參與功能。 這些原生語意仍會保留;強制調色盤改變的是呈現方式,而非將 input 變成裝飾性元素。
焦點指示 產生的 CSS 包含使用所選強調色的 focus-visible 外框。 該外框可能會經過調整,因此必須在實際頁面上確認其可見性。
Generator 預覽 在預覽中顯示確切的產生樣式表。 不會模擬或認證強制色彩模式下的結果。

重要的區分在於外觀與行為。背景或邊框改變,並不表示核取方塊在選取時停止更新。這表示使用者代理可能透過不同的調色盤呈現該狀態。

產生的控制項為何可能產生差異

自訂繪製取代一般原生外觀

CSS Checkbox Generator 會抑制瀏覽器的預設繪製,並自行建立可見方框。其核取標記是 pseudo-element,僅在 input 已選取時繪製,並使用設定的右側與底部邊框。強制色彩模式可能會介入套用至這些自訂元素的色彩。結果可能具有不同的邊框強調程度、方框與其背景之間較少的分隔,或核取標記的對比與一般主題不同。

控制項不必改變幾何尺寸,也能呈現不同外觀。當瀏覽器以較淺的系統色彩取代深色標記色彩,或將自訂邊框對應至系統色彩時,相同的寬度、高度、半徑與旋轉邊框標記可能會產生不同的視覺效果。因此,一般主題的螢幕截圖並不是可靠的強制色彩測試方式。

預覽並非強制色彩模擬器

即時預覽會在限定範圍的 class 中使用確切的產生樣式表,但 Generator 不會模擬高對比或強制色彩狀態。它也不會模擬未確定、無效、必填、停用或唯讀狀態。如果瀏覽器已在強制調色盤下運作,預覽本身可能會反映系統調整,但 Generator 並未提供獨立控制項來重現或比較該模式。

請使用預覽建立一般已選取、未選取與 focus-visible 的基準線。然後在目標頁面中啟用強制色彩,測試實際表單。

系統覆寫可保護可用性

覆寫作者色彩,可以避免品牌化的核取方塊對於依賴受限調色盤的使用者而言變得難以看見。請勿僅為保留 Generator 中選取的外觀,就加入 forced-color-adjust: none。該宣告可能會抑制有用的系統調整,並產生從未依使用者調色盤檢查過的組合。

如果預設的強制結果不夠清楚,使用 @media (forced-colors: active) 區塊的目標式規則,會比對整個控制項停用調整更安全。這類規則是目標樣式表的手動新增內容,並非 Generator 基準輸出的一部分。

在強制色彩下產生並測試核取方塊

  1. 建立基準樣式。 開啟CSS Checkbox Generator,並設定方形尺寸、邊框寬度、圓角半徑、強調色、背景色與核取標記色彩。尺寸可接受 16 至 64 的整數像素,邊框可接受 1 至 6 的整數像素,半徑可接受 0 至 50 的整數百分比。每種色彩都必須是完整的六位數 HEX 值。Generator 會拒絕格式錯誤的色彩、在需要整數時使用小數,以及超出範圍的幾何尺寸,而不會在未告知的情況下產生誤導性程式碼。切換預覽以檢查未選取與已選取的繪製結果。
  2. 複製兩個同步的輸出。 使用個別的 Copy CSS 與 Copy HTML 動作。每個動作都會分別要求剪貼簿權限,而每則成功訊息都會指出已複製的輸出。如果權限遭拒,兩個程式碼區塊仍可供手動選取。請將範例標籤替換為描述實際表單選項的文字,同時保留可見標籤的關聯。
  3. 整合原生結構。 將 CSS 貼入受控的樣式表,並將 HTML 貼入實際表單。請將元素保留為原生核取方塊,不要以通用 div 取代。產生的 HTML 會將 input 巢狀於可見標籤中,讓文字提供無障礙名稱,並可藉由點選文字切換控制項。如果 class 名稱與既有樣式衝突,請在 CSS 與 HTML 中一致地重新命名。
  4. 在強制色彩下檢查目標頁面。 啟用相關的作業系統或瀏覽器強制色彩設定,並檢查實際頁面。比較未選取方框、已選取標記、標籤、周圍背景與焦點指示。確認已選取狀態可清楚區分、標記保持可見,且可依實際主題找出焦點外框。Generator 的內嵌預覽包含許多可聚焦控制項,因此無法取代在目標表單中檢查焦點順序。
  5. 執行完整的互動測試。 使用 Tab 與 Space 驗證鍵盤焦點與啟用。若表單有使用這些項目,請測試對比、縮放、錯誤呈現與停用狀態。基準產生程式碼不會模擬這些額外狀態,因此請將它們加入實際表單,並使用實際內容進行驗證。也請檢查 hover 處理、表單參與功能,以及任何說明如何使用該選項的指示。

何時應加入強制色彩 CSS 規則

最安全的預設做法是接受系統調整。強制色彩模式之所以存在,是因為使用者可能需要可預測且不受網站品牌色彩影響的調色盤。如果產生的 pseudo-element 變得難以區分,請先找出失效的視覺關係:標記與方框之間、方框與頁面之間、焦點外框與相鄰內容之間,或標籤與其背景之間。

接著如有需要,請在基礎規則之後加入範圍精確的媒體查詢。在該查詢中,請使用適當的系統色彩關鍵字,而不要強制套回原本的 HEX 調色盤。保留既有的 ::after 已選取狀態規則,或刻意調整該規則,使標記維持可見。也請檢視 focus-visible 外框,因為 Generator 起初會讓它與所選強調色相符,而這可能不足以與目標頁面周圍內容形成清楚分隔。

  • 保持原生 input 及其選取狀態完整。
  • 讓已選取與未選取狀態在視覺上明顯不同,且不只依賴色彩。
  • 保留可見的鍵盤焦點指示。
  • 使用受眾所使用的相同作業系統與瀏覽器組合測試規則。
  • 重新檢查一般主題,確認強制色彩例外情況未改變預設行為。

請勿預設加入廣泛的色彩調整例外。如果有充分理由要保留特定非標準色彩,請記錄該決策,並在一般與強制模式下測試其對比。其目的不是不惜代價讓產生的外觀維持不變,而是讓核取方塊保持可理解且可操作。

成功結果應保留哪些特性

成功的強制色彩實作,在一般主題下仍應具有相同的核取方塊行為。請將以下結果作為驗收標準:

  • input 仍是原生核取方塊,並具有有意義且可見的標籤。
  • 點選方塊、點選標籤文字與按下 Space,都會產生相同的選取狀態。
  • 已選取標記在調整後的背景上仍保持可見。
  • 未選取與已選取狀態不依賴單一自訂色彩即可區分。
  • 鍵盤焦點可見,且遵循表單預期的順序。
  • 控制項能正確參與表單,並遵循真正的停用狀態。
  • 當實際表單需要時,應提供錯誤訊息、必填狀態處理與情境說明。

視覺自訂無法取代無障礙測試。Generator 會以原生且具有標籤的控制項為基礎,提供同步的 CSS 與 HTML 起點,而目標頁面則決定結果是否能搭配其實際內容、主題、作業系統設定與輔助科技運作。

區分調色盤變更與語意失敗

強制色彩模式下的外觀不同,本身並不代表產生器發生錯誤。這通常表示瀏覽器或作業系統已刻意調整自訂色彩。較嚴重的問題則屬於功能層面:焦點外框無法看見、勾號無法與背景區分、標籤不再明確指出該選項,或控制項無法再透過鍵盤切換。

產生 CSS 和 HTML,保留原生核取方塊,並在強制色彩模式下測試完成的表單。如果預設的系統處理方式可以使用,就予以保留。如果不可使用,請進行小幅且經過測試的強制色彩調整,而不是完全停用無障礙調色盤。

如果您正在權衡各種選項,為什麼 CSS Cubic Bezier 50% 範例可能與 t = 0.5 不同有詳細說明。

如果您正在權衡各種選項,何時應產生 CSS 切換開關而非手動 CSS有詳細說明。