qa-detect-forced-colors
WCAG 1.4.11 — detects elements that rely solely on background color or images for distinction. Fail Windows High Contrast Mode (forced-colors: active)
SKILL.mdskills/qa-detect-forced-colors/SKILL.md
GitHubWhat it checks
WCAG 1.4.11 (Non-text Contrast): icons and interactive controls must remain distinguishable when Windows High Contrast Mode strips the page's colors. Common failures:
- SVG icons with hardcoded
fill="#XXX"— disappear in forced colors mode - Buttons distinguished only by background-color — become invisible
- Borderless inputs — vanish entirely
- No
@media (forced-colors: active)overrides in stylesheets
Probe (browser_evaluate)
() => {
const sel = el => {
const id = el.id ? `#${el.id}` : '';
return (el.tagName.toLowerCase() + id).slice(0, 120);
};
const bb = el => { const r = el.getBoundingClientRect(); return { x: Math.round(r.left), y: Math.round(r.top), w: Math.round(r.width), h: Math.round(r.height) }; };
const out = [];
// 1. Check whether any forced-colors media query exists
let hasForcedColorsMedia = false;
for (const sheet of document.styleSheets) {
let rules;
try { rules = sheet.cssRules; } catch (_) { continue; }
if (!rules) continue;
const walk = (rs) => {
for (const r of rs) {
if (r.type === CSSRule.MEDIA_RULE) {
if (/forced-colors\s*:\s*active/i.test(r.conditionText || '')) hasForcedColorsMedia = true;
walk(r.cssRules || []);
}
}
};
walk(rules);
}
if (!hasForcedColorsMedia) {
out.push({
issueType: 'noForcedColorsSupport',
severity: 'medium',
selector: 'stylesheet',
description: 'No @media (forced-colors: active) media query in stylesheets — page has not been adapted for Windows High Contrast Mode (WCAG 1.4.11)',
bbox: { x: 0, y: 0, w: 200, h: 60 }
});
}
// 2. Inline SVG icons with hardcoded fill/stroke that aren't CSS-driven
//
// Skip SVGs that are intentionally colored (legend swatches, chart data marks,
// logos, brand glyphs, status indicators) — for those, the color IS the meaning,
// and currentColor would destroy the semantic. False positives from those are
// the noisiest class of this check (see ApexCharts legend marker case).
const isChartOrLegendSvg = (svg) => {
// (a) SVG itself is a chart-library element
const svgCls = (svg.getAttribute('class') || '').toLowerCase();
if (/apexcharts|recharts|highcharts|echarts|chartjs|nvd3|vega|d3-|c3-|amcharts|plotly/.test(svgCls)) return true;
// (b) Any descendant has a chart-library class (covers svg.SvgjsSvg wrappers
// used by ApexCharts which don't put the lib class on the svg root itself)
if (svg.querySelector('[class*="apexcharts"], [class*="recharts"], [class*="highcharts"], [class*="echarts"], [class*="chartjs"], [class*="nvd3"], [class*="amcharts"]')) return true;
// (c) SVG is inside a chart / legend / swatch container
const container = svg.closest(
'[class*="chart"], [class*="Chart"], [class*="graph"], [class*="Graph"], ' +
'[class*="legend"], [class*="Legend"], [class*="swatch"], [class*="Swatch"], ' +
'[class*="series"], [class*="Series"]'
);
if (container) return true;
// (d) SVG is a logo or brand glyph — colors are intentional
const logoContainer = svg.closest('[class*="logo"], [class*="Logo"], [class*="brand"], [class*="Brand"]');
if (logoContainer) return true;
// (e) SVG is a status/health indicator (color carries the semantic)
const statusContainer = svg.closest('[class*="status"], [class*="health"], [class*="indicator"], [class*="badge"], [class*="dot"]');
if (statusContainer && svg.getBoundingClientRect().width < 24) return true;
return false;
};
let svgIconBugs = 0;
// Tighter selector: only `svg[class*="icon"]` OR SVGs that look like UI icons
// (small, standalone, no chart context). The previous selector
// `svg[width]:not([width="0"])` matched EVERY sized SVG including chart series.
for (const svg of document.querySelectorAll('svg[class*="icon"], svg[class*="Icon"], i > svg, button > svg, a > svg')) {
if (svgIconBugs >= 3) break;
const r = svg.getBoundingClientRect();
if (r.width === 0 || r.height === 0 || r.width > 80) continue; // not an icon
if (isChartOrLegendSvg(svg)) continue; // chart/legend/logo — color is intentional
const hardcodedFill = [...svg.querySelectorAll('[fill]:not([fill="currentColor"]):not([fill="none"]):not([fill="transparent"])')].length;
if (hardcodedFill > 0) {
svgIconBugs++;
if (out.length < 12) {
out.push({
issueType: 'svgHardcodedColor',
severity: 'low',
selector: sel(svg),
description: `Icon SVG ${sel(svg)} has ${hardcodedFill} hardcoded fill/stroke values — will disappear in Windows High Contrast Mode. Use fill="currentColor" instead.`,
bbox: bb(svg)
});
}
}
}
// 3. Buttons distinguished only by background-color (no border)
let buttonBgOnlyCount = 0;
for (const btn of document.querySelectorAll('button, [role="button"]')) {
if (buttonBgOnlyCount >= 3) break;
const r = btn.getBoundingClientRect();
if (r.width === 0 || r.height === 0) continue;
const style = getComputedStyle(btn);
const hasNoBorder = style.borderWidth === '0px' || style.borderStyle === 'none';
const bgIsColored = style.backgroundColor && style.backgroundColor !== 'rgba(0, 0, 0, 0)' &&
style.backgroundColor !== 'transparent';
if (hasNoBorder && bgIsColored) {
buttonBgOnlyCount++;
if (out.length < 16) {
out.push({
issueType: 'buttonBorderlessWithBg',
severity: 'low',
selector: sel(btn),
description: `Button ${sel(btn)} is borderless with background ${style.backgroundColor} — in forced-colors mode the background is stripped, button becomes invisible. Add a border or outline.`,
bbox: bb(btn)
});
}
}
}
return out;
}
Issues
| issueType | severity | description |
|---|---|---|
| noForcedColorsSupport | medium | "No @media (forced-colors: active) — WCAG 1.4.11 not addressed" |
| svgHardcodedColor | low | "Icon SVG has hardcoded fill — will disappear in High Contrast Mode" |
| buttonBorderlessWithBg | low | "Borderless button relies on background color only — invisible in forced-colors mode" |