acessibilidade

Ensure HTML pages conform to WCAG 2.1 AA accessibility guidelines.

Updated Dec 19, 2025
One-click install
npx skills add https://github.com/afonsolelis/laudo_cards --skill acessibilidade
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: acessibilidade
Source: https://github.com/afonsolelis/laudo_cards/tree/main/.claude/skills/acessibilidade
Command: npx skills add https://github.com/afonsolelis/laudo_cards --skill acessibilidade

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Garante que todas as páginas HTML sigam práticas de acessibilidade WCAG 2.1 AA, tornando o conteúdo utilizável por todos, inclusive leitores de tela.

Core Features & Use Cases

  • Estrutura Semântica: uso correto de tags HTML5 (nav, header, main, section, footer) para navegação clara.
  • Acessibilidade ARIA: rótulos, roles, aria-expanded, aria-controls para componentes interativos.
  • Contraste e Navegação: recomendações de contraste de cores e navegação por teclado, com foco visível.

Quick Start

  • Ao criar uma página, adicione as tags semânticas adequadas (nav, main, section, footer).
  • Garanta alt text em todas as imagens informativas e use ARIA onde necessário.
  • Verifique o contraste de cores e teste a navegação por teclado.

Frequently Asked Questions about acessibilidade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I ensure my HTML pages meet WCAG 2.1 AA accessibility standards?

WCAG 2.1 AA accessibility ensures HTML pages are usable by all users, including those relying on screen readers. Implement semantic HTML5 tags (nav, main, section, footer), add ARIA labels and roles to interactive components, maintain color contrast ratios, and enable keyboard navigation with visible focus indicators.

What HTML semantic tags should I use for accessible page structure?

Semantic tags like nav, header, main, section, and footer create clear document structure that screen readers interpret correctly. Use nav for navigation, main for primary content, section for thematic groupings, and footer for footer content. This structure replaces generic div elements and signals page organization to assistive technologies.

How do I make interactive components like modals and accordions accessible?

Interactive components require ARIA attributes and keyboard support. Use aria-expanded to indicate state, aria-controls to link triggers to targets, and aria-modal for modals. Ensure Tab key navigation works, focus remains visible, and Escape or other keyboard shortcuts function as expected by users of assistive technology.

What color contrast ratio do I need for WCAG 2.1 AA compliance?

WCAG 2.1 AA requires a contrast ratio of at least 4.5:1 for normal text and 3:1 for large text (18pt or 14pt bold and above). Test foreground and background color pairs using contrast checking tools to verify compliance and ensure readability for users with low vision.

When should I add alt text to images, and what makes it effective?

Add alt text to all informative images; decorative images use empty alt attributes (alt=""). Effective alt text describes the image's content and function concisely (under 125 characters), allowing screen reader users to understand its purpose without seeing it visually.

Do I need to test keyboard navigation separately from mouse navigation?

Yes, keyboard navigation testing is essential for WCAG 2.1 AA compliance. Tab through all interactive elements to verify logical focus order, ensure focus is always visible, and confirm all functions accessible by mouse are also reachable via keyboard without keyboard traps.