Define comportamento inclusivo, requisitos semânticos, expectativas de tecnologia assistiva e casos comuns de falha para acessibilidade de mídia. Estabelece limites de adoção e evidências observáveis de falha, mantendo os limites específicos do ambiente configuráveis.
Status do pacote: contexto de referência pronto para revisão humana. O contrato e os cenários de teste estão completos, mas não se afirma que uma implementação adotante os tenha aprovado.
Decisão
Para acessibilidade de mídia, adote primeiro a semântica nativa, com um contrato documentado de teclado e foco. Especifique comportamento semântico, de teclado, foco, anúncio, visual, movimento e erro como parte do contrato funcional do componente. Este pacote é um contrato de referência: a equipe adotante deve escolher limites numéricos, provedores, jurisdições e responsáveis operacionais com base em evidências do seu próprio ambiente.
Escopo
- Os atores, entradas, saídas, estados, versões de política ou esquema e resultados visíveis externamente descritos por este bloco de acessibilidade de mídia.
- Interfaces primárias e alternativas, trabalhos em segundo plano, caches, integrações, caminhos de suporte e evidências que podem exercer o mesmo limite.
- Configuração específica de adoção, implantação, recuperação e responsabilidades de verificação necessárias para aplicar a referência com segurança.
Fora deste bloco
- Escolher um fornecedor universal, framework, jurisdição, limite numérico, período de retenção ou objetivo de nível de serviço para todos os adotantes.
- Alegar que cenários empacotados foram executados contra uma implementação a jusante ou que esta referência concede certificação legal, de segurança ou de acessibilidade.
Contrato
- Expor um nome programático, papel, valor, estado e relacionamento sempre que a interface visual os comunicar.
- Toda ação é operável por teclado sem armadilha, e a ordem do foco segue a ordem de leitura e interação.
- Anunciar status assíncrono ou erros sem mover o foco inesperadamente, e associar orientações de recuperação ao controle afetado.
- Preservar conteúdo e operação sob zoom, espaçamento de texto, reflow, cores forçadas, movimento reduzido e escala de texto da plataforma quando aplicável.
- Preferir elementos nativos; quando um widget personalizado for necessário, implemente seu padrão completo de interação esperado em vez de apenas adicionar um papel.
- Testar com múltiplos modos de entrada e pelo menos uma combinação representativa de leitor de tela/navegador definida pela equipe adotante.
- Rastrear legendas, transcrição, descrição de áudio, idioma, sincronização e status de revisão independentemente para cada versão de mídia.
- Controles do player expõem nomes, estado, tempo e operação por teclado, e legendas permanecem utilizáveis sob zoom e modos de tela cheia.
Orientações de implementação
- Escreva a sequência de teclado e foco antes da implementação e revise cópias com rótulos visíveis e nomes programáticos lado a lado.
- Modele entradas, saídas, atores, estados, invariantes, efeitos colaterais e evidências de acessibilidade de mídia antes de selecionar detalhes de framework ou fornecedor.
- Armazene a versão aplicável do contrato ou política de acessibilidade de mídia com o estado material para que migrações, reprodução e decisões de suporte permaneçam atribuíveis.
- Introduza o caminho por trás da implantação controlada, compare resultados esperados e observados, e mantenha uma rota de recuperação testada até que a evidência de adoção esteja completa.
Tratamento de falhas e salvaguardas
- Se semântica ou foco não puderem ser preservados, a interação não é lançada atrás de comportamento apenas visual; o defeito permanece bloqueador de lançamento.
- Estado inválido ou contraditório de acessibilidade de mídia é rejeitado ou colocado em quarentena; a implementação nunca supõe um valor que amplie autoridade ou duplique um efeito.
- Retentativas são limitadas e usam identidade durável; após esgotamento, o trabalho alcança um estado terminal inspecionável com um responsável contabilizável.
Verificação e operações
- Verifique regras automatizadas, operação somente por teclado, visibilidade do foco, anúncios, contraste, zoom e conclusão manual de tarefas.
- Monitore sucesso, negação, falha de validação, falha de dependência, esgotamento de retentativas e recuperação de acessibilidade de mídia por versão do contrato sem dimensões sensíveis de carga útil.
- Reexecute fixtures positivos e negativos pareados após mudanças de política, esquema, dependência, migração ou limite e preserve a evidência resultante.
Suposições de adoção
- Nomes e valores no exemplo são um fixture concreto, não padrões universais; adotantes os substituem por meio de evidência documentada e propriedade.
- O sistema adotante pode fornecer identidade autenticada, versões duráveis de operação ou registro, telemetria limitada e um caminho controlado para mudanças.
Os exemplos com aparência executável neste pacote são fixtures e contratos de aceitação. Execute o validador da coleção para verificar estrutura e metadados, depois traduza e execute os cenários no repositório alvo antes de registrar evidências de implementação.