Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

:placeholder-shown — um controlo que apresenta um marcador de posição

A pseudoclasse :placeholder-shown seleciona um controlo que está a apresentar o seu texto de indicação. Permite alterar o aspeto de todo o campo, e não apenas o do texto do marcador de posição.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

:placeholder-shown

:placeholder-shown é uma pseudoclasse sem argumentos. Em HTML, corresponde aos elementos input e textarea quando o valor do respetivo atributo placeholder está a ser apresentado ao utilizador. A regra input:placeholder-shown aplica, portanto, estilos ao campo nesse estado.

Não é um teste geral para verificar se o valor está vazio. A existência de um atributo placeholder também não é suficiente: [placeholder] verifica se o atributo está presente, enquanto :placeholder-shown verifica se o texto de indicação está a ser apresentado. Um campo vazio sem marcador de posição não corresponde; por conseguinte, :not(:placeholder-shown) não significa automaticamente que o campo está preenchido ou é válido.

Distingue :placeholder-shown de ::placeholder: a pseudoclasse seleciona o próprio controlo, enquanto o pseudoelemento representa o texto do marcador de posição. Usa a primeira, por exemplo, para alterar o contorno do campo, e o segundo para aplicar estilos ao texto de indicação.

No exemplo, o campo vazio que apresenta o texto de indicação Ada tem um contorno azul. Ao introduzir um valor, este passa a cinzento; ao apagar o valor por completo, o contorno volta a azul quando o texto de indicação é apresentado novamente.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Placeholder state</title>
<style>
  input { border: 3px solid #555; padding: 0.5rem; }
  input:placeholder-shown { border-color: #005fcc; }
</style>
<label for="name">Name</label>
<input id="name" type="text" placeholder="Ada" autocomplete="off">
</html>

Resultado

Empty field showing Ada: blue border (#005fcc). After typing Ada: gray border (#555). After deleting the entire value: blue border again.

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.

Fontes