Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

:defined — la pseudoclasse degli elementi definiti

La pseudoclasse :defined seleziona gli elementi considerati definiti dal linguaggio del documento. In HTML corrisponde agli elementi integrati ordinari e agli elementi personalizzati creati correttamente. Permette di distinguere un componente in attesa della propria definizione da uno già aggiornato.

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

Sintassi

:defined

:defined è una pseudoclasse senza argomenti. Il suo significato dipende dal linguaggio del documento. Se tale linguaggio non distingue tra elementi definiti e non definiti, corrispondono tutti gli elementi. In HTML, un normale elemento p è definito. Un p creato con un valore valido per is come candidato a diventare un elemento integrato personalizzato può invece rimanere non definito finché l’aggiornamento non va a buon fine.

Un elemento personalizzato in attesa della propria definizione non corrisponde a :defined. Dopo un aggiornamento riuscito, vi corrisponde. La registrazione di un nome, da sola, non garantisce il successo per ogni istanza: una costruzione non riuscita non produce un elemento definito correttamente.

Usa demo-card:defined per il componente definito e demo-card:not(:defined) per lo stato opposto. La corrispondenza non implica che siano terminati il recupero dei dati, il caricamento delle immagini o l’inizializzazione asincrona dell’applicazione.

L’esempio registra lo stato prima e dopo customElements.define(). Il bordo finale è continuo; lo stato precedente alla registrazione potrebbe non essere mai visualizzato. Evita di nascondere globalmente :not(:defined): se la definizione non arriva, il contenuto può restare inaccessibile.

Esempi

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

Risultato

built-in: true
before: false
after: true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti