Język części treści

Co oznacza to kryterium

Oznacz język fragmentu, który jest w innym języku niż jego otoczenie, żeby oprogramowanie mogło dobrać sposób odczytu. Właściwy język może być dziedziczony po rodzicu. Wymaganie obejmuje również pojedyncze słowo celowo użyte w obcym języku, z czterema wyjątkami opisanymi dalej. Nie nakazuje tłumaczenia treści.

Potrzeby opisują bariery w tym przykładzie, a nie normatywną klasyfikację osób.

Nie przypisujemy automatycznie motoryki, rozróżniania barw ani słuchu. W napisach identyfikacja zmiany języka może pomagać rozpoznać język ścieżki; w tej demonstracji nie ma multimediów i nie badano napisów. Powiększenie nie jest przedmiotem tej próby.

Przykłady błędów i poprawek

Pracownia pokazuje syntetyczne zamówienie P-104 przy ul. Ogrodowej 8. Użytkownik czyta „Please bring your order number.” i uruchamia „Pokaż instrukcję: Collect your order”. Każdy wariant wyświetla ten sam polski komunikat z P-104. Good i bad mają identyczne teksty, wygląd, dane i funkcję; różnią się metadanymi języka.

Problem: w bad angielska instrukcja dziedziczy pl, a angielska część nazwy przycisku nie ma języka zakresu. Odbiornik nie otrzymuje właściwej informacji o zmianie języka. Poprawka: oznacz całą instrukcję jako en, a w mieszanej etykiecie przypisz en wyłącznie angielskiej części, pozostawiając polski prefiks jako pl. Tłumaczenie instrukcji nie jest poprawką omawianego błędu metadanych.

Nieznana para wraca do good. Zwykłe przyciski wykonują pełny cykl good → bad → control → good i reset. Control potwierdza prawidłowe dziedziczenie, a nazwa Pracownia i termin PDF służą kontroli wyjątków.

Kiedy obowiązuje i gdzie są wyjątki

Normatywne wymaganie obejmuje język każdego fragmentu i zwrotu. Programowe określenie oznacza dane autora, które oprogramowanie i technologie asystujące mogą wydobyć i przedstawić w różnych modalnościach. Widoczny podpis „po angielsku” pomaga człowiekowi, lecz sam nie zastępuje metadanych języka.

Wyjątki dotyczą nazw własnych, terminów technicznych, słów o nieustalonym języku i słów lub zwrotów należących już do języka bezpośredniego otoczenia. Pracownia jako nazwa punktu i PDF jako termin techniczny nie wymagają wymuszenia obcego języka. Pojedynczy wyraz nie jest automatycznie zwolniony: „Hello” przy podpisie „Angielskie powitanie” wskazuje celową zmianę. Zapożyczenie oceniać w jego konkretnym otoczeniu, nie tylko według etymologii.

Domyślny język strony lub programu jest tematem 3.1.1. Poprawne dziedziczenie może zapewnić język części treści, jeżeli odpowiada jej rzeczywistemu językowi. W tej parze domyślny pl jest poprawny w obu wersjach; błąd dotyczy wyłącznie angielskich fragmentów. Region nie jest obowiązkowy, jeśli podstawowy tag wystarcza do identyfikacji języka; nie używać nieprawidłowych tagów jako poprawki.

H58 jest pomocniczą techniką dla HTML: ustalić język treści z uwzględnieniem dziedziczenia, sprawdzić tag według BCP 47 i dopasowanie do tekstu. PDF19 jest techniką dla tagged PDF: zakres /Lang ma obejmować właściwy fragment; trzeba zachować kolejność i zweryfikować odczyt ustawień i dostępności. Żadna technika nie jest jedynym obowiązkowym sposobem spełnienia SC. W pełnym Understanding nie wskazano osobnej techniki F dla tego kryterium; opisane niżej błędy są własnymi odtworzeniami, bez nadawania im wymyślonych numerów F.

Język, nazwa dostępna i wymowa

W niektórych trybach AT nazwa dostępna jest płaskim tekstem. Lista linków może zgubić wewnętrzne języki nawet przy prawidłowym lang w dziecku linku. Taka granica narzędzia nie oznacza automatycznie błędu autora: ocena musi sprawdzić markup i sposób oznaczenia zmiany, a nie wyłącznie dźwięk. Przeniesienie lang na cały element może pomagać w prostym przypadku jednego języka; przy mieszanej etykiecie nie wolno przez to oznaczyć polskiego prefiksu jako angielskiego.

Odwrotnie, poprawnie brzmiący głos może zgadnąć język i nie dowodzi metadanych. W natywnym środowisku ustawione Locale nie dowodzi programowego określenia bez dostępnego dla AT mostu. Odczyt accessibilityLanguage i accessibilitySpeechLanguage potwierdza określone właściwości UIKit, lecz nie potwierdza rzeczywistego odsłuchu VoiceOver, wyboru głosu ani wszystkich trybów użytkownika.

Platformy

Warunek demonstracji: świadomie użyta angielska instrukcja w polskim otoczeniu. Stan „dotyczy warunkowo” opisuje warunek treści i wyjątków; NOT-RUN opisuje wykonanie, nie wyłączenie platformy. Ocena zastosowania: AI, 2026-10-04; przegląd człowieka NOT-RUN. Nie oceniano podstawy prawnej ani EN 301 549; nie przenosimy jej wyłączeń do WCAG2ICT.

W hybrydzie część webową i natywną oceniać osobno. Nawet jeśli środowisko nie potrafi przekazać języka fragmentu do AT, nie jest to nowy wyjątek od SC. WCAG2ICT jest wskazówką interpretacyjną, nie normą ustanawiającą obowiązki prawne.

Rozwiązania w technologiach

Wszystkie zakresy stringów trzeba wyliczać ponownie po lokalizacji; nie kopiować indeksów z jednego tłumaczenia. Odróżniać język renderowania od języka semantyki. Poniższe fragmenty są edukacyjne; statusy dotyczą dokładnie podanego wykonania.

import 'package:flutter/cupertino.dart';
import 'package:flutter/semantics.dart';

Widget instruction(VoidCallback open) {
  const prefix = 'Pokaż instrukcję: ';
  const phrase = 'Collect your order';
  const label = '$prefix$phrase';
  return Semantics(
    localeForSubtree: const Locale('pl'),
    attributedLabel: AttributedString(label, attributes: [
      LocaleStringAttribute(
        range: TextRange(start: prefix.length, end: label.length),
        locale: const Locale('en'),
      ),
    ]),
    button: true, onTap: open, excludeSemantics: true,
    child: CupertinoButton(onPressed: open, child: const Text(label)),
  );
}

import SwiftUI
import UIKit

struct MixedInstruction: UIViewRepresentable {
    func makeUIView(context: Context) -> UILabel {
        let view = UILabel()
        view.numberOfLines = 0
        view.isAccessibilityElement = true
        return view
    }
    func updateUIView(_ view: UILabel, context: Context) {
        let text = "Pokaż instrukcję: Collect your order"
        let attributed = NSMutableAttributedString(string: text)
        let range = (text as NSString).range(of: "Collect your order")
        guard range.location != NSNotFound else { return }
        attributed.addAttribute(.accessibilitySpeechLanguage,
                                value: "en", range: range)
        view.text = text
        view.accessibilityLanguage = "pl"
        view.accessibilityAttributedLabel = attributed
    }
}

import android.text.SpannableString
import android.text.Spanned
import android.text.style.LocaleSpan
import android.widget.TextView
import androidx.compose.runtime.Composable
import androidx.compose.ui.viewinterop.AndroidView
import java.util.Locale

