Skip to content

guide binding accessibility pl

alvit edited this page Oct 22, 2026 · 1 revision

Ręczne przypisanie XMLTV i dostępność klawiatury

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

Architektura przewodnika

Naprawa przewodnika kanału bez edycji playlisty

Odtwórz dany kanał M3U, otwórz Information → EPG, a następnie zmień URL źródła EPG i XMLTV ID. Wpisz dokładne ID z <channel id="…"> pliku XMLTV, nie nazwę wyświetlaną. Wybierz Set, aby zapisać przypisanie i przeładować playlistę. Automatic usuwa nadpisanie tego kanału i wczytuje pierwotne mapowanie playlisty. Samo poruszanie się strzałkami nigdy nie zapisuje ani nie resetuje przypisania. Wstecz pozostawia zapisane przypisanie bez zmian.

Edytor jest dostępny we wdrożeniu przeglądarkowym z hostingiem i natywnych powłokach XMLTV (Tauri i Capacitor). Nie nadpisuje przewodników dostawcy, jawnych endpointów JSON =source ani zewnętrznych serwerów towarzyszących. Zwykła starsza przeglądarka korzystająca ze zdalnego serwera towarzyszącego zachowuje dotychczasowy protokół dopasowania. Pierwsza wersja przyjmuje dokładne ID; nie pobiera ani nie wyświetla przeszukiwalnej listy wszystkich kanałów XMLTV.

Ręczne przypisanie łączy źródło playlisty i stabilny kanał z jednym kanałem danych XMLTV oraz dokładnym ID; w przeciwnym razie działa zwykłe dopasowanie.

Przypisanie zapisuje odcisk źródła playlisty, stabilny klucz kanału, jawny URL danych i XMLTV ID. Zmiana etykiety lub kolejności wierszy nie zmienia przypisania, jeśli tożsamość kanału jest stała. Zastąpienie URL/konta playlisty zmienia przestrzeń nazw źródła. Starsze wpisy M3U bez itemId używają istniejącego ID kanału wyprowadzonego z URL; zmiana tego URL zmienia tożsamość.

Wybrany kanał zachowuje nazwę wyświetlaną i URL odtwarzania. Wyszukiwanie przewodnika używa jednego jawnego źródła bez awaryjnego dopasowania po nazwie, więc brak ID nie powoduje cichego przejęcia programu innego kanału. Automatyczne przesunięcia regionalne wywnioskowane z nazwy nie dotyczą tego dokładnego przypisania; jawne tvg-shift playlisty nadal obowiązuje. Ustaw właściwe regionalne XMLTV ID. Jeśli własne źródło HTTPS jest nieczytelne z powodu CORS lub reguł mieszanej zawartości, zwykła diagnostyka EPG zgłasza błąd.

Lokalny rekord ma limit 500 przypisań i 512 KiB na źródło; jest analizowany raz na wczytanie playlisty, nie raz na kanał. Zapisy porównują poprzednią wartość i odczytują zapisany wynik przed przeładowaniem. Spóźnione wywołanie zwrotne edytora nie może zapisać do źródła zastępczego. To lokalna preferencja, nie synchronizacja między urządzeniami. URL źródeł mogą zawierać dane logowania; nie udostępniaj eksportów magazynu publicznie.

Dostępne klasyczne elementy sterowania

  • Wirtualizowana lista główna udostępnia nazwaną listę wyboru, zaznaczoną opcję, pełną liczbę elementów i bezwzględną pozycję. Tylko zaznaczony widoczny wiersz jest przystankiem Tab. Strzałki aktualizują wybór wizualny i stan semantyczny; fokus podąża za już aktywną listą podczas zmiany strony.
  • Standardowe dialogi informacyjne/potwierdzające, edytor i panele About udostępniają role modalne oraz zlokalizowane nazwy. Tab i Shift+Tab krążą wewnątrz modalu na pierwszym planie. Zamknięcie zagnieżdżonego modalu przywraca nadal widoczny nadrzędny element; nieaktualne zaplanowane otwarcia nie mogą ukraść fokusu po zamknięciu.
  • Komunikaty informacyjne i potwierdzające opisują swoje dialogi. Tymczasowe powiadomienia używają regionu stanu z nienarzucającymi się komunikatami.
  • Istniejące katalogi tłumaczeń dostarczają wszystkie dodane etykiety. XMLTV i ID są identyfikatorami protokołu; nazwy kanałów i hostów źródeł pozostają metadanymi źródła.

Aplikacja zachowuje ścieżki pilota i składnię ES5. Semantyczne kontrole DOM nie oznaczają pełnej certyfikacji WCAG: fokus właściwy urządzeniu, mowa VoiceOver/TalkBack i zachowanie przeglądarek TV nadal wymagają testów fizycznych.

Weryfikacja

Uruchom:

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

Na zintegrowanej gałęzi uruchom też zwykłe kontrole kompilacji/ES5/rozmiaru pakietu. Kontrole przeglądarkowe powinny objąć długą listę przekraczającą strony, zagnieżdżone potwierdzenie, zmianę źródła podczas edycji, poprawne, brakujące i usunięte przypisanie oraz błąd pobierania EPG. Semantyczne preferencje ścieżek natywnej aplikacji Android są zaimplementowane w jej oddzielnym repozytorium i niezależne od tych klasycznych elementów sterowania.


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

Clone this wiki locally