AI 生成介面常踩無障礙地雷?用自動化工具檢查 WCAG 對比度、鍵盤導覽與 Design Token 合規

用 v0、Lovable 或 Cursor 生成的精美網頁,往往藏著文字對比不足、Tab 鍵卡死與無障礙標籤缺失的地雷。本文提供設計師與前端團隊可直接落地的 WCAG 自動化檢查清單與工具組合。

Share
使用 axe-core 與自動化無障礙檢測工具檢查 AI 生成介面之 WCAG 對比度、鍵盤焦點與 Design Token 合規性的流程圖

叫 AI 工具生一個「極簡科技感深色儀表板」,三秒鐘後出來的畫面往往帥到令人驚艷——直到你真的用鍵盤按 Tab 鍵測試,或把螢幕亮度調低一點,才發現根本看不清字、按鈕也按不到。

生成式 AI 擅長模仿視覺美感,但預設權重裡很少把 WCAG(網頁內容無障礙指南)當成硬性約束。

當團隊開始大量用 AI 產出介面,如果不把無障礙檢查自動化,這些隱藏的可用性與合規地雷很快就會變成客訴與重工成本。

延伸閱讀:DAIR.AI Prompt Engineering Guide 實戰精華:從零掌握提示詞工程與評估思維 延伸閱讀:Zapier MCP 實戰:讓 ChatGPT 與 Claude 直接讀寫 Notion、Slack 與 Google Calendar

使用 axe-core 與自動化無障礙檢測工具檢查 AI 生成介面之 WCAG 對比度、鍵盤焦點與 Design Token 合規性的流程圖
AI 生成的漂亮 UI 常暗藏低對比度與無法用鍵盤操作的無障礙地雷,透過自動化掃描管線可將 WCAG 規範直接鎖進設計系統。 圖片來源:官方來源。
官方發表與操作展示影片。

AI 生成介面最常踩的四個 WCAG 地雷

  1. 為了「高級灰感」犧牲色彩對比度:AI 很愛在淺灰底上放更淺的灰字,或是在漸層按鈕上放白色細字,完全低於 WCAG AA 級要求的 4.5:1(一般文字)與 3:1(大字與圖示)標準。
  2. 用 <div> 假裝 <button>,鍵盤完全無法操作:AI 常為了快速排版點擊事件,直接寫 <div onClick={...}>,導致只用鍵盤導覽或使用螢幕閱讀器的用戶根本無法 Focus 到該按鈕,按 Enter 也沒反應。
  3. 移除 Focus Ring(焦點外框)卻沒給替代樣式:許多 AI 模板會偷懶加上 outline: none,讓鍵盤使用者完全不知道自己現在游標停在哪一個表單欄位。
  4. 自寫 Hex 色碼繞過 Design Token:明明設計系統已經定義好經過驗證的語意化 Token(如 --text-muted),AI 卻常自己硬編碼(Hardcode)一個 #9CA3AF,破壞全站深淺色模式與無障礙一致性。

三層自動化無障礙防線:從 Figma 到 CI/CD 全面攔截

檢查階段 推薦自動化工具 主要攔截問題 適合執行角色
設計稿階段 Figma Stark / Contrast 外掛 色彩對比度不足、字級過小、色盲模擬 UI/UX 設計師
開發與生成階段 axe DevTools / eslint-plugin-jsx-a11y 語意標籤錯誤、缺少 aria-label、div 當按鈕 前端工程師 / AI 代理
上線前驗收階段 Playwright + @axe-core/playwright / Lighthouse 跨頁面 WCAG AA 自動化回歸測試、Tab 鍵盤流 QA / CI/CD 管線

第一道防線:在 Prompt 與 Design Token 源頭鎖死規範

預防勝於事後修補。在讓 Cursor 或 v0 生成元件之前,先把「無障礙底線」寫進團隊的 .cursorrules 或系統提示詞中: - 強制優先使用原生語意化 HTML(如 <button>、<nav>、<dialog>)或已通過無障礙驗證的元件庫(如 Radix UI / shadcn/ui)。 - 嚴禁寫死色碼(Hex/RGB),所有顏色必須引用設計系統中已通過 4.5:1 對比度驗證的 CSS 變數或 Tailwind Token。 - 明確禁止 outline-none 除非同時提供 focus-visible:ring-2。

第二道防線:瀏覽器端一鍵掃描與鍵盤 30 秒快篩

每當 AI 生成出新頁面,先別急著截圖炫耀,花 30 秒做兩件事:第一,打開 Chrome 擴充功能 axe DevTools 或內建的 Lighthouse Accessibility 跑一次掃描,直接列出所有違反 WCAG 2.1 AA 的 DOM 節點;第二,把滑鼠放開,純用 Tab、Shift+Tab、Enter 與 Esc 走完核心表單與彈窗(Modal),確認焦點順序合理且彈窗關閉後焦點有正確退回觸發按鈕。

第三道防線:把 axe-core 接進 E2E 自動化測試

對於會持續迭代的產品,手動掃描一定會漏。只要在現有的 Playwright 自動化測試中引入 @axe-core/playwright,就能在每次開 PR 時自動對關鍵頁面執行無障礙斷言。一旦 AI 改版不小心把對比度改壞或刪掉圖片 alt 屬性,CI 就會直接亮紅燈阻擋合併。

為什麼無障礙合規不只是「做公益」,而是商業剛需?

在歐美市場,ADA 與歐洲無障礙法案(EAA)已經讓許多 SaaS 與電商網站因無障礙不合規吃上高額罰單;而在台灣,金融、醫療與公部門標案也明確要求符合無障礙規範。更實際的是,對比度清楚、鍵盤可順暢操作、語意標籤完整的網站,同時也大幅提升了銀髮族用戶的轉換率與搜尋引擎 SEO 權重。

常見問題(FAQ)

Q1:只要自動化工具(如 Lighthouse / axe)跑出 100 分,就代表完全無障礙了嗎?

不是。自動化工具大約只能抓出 30% 到 50% 的無障礙問題(例如對比度、缺少標籤、ARIA 屬性寫錯)。剩下的像是「Tab 焦點順序是否符合人類邏輯」、「錯誤訊息寫得夠不夠白話」、「圖片 alt 描述有沒有抓到重點」,依然需要設計師或 QA 人工測試確認。

Q2:使用 shadcn/ui 或 Radix UI 就能高枕無憂嗎?

這些底層元件庫已經幫你處理好最難的鍵盤互動(如 Dropdown、Dialog 的焦點鎖定與 Esc 關閉),能省下大量工時。但如果你後續用 AI 亂改它的 Tailwind 配色,或是忘了幫只有圖示的按鈕(Icon Button)加上 aria-label,一樣會違規。

Q3:WCAG 2.1 AA 級跟 AAA 級,一般商業產品該選哪一個?

絕大多數商業 SaaS、電商與內容網站以 WCAG 2.1 / 2.2 AA 級 作為標準(一般文字對比度至少 4.5:1),這是在視覺美感與可讀性之間最平衡的業界共識;AAA 級(7:1)通常用於政府機構、醫療或特定高齡輔助服務。

Q4:已經有很多歷史頁面來不及重寫,該從哪裡開始改善?

從「高流量、高轉換的核心漏斗」開始,例如:註冊登入頁、結帳表單、導覽列選單與主要搜尋框。先把這幾個頁面的色彩 Token 與鍵盤流修好,往往就能解決 80% 的實際使用障礙。

結語:真正的專業,是連「看不見的細節」都經得起檢驗

AI 讓每個人都能做出「看起來很美」的畫面,但真正區分業餘玩家與專業產品團隊的,是系統在各種光線、螢幕尺寸與操作方式下依然穩固可靠。把 WCAG 自動化檢查裝進你的工作流,你的設計系統才算真正成熟。

歡迎免費訂閱 AI 郵報,每週追蹤更多產品經理(PM)與 UI/UX 設計師的 AI 轉型實戰。

Read more