Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

:defined — la pseudo-classe des éléments définis

La pseudo-classe :defined sélectionne les éléments considérés comme définis par le langage du document. En HTML, elle correspond aux éléments intégrés ordinaires et aux éléments personnalisés construits avec succès. Elle permet de distinguer un composant qui attend encore sa définition d’un composant déjà mis à niveau.

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

Syntaxe

:defined

:defined est une pseudo-classe sans argument. Sa signification dépend du langage du document. Si ce langage ne distingue pas les éléments définis des éléments non définis, tous les éléments correspondent. En HTML, un élément p ordinaire est défini. En revanche, un p créé avec une valeur valide pour is comme candidat à devenir un élément intégré personnalisé peut rester non défini jusqu’à ce que sa mise à niveau réussisse.

Un élément personnalisé en attente de sa définition ne correspond pas à :defined. Après une mise à niveau réussie, il y correspond. L’enregistrement d’un nom ne garantit pas à lui seul la réussite de chaque instance : une construction qui échoue ne produit pas un élément défini avec succès.

Utilisez demo-card:defined pour le composant défini et demo-card:not(:defined) pour l’état opposé. La correspondance ne signifie pas que la récupération des données, le chargement des images ou l’initialisation asynchrone de l’application est terminé.

L’exemple consigne l’état avant et après customElements.define(). La bordure finale est continue ; l’état précédant l’enregistrement peut ne jamais être affiché. Évitez de masquer globalement :not(:defined) : si la définition n’arrive jamais, le contenu peut rester inaccessible.

Exemples

<!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>

Résultat

built-in: true
before: false
after: true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources