WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

placeholder — ein Hinweis in einem leeren Eingabefeld

Das Attribut placeholder liefert einen kurzen Hinweis für ein leeres input- oder textarea-Feld. Es setzt nicht den Wert des Feldes und darf dessen Beschriftung nicht ersetzen.

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

Syntax

<input type="text" placeholder="hint">
<textarea placeholder="hint"></textarea>

placeholder enthält einen kurzen Hinweis, zum Beispiel einen Beispielwert oder das erwartete Format. Es gilt für textarea und für folgende input-Typen: text, search, url, tel, email, password und number; es ist kein globales Attribut.

Der Hinweis ist für ein leeres Feld vorgesehen. Sobald ein Wert eingegeben wurde, wird er nicht mehr angezeigt; ob er bei fokussiertem Feld sichtbar ist, kann vom Browser abhängen. Verwende ihn nicht anstelle von label: Die Beschriftung sollte das Feld auch dann kenntlich machen, wenn die Eingabe bereits begonnen hat.

Der placeholder-Text ist weder der Wert des Feldes noch sein Standardwert und erfüllt required nicht von selbst. Bei input darf der Attributwert keine LF- oder CR-Zeichen enthalten. In textarea werden CRLF-, CR- und LF-Zeichen im Hinweis als Zeilenumbrüche dargestellt.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Placeholder example</title>
<label for="city">City</label>
<input id="city" type="text" placeholder="Krakow">
<p id="result"></p>
<script>
  const city = document.getElementById('city');
  document.getElementById('result').textContent =
    JSON.stringify({ value: city.value, hint: city.placeholder });
</script>
</html>

Ergebnis

{"value":"","hint":"Krakow"}

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen