Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

enterkeyhint: etykieta wirtualnego Enter

Opisz zamiar działania, ale nie traktuj etykiety jak jego implementacji.

Wersja: HTML Living Standard

Składnia

<input type="search" enterkeyhint="search">

Globalny atrybut enterkeyhint sugeruje etykietę lub ikonę Enter na klawiaturze wirtualnej. Zdefiniowane wartości to enter, done, go, next, previous, search i send. Przy braku lub nieobsługiwanej wartości przeglądarka wybiera na podstawie kontekstu. Wygląd zależy od platformy i metody wprowadzania tekstu.

To nie obsługa zdarzenia, algorytm zarządzania fokusem ani polecenie wysłania danych. Właściwe działanie zaimplementuj zachowaniem formularza lub skryptem i zapewnij dostępny przycisk. Funkcja jest odrębna od wyboru układu znaków klawiatury. Fizyczny klawisz nie musi zmieniać nadrukowanej etykiety.

Przykład oznacza Enter w polu wyszukiwania i jawnie obsługuje wysłanie formularza. Rzeczywiste naciśnięcie Enter przekazuje wartość do tej obsługi bez nawigacji. Test potwierdza działanie formularza, nie ikonę na mobilnej klawiaturze.

Przykłady

<!doctype html><meta charset="utf-8">
<form id="form"><label>Find <input id="query" type="search" name="q" enterkeyhint="search" value="HTML"></label><button>Search</button></form><output id="result"></output>
<script>
document.querySelector('#form').addEventListener('submit', event => {
  event.preventDefault();
  document.querySelector('#result').textContent = 'submitted=' + new FormData(event.currentTarget).get('q');
});
// Focus the field and press Enter. The form handler implements the action.
</script>

Wynik

submitted=HTML

Test przeglądarkowy używa zdarzenia fizycznego klawisza; nie deklaruje wyglądu mobilnej klawiatury.

Źródła