Skip to content

guide binding accessibility pt

alvit edited this page Oct 22, 2026 · 1 revision

Associação manual de XMLTV e acessibilidade por teclado

English · العربية · বাংলা · Čeština · Deutsch · Español · فارسی · Français
עברית · हिन्दी · Bahasa Indonesia · Italiano · 日本語 · 한국어 · Nederlands · Polski
Português · Русский · ไทย · Türkçe · Українська · Tiếng Việt · 简体中文 · 繁體中文

Arquitetura do guia

Corrigir o guia de um canal sem editar a lista

Reproduza o canal M3U afetado, abra Information → EPG e edite o URL da fonte EPG e o XMLTV ID. Introduza o ID exato de <channel id="…"> no ficheiro XMLTV, não o nome apresentado. Escolha Set para guardar a associação e recarregar a lista. Automatic remove a substituição deste canal e recarrega o mapeamento original da lista. Mover-se apenas com as setas nunca guarda nem repõe uma associação. Voltar deixa a associação guardada inalterada.

Este editor está disponível no alojamento para navegador e nos invólucros XMLTV nativos (Tauri e Capacitor). Não substitui guias do fornecedor, endpoints JSON explícitos =source ou servidores auxiliares externos. Um navegador antigo simples com um auxiliar remoto mantém o protocolo de correspondência existente. A primeira versão aceita um ID exato; não descarrega nem apresenta uma lista pesquisável de todos os canais XMLTV.

Uma associação manual liga a fonte da lista e o canal estável a um feed XMLTV e a um ID exato; caso contrário, mantém-se a correspondência normal.

A associação guarda a impressão digital da fonte da lista, a chave estável do canal, o URL explícito do feed e o ID XMLTV. Mudar um nome apresentado ou a ordem das linhas não altera a associação se a identidade do canal continuar igual. Substituir o URL/conta da lista muda o espaço de nomes da fonte. Para entradas M3U antigas sem itemId, usa-se o ID existente derivado do URL; mudar esse URL muda a identidade.

O canal selecionado mantém o nome apresentado e o URL de reprodução. A pesquisa do guia usa um único feed explícito sem recurso ao nome; assim, um ID em falta não toma silenciosamente a programação de outro canal. Desfasamentos regionais automáticos inferidos do nome não se aplicam a esta associação exata; o tvg-shift explícito da lista continua a aplicar-se. Defina o ID XMLTV regional correto. Se um feed HTTPS personalizado não puder ser lido devido a CORS ou conteúdo misto, o diagnóstico EPG normal comunica a falha.

O registo local está limitado a 500 associações e 512 KiB por fonte; é analisado uma vez por carregamento da lista, não por canal. As escritas comparam o valor anterior e releem o resultado guardado antes de recarregar. Um callback tardio do editor não pode guardar numa fonte que substituiu a original. É uma preferência local, não sincronização entre dispositivos. Os URLs dos feeds podem conter credenciais; evite partilhar exportações do armazenamento publicamente.

Controlos clássicos acessíveis

  • A lista principal virtualizada expõe uma caixa de lista com nome, a opção selecionada, o total de itens e a posição absoluta. Só a linha visível selecionada é uma paragem de Tab. As setas atualizam a seleção visual e o estado semântico; o foco acompanha uma lista já focada ao mudar de página.
  • Os diálogos normais de informação/confirmação, o editor e os painéis About expõem papéis modais e nomes localizados. Tab e Shift+Tab circulam no modal em primeiro plano. Fechar um modal aninhado repõe um controlo pai ainda visível; aberturas agendadas desatualizadas não roubam o foco depois do fecho.
  • As mensagens de informação e confirmação descrevem os seus diálogos. Avisos temporários usam uma região de estado com anúncios não intrusivos.
  • Os catálogos de tradução existentes fornecem todas as novas etiquetas. XMLTV e ID são identificadores do protocolo; nomes dos canais e hosts dos feeds continuam a ser metadados da fonte.

A aplicação mantém os percursos do comando e a sintaxe ES5. Verificações semânticas do DOM não constituem certificação WCAG completa: foco específico do dispositivo, voz VoiceOver/TalkBack e comportamento de navegadores de TV ainda exigem testes físicos.

Verificação

Execute:

node tests/test_classic_accessibility.cjs
node tests/test_guide_bindings.cjs
node tests/test_screen_ownership.cjs
node tests/test_guide_integration.cjs
node tests/test_m3u_provider_driver.cjs
node tests/test_localization_catalog.cjs
npm run typecheck

Execute também as verificações normais de compilação/ES5/tamanho do bundle no ramo integrado. Os testes do navegador devem cobrir uma lista longa entre páginas, confirmação aninhada, substituição da fonte durante a edição, associações corretas, em falta e removidas, e falha ao descarregar EPG. As preferências semânticas de faixas da aplicação Android nativa são implementadas no seu repositório separado e são independentes destes controlos clássicos.


Source revision: f51bac7a. This documentation may describe changes awaiting release; use the matching build.

Clone this wiki locally