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.