@Composable
fun MixedInstruction() {
    AndroidView(factory = { TextView(it) }, update = { view ->
        val prefix = "Pokaż instrukcję: "
        val text = SpannableString(prefix + "Collect your order")
        text.setSpan(LocaleSpan(Locale("pl")), 0, prefix.length,
                     Spanned.SPAN_EXCLUSIVE_EXCLUSIVE)
        text.setSpan(LocaleSpan(Locale.ENGLISH), prefix.length, text.length,
                     Spanned.SPAN_EXCLUSIVE_EXCLUSIVE)
        view.text = text
    })
}

import React from 'react';
import { Text } from 'react-native';

export function EnglishInstruction() {
  return (
    <Text accessible={true} accessibilityLanguage="en">
      Please bring your order number.
    </Text>
  );
}

<html lang="pl">
  <body>
    <p lang="en">Please bring your order number.</p>
    <button>Pokaż instrukcję: <span lang="en">Collect your order</span></button>
    <p>Angielskie powitanie: <span lang="en">Hello</span>.</p>
    <div lang="en"><p>Please bring your order number.</p></div>
  </body>
</html>

Jak sprawdzić

1. Ustal domyślny język i znajdź rzeczywiście odmienne fragmenty, również pojedyncze słowa, nazwy kontrolek, wartości, wskazówki i treść dodawaną po działaniu. Oceń wyjątki w kontekście.
2. Sprawdź dane autora: HTML i dziedziczenie w rzeczywistym DOM albo metadane dokumentu/oprogramowania przekazane do wspieranego API. Nie oceniaj języka przez sam wygląd, font, CSS lub wybrane locale zasobów.
3. Dla tej demonstracji uruchom nieznaną parę /3-1-2/unknown/bad i oczekuj fallback good. Odczytaj UIKit, uruchom instrukcję, reset, cykl do bad i control, ponownie akcję i reset. WWW: ?variant=unknown; bad otwórz Enter, pozostałe przyciski kliknij.
4. Porównaj tę samą treść: good/control mają en przy instrukcji i angielski zakres mieszanej nazwy; bad ma tylko pl i brak angielskiego run. Kontrola dziedziczenia nie wymaga osobnej deklaracji dziecka. Wyjątki pozostają polskie. Zapisz stan przed asercjami.
5. W osobnej próbie wspieranego AT z głosami PL/EN sprawdź zwykły odczyt, fokus przycisku i listę linków. Gdy wymowa nie odpowiada markup, odróżnij ograniczenie AT od błędu autora. Ta próba pozostaje NOT-RUN; żadnego syntetycznego głosu nie przedstawiono jako VoiceOver.

Wyniki źródłowych prób

Próby 2026-10-04: Flutter 3.44.9 / Dart 3.12.2, Xcode 27.0 / SDK 27.0, iPhone 17 Simulator / iOS 26.5. Ramka 402 × 874 pt, PNG 1206 × 2622 px. WWW: Codex/macOS, 1280 × 720 CSS px / DPR 1; wersji silnika nie ustalono. Rzeczywiste wyniki dotyczą tej demonstracji i nie potwierdzają wszystkich odbiorników.

Zachowane nieudane próby: pierwsza analiza FAIL na const Semantics, ponieważ konstruktor nie jest const. Po usunięciu const analiza końcowa PASS. XCTest v1 FAIL oczekiwał offsetu 17 zamiast rzeczywistych 18 jednostek UTF-16 polskiego prefiksu. Surowy odczyt już zawierał prawidłowy tekst i run en. V2 obliczał NSString.range(of:) z rzeczywistej etykiety; zmiana dotyczyła markeru i drivera, bez zmiany produktu lub buildu aplikacji po v1.

Przygotowawczy odczyt WWW również FAIL: readonly scope nie udostępniał navigator.userAgent. Nie było akcji ani zapisu medium. Observer ograniczono do dostępnego DOM, a kolejne odczyty zapisano przed oceną. Nie zgadywano wersji silnika. Oczekiwania good/bad znajdują się w asercjach, a nie w surowych danych.

Weryfikacja i ograniczenia

