Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

autocapitalize: podpowiedź wielkości liter

Podpowiadaj sposób wpisywania tekstu, nie myląc ustawienia klawiatury z walidacją.

Wersja: HTML Living Standard

Składnia

<input autocapitalize="characters" pattern="[A-Z]+">

Globalny atrybut autocapitalize sugeruje wielkość liter podczas wpisywania: none i off wyłączają zmianę, sentences i on sugerują wielkie litery na początku zdań, a words i characters odpowiednio na początku słów i dla wszystkich liter. Kontrolka bez własnego ustawienia może dziedziczyć wskazówkę z formularza. Mechanizm wprowadzania tekstu może ją zignorować lub zmienić; pola URL, e-mail i hasła nie wykorzystują jej do wymuszania wielkich liter.

Nie jest to przekształcanie zapisanego tekstu. Nie zakładaj, że znaki z fizycznej klawiatury, wklejona treść czy wartość ustawiona skryptem staną się wielkimi literami. Do odpowiedniego sprawdzenia poprawności w przeglądarce służy pattern; dane trzeba też sprawdzić na serwerze. Zmiana wielkości liter wymaga świadomej decyzji: nazwisk i haseł nie należy normalizować automatycznie.

Przykład przypisuje małe litery do pola sugerującego wielkie. Wartość nie spełnia wzorca, dopóki skrypt jawnie jej nie przekształci. Pokazuje to rozdzielenie wskazówki, wartości i walidacji, ale nie sprawdza układu ani zachowania prawdziwej klawiatury telefonu.

Przykłady

<!doctype html><meta charset="utf-8">
<label>Code <input id="code" autocapitalize="characters" pattern="[A-Z]+"></label>
<output id="result"></output><script>
const field = document.querySelector('#code');
field.value = 'abc';
const beforeValid = field.checkValidity();
// Explicit application logic, not an automatic effect of autocapitalize.
field.value = field.value.toUpperCase();
document.querySelector('#result').textContent = 'hint=' + field.autocapitalize + '; beforeValid=' + beforeValid + '; afterValid=' + field.checkValidity() + '; value=' + field.value;
</script>

Wynik

hint=characters; beforeValid=false; afterValid=true; value=ABC

Wynik zmienia jawne przekształcenie ciągu przez aplikację, a nie sam atrybut wielkości liter.

Źródła