Communitygithub.com

SamuelChien/mega-skills-collection

Padrões de acessibilidade web para conformidade com WCAG 2.2, incluindo ARIA, navegação por teclado, leitores de tela e testes

O que é mega-skills-collection?

Esta skill oferece uma coleção abrangente de padrões de acessibilidade para desenvolvimento web, focada na conformidade com as diretrizes WCAG 2.2. Ela abrange desde HTML semântico e padrões ARIA complexos até navegação por teclado e acessibilidade em formulários. Além disso, fornece exemplos práticos de código (HTML, TSX e CSS) que demonstram como implementar landmarks, diálogos modais, tabs, validação de formulários e contraste de cores. Inclui também uma lista de antipadrões comuns e um checklist de verificação para garantir que os componentes estejam acessíveis a leitores de tela, navegação por teclado e outros dispositivos assistivos. É útil para desenvolvedores front-end, designers de interface e engenheiros de QA que buscam integrar acessibilidade de forma consistente em seus projetos web.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/accessibility-wcag

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Acessibilidade & WCAG

HTML Semântico

<!-- Use elementos semânticos em vez de divs genéricos -->
<header>
  <nav aria-label="Navegação principal">
    <ul>
      <li><a href="/" aria-current="page">Início</a></li>
      <li><a href="/produtos">Produtos</a></li>
      <li><a href="/sobre">Sobre</a></li>
    </ul>
  </nav>
</header>

<main>
  <article>
    <h1>Detalhes do Produto</h1>
    <section aria-labelledby="especificacoes-titulo">
      <h2 id="especificacoes-titulo">Especificações</h2>
      <dl>
        <dt>Peso</dt>
        <dd>1.2 kg</dd>
        <dt>Dimensões</dt>
        <dd>30 x 20 x 10 cm</dd>
      </dl>
    </section>
  </article>
</main>

<footer>
  <p>&copy; 2024 Nome da Empresa</p>
</footer>

Use <nav>, <main>, <article>, <section>, <aside> em vez de <div> para landmarks. Os leitores de tela utilizam esses elementos para navegar pela página.

Padrões ARIA

function Modal({ isOpen, onClose, title, children }) {
  if (!isOpen) return null;

  return (
    <div
      role="dialog"
      aria-modal="true"
      aria-labelledby="modal-titulo"
      onKeyDown={(e) => e.key === "Escape" && onClose()}
    >
      <h2 id="modal-titulo">{title}</h2>
      <div>{children}</div>
      <button onClick={onClose} aria-label="Fechar diálogo">
        <XIcon aria-hidden="true" />
      </button>
    </div>
  );
}

function Abas({ tabs, activeIndex, onChange }) {
  return (
    <div>
      <div role="tablist" aria-label="Seções de configurações">
        {tabs.map((tab, i) => (
          <button
            key={tab.id}
            role="tab"
            id={`aba-${tab.id}`}
            aria-selected={i === activeIndex}
            aria-controls={`painel-${tab.id}`}
            tabIndex={i === activeIndex ? 0 : -1}
            onClick={() => onChange(i)}
            onKeyDown={(e) => handleArrowKeys(e, i, tabs.length, onChange)}
          >
            {tab.label}
          </button>
        ))}
      </div>
      {tabs.map((tab, i) => (
        <div
          key={tab.id}
          role="tabpanel"
          id={`painel-${tab.id}`}
          aria-labelledby={`aba-${tab.id}`}
          hidden={i !== activeIndex}
          tabIndex={0}
        >
          {tab.content}
        </div>
      ))}
    </div>
  );
}

Navegação por Teclado

function handleArrowKeys(
  event: React.KeyboardEvent,
  currentIndex: number,
  totalItems: number,
  onSelect: (index: number) => void
) {
  let newIndex = currentIndex;

  switch (event.key) {
    case "ArrowRight":
    case "ArrowDown":
      newIndex = (currentIndex + 1) % totalItems;
      break;
    case "ArrowLeft":
    case "ArrowUp":
      newIndex = (currentIndex - 1 + totalItems) % totalItems;
      break;
    case "Home":
      newIndex = 0;
      break;
    case "End":
      newIndex = totalItems - 1;
      break;
    default:
      return;
  }

  event.preventDefault();
  onSelect(newIndex);
}

Todos os elementos interativos devem ser alcançáveis via teclado. Use Tab para navegação por foco, Enter/Barra de espaço para ativação e teclas de seta para navegação dentro de componentes.

Acessibilidade em Formulários

function FormularioCadastro() {
  return (
    <form aria-labelledby="titulo-formulario" noValidate>
      <h2 id="titulo-formulario">Criar Conta</h2>

      <div>
        <label htmlFor="email">Endereço de e-mail</label>
        <input
          id="email"
          type="email"
          required
          aria-required="true"
          aria-describedby="dica-email erro-email"
          aria-invalid={temErro ? "true" : undefined}
        />
        <p id="dica-email">Nunca compartilharemos seu e-mail.</p>
        {temErro && (
          <p id="erro-email" role="alert">
            Informe um endereço de e-mail válido.
          </p>
        )}
      </div>

      <button type="submit">Criar Conta</button>
    </form>
  );
}

Cor e Contraste

:root {
  --text-primary: #1a1a1a;      /* 15.3:1 sobre branco */
  --text-secondary: #595959;    /* 7.0:1 sobre branco */
  --text-on-primary: #ffffff;   /* Garantir 4.5:1 na cor da marca */
  --border-focus: #0066cc;      /* Anel de foco visível */
}

*:focus-visible {
  outline: 3px solid var(--border-focus);
  outline-offset: 2px;
}

.mensagem-erro {
  color: #d32f2f;
  /* Não confie apenas na cor - adicione ícone ou prefixo de texto */
}
.mensagem-erro::before {
  content: "Erro: ";
  font-weight: bold;
}

WCAG AA exige contraste de 4.5:1 para texto normal, 3:1 para texto grande (18px negrito ou 24px normal).

Antipadrões

  • Usar div e span para elementos clicáveis em vez de button ou a
  • Remover contornos de foco sem fornecer um indicador alternativo
  • Confiar apenas na cor para transmitir informações (vermelho para erro, verde para sucesso)
  • Usar aria-label quando o texto visível já rotula o elemento
  • Reproduzir mídia automaticamente sem um mecanismo de pausa
  • Falta do link de navegação de pular para usuários de teclado

Checklist

  • Todos os elementos interativos acessíveis por teclado (Tab, Enter, Escape, Setas)
  • Landmarks de HTML semântico usados (nav, main, article, section)
  • Imagens possuem texto alt descritivo (ou alt="" para decorativas)
  • Contraste de cores atende WCAG AA (4.5:1 texto normal, 3:1 texto grande)
  • Indicadores de foco visíveis em todos os elementos interativos
  • Campos de formulário possuem elementos <label> associados
  • Mensagens de erro anunciadas para leitores de tela via role="alert"
  • Página testada com leitor de tela (VoiceOver, NVDA) e apenas teclado

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Create forensically sound bit-for-bit disk images using dd and dcfldd while preserving evidence integrity through hash verification.

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

Habilidades Relacionadas