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

CKTIS / CSS

:defined — a pseudoclasse dos elementos definidos

A pseudoclasse :defined seleciona os elementos considerados definidos pela linguagem do documento. Em HTML, corresponde aos elementos integrados comuns e aos elementos personalizados construídos com sucesso. Permite distinguir um componente que aguarda a sua definição de outro que já foi atualizado.

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

Sintaxe

:defined

:defined é uma pseudoclasse sem argumentos. O seu significado é determinado pela linguagem do documento. Se essa linguagem não distinguir elementos definidos de não definidos, todos os elementos correspondem. Em HTML, um elemento p comum está definido. Já um p criado com um valor válido de is como candidato a elemento integrado personalizado pode permanecer por definir até ser atualizado com sucesso.

Um elemento personalizado que aguarda a sua definição não corresponde a :defined. Após uma atualização bem-sucedida, corresponde. O registo de um nome, por si só, não garante o sucesso de cada instância: uma construção falhada não produz um elemento definido com sucesso.

Utiliza demo-card:defined para o componente definido e demo-card:not(:defined) para o estado oposto. A correspondência não significa que a obtenção de dados, o carregamento de imagens ou a inicialização assíncrona da aplicação tenham terminado.

O exemplo regista o estado antes e depois de customElements.define(). A borda final é contínua; o estado anterior ao registo pode nunca ser apresentado. Evita ocultar globalmente :not(:defined): se a definição nunca chegar, o conteúdo pode permanecer inacessível.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:defined demo</title>
<style>
  demo-card { display: block; padding: 8px; }
  demo-card:not(:defined) { border: 2px dashed; }
  demo-card:defined { border: 2px solid; }
</style>
<demo-card>Demo</demo-card>
<pre id="output"></pre>
<script>
  const card = document.querySelector('demo-card');
  const output = document.querySelector('#output');
  const lines = [
    `built-in: ${output.matches(':defined')}`,
    `before: ${card.matches(':defined')}`
  ];
  customElements.define('demo-card', class extends HTMLElement {});
  lines.push(`after: ${card.matches(':defined')}`);
  output.textContent = lines.join('\n');
</script>
</html>

Resultado

built-in: true
before: false
after: true

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