WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

enterkeyhint: Beschriftung der virtuellen Eingabetaste

Beschreiben Sie die beabsichtigte Aktion, ohne die Beschriftung als Implementierung zu behandeln.

Version: HTML Living Standard

Syntax

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

Das globale enterkeyhint empfiehlt eine Beschriftung oder ein Symbol für Enter auf virtuellen Tastaturen. Definierte Werte sind enter, done, go, next, previous, search und send. Ohne unterstützte Angabe entscheidet der Browser anhand des Kontexts. Die Darstellung hängt von Plattform und Eingabemethode ab.

Das ist kein Ereignishandler, Fokusalgorithmus oder Befehl zum Versenden von Daten. Implementieren Sie die Aktion mit passendem Formularverhalten oder Skript und behalten Sie ein zugängliches Bedienelement. Es ist unabhängig von der Zeichentastaturbelegung. Eine physische Tastatur muss ihren Aufdruck nicht ändern.

Das Beispiel beschriftet Enter im Suchfeld und verarbeitet die Formularübermittlung ausdrücklich. Ein echter Tastendruck übergibt den Wert ohne Navigation an den Handler. Der Test bestätigt das Formularverhalten, nicht das Symbol einer mobilen Tastatur.

Beispiele

<!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>

Ergebnis

submitted=HTML

Der Browsertest verwendet ein physisches Tastenereignis; eine mobile Darstellung wird nicht behauptet.

Quellen