AgentSkillsCN

accessibility

WCAG验证的无障碍工具。在处理颜色、对比度或UI组件时使用此功能。

SKILL.md
--- frontmatter
name: accessibility
description: Tilgjengelighetsverktøy for WCAG-validering. Bruk ved arbeid med farger, kontrast eller UI-komponenter.
allowed-tools: Bash

Tilgjengelighet (Accessibility)

WCAG AA Krav

TypeMinimum kontrast
Normal tekst4.5:1
Stor tekst (18pt+ / 14pt bold)3:1
UI-komponenter3:1

Tilgjengelig verktøy

ScriptFormålNår bruke
check-contrast.mjsWCAG fargekontrast-sjekkEtter fargeendringer, før release

Kjøre kontrastsjekk

bash
node scripts/check-contrast.mjs

Hva testes

Scriptet sjekker ~50 fargekombinasjoner i dark mode:

KategoriEksempler
AlertsInfo, Success, Warning, Danger tekst på bakgrunn
BadgesDefault, Info, Success, Warning, Danger, Neutral
TagsNeutral, Info, Warning, Frist
Table RowsTE og BH rader
Modal BoxesGule, røde, blå bokser
TimelineGrunnlag, Vederlag, Frist badges
BordersFarget border på bakgrunner
Main TextBody tekst på mørke bakgrunner
Status TextError, Success, Info, Warning
Progress BarsFargede barer på subtil bakgrunn

Tolke output

Per kombinasjon

code
✅ PASS Alert Info: text on bg
       FG: #1a3a5a
       BG: rgba(180, 210, 255, 0.85) → #b8d4f7
       Ratio: 7.23:1 (Required: 4.5:1)

Kategori-oppsummering

code
SUMMARY BY CATEGORY
================================================================================
✅ Alerts: 4/4 passed
✅ Badges: 6/6 passed
❌ Tags: 3/4 passed

Ved feil - forslag til fiks

code
SUGGESTED FIXES

Tag Warning: text on bg:
  Current: #3a3020 on #f0e0a0 = 3.92:1
  Background luminance: 0.7234 (LIGHT)
  Foreground luminance: 0.0312
  Foreground needs luminance <= 0.0234
  → DARKEN the text color

Når kjøre

SituasjonAnbefaling
Endret farger i src/index.cssKjør kontrastsjekk
Ny UI-komponent med fargerLegg til i scriptet, kjør sjekk
Før releaseVerifiser alle kombinasjoner passerer

Legge til nye fargekombinasjoner

Rediger scripts/check-contrast.mjs:

  1. Legg til farger i darkColors-objektet
  2. Legg til kombinasjoner i combinations-arrayet:
javascript
{
  name: 'My Component: text on bg',
  fg: 'my-text-color',      // Nøkkel i darkColors
  bg: 'my-bg-color',        // Nøkkel i darkColors
  type: 'normal',           // 'normal' (4.5:1) eller 'ui' (3:1)
  category: 'My Category'   // For gruppering i output
}

Kjente begrensninger

  • Kun dark mode farger er definert i scriptet
  • Semi-transparente farger blandes med #1a1a2e (bg-default)
  • Scriptet må oppdateres manuelt når CSS-variabler endres