Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

inputmode — wskazówka dotycząca sposobu wprowadzania danych

Globalny atrybut inputmode sugeruje przeglądarce sposób wprowadzania danych, zwykle układ klawiatury ekranowej. Nie ogranicza znaków ani nie zastępuje typu pola i walidacji.

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

Składnia

inputmode="none|text|tel|url|email|numeric|decimal|search"

inputmode to atrybut wyliczeniowy sugerujący odpowiedni mechanizm wprowadzania danych. Może działać w kontrolkach, takich jak input i textarea, oraz w edytowalnej zawartości korzystającej z contenteditable. To wskazówka, nie gwarancja konkretnej klawiatury.

Dostępne wartości: none sugeruje brak klawiatury ekranowej; text — tekst w ustawieniach regionalnych użytkownika; tel — telefon z cyframi, # i *; url — adresy URL; email — adresy e-mail; numeric — cyfry, np. do kodu PIN; decimal — liczby ułamkowe z lokalnym separatorem; search — wyszukiwanie. numeric i decimal nie są zamienne.

inputmode nie waliduje danych ani nie blokuje liter. type określa rodzaj kontrolki, a autocomplete — znaczenie danych dla autouzupełniania. Identyfikator z zerami wiodącymi może pozostać polem type="text" z inputmode="numeric". Reguły poprawności należy określić osobno.

Gdy atrybut jest pominięty lub jego stan nie jest obsługiwany, przeglądarka powinna dobrać klawiaturę na podstawie kontekstu, np. type i pattern. Właściwość DOM inputMode odzwierciedla atrybut, ograniczając odczyt do znanych wartości. Przykład wyświetla numeric i 0072; wygląd klawiatury zależy od urządzenia i przeglądarki.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>inputmode demo</title>
<label for="code">Code</label>
<input id="code" type="text" inputmode="numeric" value="0072">
<pre id="result"></pre>
<script>
  const field = document.getElementById('code');
  document.getElementById('result').textContent =
    `${field.inputMode}\n${field.value}`;
</script>
</html>

Wynik

numeric
0072

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła