Skip to content

guide binding accessibility it

alvit edited this page Oct 22, 2026 · 1 revision

Associazione XMLTV manuale e accessibilità da tastiera

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

Architettura della guida

Correggere la guida di un canale senza modificare la playlist

Riprodurre il canale M3U interessato, aprire Information → EPG, quindi modificare l'URL della sorgente EPG e l'XMLTV ID. Inserire l'ID esatto di <channel id="…"> nel file XMLTV, non il nome visualizzato. Scegliere Set per salvare l'associazione e ricaricare la playlist. Automatic rimuove la sostituzione per quel canale e ricarica l'associazione originale. Muoversi con le frecce da solo non salva né azzera mai un'associazione. Indietro lascia invariata l'associazione salvata.

L'editor è disponibile nella distribuzione browser ospitata e nei contenitori XMLTV nativi (Tauri e Capacitor). Non sostituisce guide del fornitore, endpoint JSON espliciti =source o server di supporto esterni. Un normale browser legacy che usa un server di supporto remoto mantiene il suo protocollo di corrispondenza esistente. La prima versione accetta un ID esatto; non scarica né mostra un elenco ricercabile di tutti i canali XMLTV.

Un'associazione manuale collega la sorgente della playlist e il canale stabile a un feed XMLTV e a un ID esatto; altrimenti resta attiva la corrispondenza normale.

Un'associazione conserva l'impronta della sorgente della playlist, la chiave stabile del canale, l'URL esplicito del feed e l'ID XMLTV. Rinominare un'etichetta o cambiare l'ordine delle righe non modifica l'associazione se l'identità del canale resta uguale. Sostituire URL/account della playlist cambia lo spazio dei nomi della sorgente. Per voci M3U legacy senza itemId si usa l'ID esistente derivato dall'URL; cambiare quell'URL cambia l'identità.

Il canale selezionato mantiene nome visualizzato e URL di riproduzione. La ricerca nella guida usa un solo feed esplicito senza ripiego sul nome: un ID mancante non prende quindi silenziosamente i programmi di un altro canale. Gli scostamenti regionali automatici dedotti dal nome non si applicano a questa associazione esatta; il tvg-shift esplicito della playlist resta valido. Impostare l'ID XMLTV regionale corretto. Se un feed HTTPS personalizzato non è leggibile per CORS o regole sui contenuti misti, la normale diagnostica EPG segnala l'errore.

Il record locale è limitato a 500 associazioni e 512 KiB per sorgente; viene analizzato una volta per caricamento della playlist, non per canale. Le scritture confrontano il valore precedente e rileggono il risultato memorizzato prima di ricaricare. Un callback tardivo dell'editor non può salvare in una sorgente sostitutiva. È una preferenza locale, non una sincronizzazione tra dispositivi. Gli URL dei feed possono contenere credenziali: evitare di pubblicare esportazioni dell'archivio.

Controlli classici accessibili

  • L'elenco principale virtualizzato espone una listbox con nome, l'opzione selezionata, il conteggio totale degli elementi e la posizione assoluta. Solo la riga visibile selezionata è una fermata di Tab. Le frecce aggiornano selezione visiva e stato semantico; il focus segue un elenco già focalizzato al cambio pagina.
  • I normali dialoghi informativi/di conferma, l'editor e i pannelli About espongono ruoli modali e nomi localizzati. Tab e Maiusc+Tab scorrono nel modale in primo piano. Chiudere un modale annidato ripristina un controllo padre ancora visibile; aperture pianificate obsolete non possono rubare il focus dopo la chiusura.
  • I messaggi informativi e di conferma descrivono i loro dialoghi. Gli avvisi temporanei usano una regione di stato con annunci non invasivi.
  • I cataloghi di traduzione esistenti forniscono tutte le etichette aggiunte. XMLTV e ID sono identificatori di protocollo; nomi dei canali e host dei feed restano metadati della sorgente.

L'applicazione mantiene i percorsi del telecomando e la sintassi ES5. Le verifiche semantiche del DOM non costituiscono una certificazione WCAG completa: focus specifico del dispositivo, voce VoiceOver/TalkBack e comportamento dei browser TV richiedono ancora prove fisiche.

Verifica

Eseguire:

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

Eseguire anche le normali verifiche di build/ES5/dimensione del bundle sul ramo integrato. I test browser devono coprire un elenco lungo attraverso più pagine, una conferma annidata, la sostituzione della sorgente durante la modifica, un'associazione corretta, mancante e rimossa, e un errore di download EPG. Le preferenze semantiche delle tracce dell'applicazione Android nativa sono implementate nel suo repository separato e sono indipendenti da questi controlli classici.


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

Clone this wiki locally