ACT de46e4: zatwierdzona reguła, wersja 2023-12-20. Bada niepuste lang w HTML body flat tree, z niepustym tekstem dziedziczącym język, widocznym lub obecnym w AX; uwzględnia także dostępny tekst. Sprawdza znany główny tag, nie pełną składnię BCP 47 ani dopasowanie do faktycznego języka. en-US-GB może przejść dzięki znanemu en, mimo błędnej składni regionów. Brak lang i empty są poza zakresem, a treść nadal może naruszać SC. PASS albo inapplicable wymagają dalszego badania; nie certyfikują 3.1.2.

ACT off6ek: reguła proponowana, aktualizacja 2026-01-19. Bada istniejące lang ze znanym głównym tagiem i tekst dziedziczący ten język. Główny tag ma odpowiadać najbardziej rozpowszechnionemu językowi liczonymi słowami; słowo może należeć do kilku języków i remisy są dopuszczone. Dzieci z własnym lang wypadają z tekstu rodzica. Nie wykrywa brakujących deklaracji. Background wyraźnie dopuszcza PASS przy niespełnionym SC, natomiast tabela mapping twierdzi all-passed=satisfied; zapisujemy tę rozbieżność i przyjmujemy ostrożne ograniczenie z Background. Nie wyciągamy pełnego wyniku SC z PASS tej reguły. Silnik ACT obu reguł: NOT-RUN.

Natywne gettery odczytują język i zakresy z rzeczywistych obiektów po mostku Flutter, bez eksportowania oczekiwanej oceny. VoiceOver=false w dziesięciu zapisanych stanach obu prób pozostaje informacją o ustawieniu, nie wynikiem czytnika. Kadry są surowe; nie tworzono filmu ani syntetycznej mowy. Sekwencja zapisanych tap/click/Enter i stany po działaniu potwierdzają wspólną funkcję, a nie jakość odczytu głosowego.

Jak sprawdza Clearship

Na Androidzie Clearship porównuje język rozpoznanych fragmentów z informacją LocaleSpan i językiem aplikacji. Deterministyczna metoda language-2 używa lokalnego rozpoznawania tekstu, bez AI. Dłuższy obcy fragment bez właściwego oznaczenia albo z błędnym oznaczeniem jest kandydatem usterki. Krótkie fragmenty, nazwy własne, tytuły i sprzeczne zakresy wymagają człowieka; minimum trzech słów i dwunastu liter jest parametrem tej metody, a nie wyjątkiem WCAG dla pojedynczych słów.

Pomiar kontrolny Androida z 8 października 2026 r. spełnił próg: 6/6 usterek, 2 fałszywe alarmy na 739 poprawnych ekranach. Rozpoznanie czterech wyjątków pozostaje ograniczone; tytuły pisane zdaniowo, dłuższe zapożyczenia i podobne języki mogą prowadzić do pomyłek. Metoda nie bada WWW w WebView, tekstów w obrazach, wartości pól, podpowiedzi ani cyklu zmiany języka.

Na iOS sonda XCUITest nie udostępnia accessibilityLanguage i atrybutowanych zakresów języka; pomiar pozostaje poniżej progu i wymaga oceny człowieka. Odczyt wewnętrznego observera UIKit demonstracji edukacyjnej nie potwierdza możliwości sondy Clearship ani rzeczywistej wymowy VoiceOver.

Powiązane kryteria

• 3.1.1
  Język strony

  Fragment może dziedziczyć właściwy domyślny język strony lub programu.

• 2.5.3
  Etykieta w nazwie

  Język zakresu nie zastępuje zgodności nazwy z widoczną etykietą.

• 4.1.2
  Nazwa, rola, wartość

  Kontrolka zachowuje prawidłową nazwę, rolę i działanie również przy etykiecie w kilku językach.

• 3.1.6
  Wymowa

  Wymowa potrzebna do rozstrzygnięcia znaczenia jest odrębnym wymaganiem AAA.

  Artykuł nie jest jeszcze dostępny.