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.