Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

placeholder — podpowiedź w pustym polu

Atrybut placeholder określa krótką podpowiedź dla pustego pola input lub textarea. Nie ustawia wartości pola i nie zastępuje jego etykiety label.

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

Składnia

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

placeholder zawiera krótką podpowiedź, na przykład przykładową wartość lub oczekiwany format. Dotyczy textarea oraz typów input: text, search, url, tel, email, password i number; nie jest atrybutem globalnym.

Podpowiedź jest przeznaczona dla pustego pola. Po wpisaniu wartości przestaje być wyświetlana; jej widoczność podczas ustawienia fokusu może zależeć od przeglądarki. Nie zastępuj nią label: etykieta powinna identyfikować pole także po rozpoczęciu wpisywania.

Tekst placeholder nie jest wartością pola ani wartością domyślną i sam nie spełnia warunku required. Dla input wartość atrybutu nie może zawierać znaków LF ani CR. W textarea znaki CRLF, CR i LF w podpowiedzi są renderowane jako podziały wiersza.

Przykłady

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

Wynik

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

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

Źródła