Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

termin lub wartość HTML: translate

Atrybut `translate` określa, czy tekst elementu i tłumaczalne wartości jego atrybutów mają być zmieniane podczas lokalizacji; normatywne stany to `yes` i `no`.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

<section translate="no">…</section>

Pusta wartość oraz słowo yes włączają tłumaczenie, a słowo no je wyłącza. Brak lub niepoprawna wartość dziedziczy stan od rodzica, przy czym korzeń bez deklaracji domyślnie zezwala na tłumaczenie.

Stan obejmuje węzły tekstowe oraz atrybuty zdefiniowane jako tłumaczalne, między innymi title, alt i placeholder. Nie oznacza to, że przeglądarka natychmiast przetłumaczy stronę; jest to instrukcja dla narzędzi i procesów lokalizacyjnych.

Stosuj translate="no" możliwie wąsko dla nazw marki, kodu, identyfikatorów lub danych, których zmiana zepsułaby znaczenie. Nie zastępuje on deklaracji języka lang, kontroli dostępu ani ochrony przed odczytem zawartości.

Przykład pokazuje właściwość translate równą false na rodzicu i dziedziczącym dziecku, jawne nadpisanie true na drugim dziecku oraz surową wartość null tam, gdzie atrybutu nie ma.

Przykłady

<!doctype html><meta charset="utf-8"><section id="p" translate="no"><span id="x">Brand</span><span id="y" translate="yes">Translate me</span></section><output id="result"></output><script>result.textContent=`parent=${p.translate}; inherited=${x.translate}; override=${y.translate}; childRaw=${x.getAttribute("translate")}`;</script>

Wynik

parent=false; inherited=false; override=true; childRaw=null

Wykonany przykład potwierdza dziedziczenie zakazu tłumaczenia i prawidłowe przywrócenie stanu yes w zagnieżdżonym fragmencie.

Źródła