CKTIS / HTML
placeholder — uma indicação num campo vazio
O atributo placeholder fornece uma indicação breve para um campo input ou textarea vazio. Não define o valor do campo e não deve substituir a respetiva etiqueta.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<input type="text" placeholder="hint">
<textarea placeholder="hint"></textarea>placeholder contém uma indicação breve, como um valor de exemplo ou o formato esperado. Aplica-se a textarea e aos seguintes tipos de input: text, search, url, tel, email, password e number; não é um atributo global.
A indicação destina-se a um campo vazio. Depois de ser introduzido um valor, deixa de ser apresentada; a sua visibilidade enquanto o campo tem o foco pode depender do navegador. Não a uses em vez de label: a etiqueta deve identificar o campo mesmo depois de a escrita começar.
O texto placeholder não é o valor do campo nem o seu valor predefinido e, por si só, não satisfaz required. Em input, o valor do atributo não pode conter caracteres LF ou CR. Em textarea, os caracteres CRLF, CR e LF da indicação são apresentados como quebras de linha.
Exemplos
<!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>Resultado
{"value":"","hint":"Krakow"}O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.