CKTIS / CSS
:defined — die Pseudoklasse für definierte Elemente
Die Pseudoklasse :defined wählt Elemente aus, die gemäß der Dokumentsprache als definiert gelten. In HTML trifft sie auf gewöhnliche eingebaute Elemente und erfolgreich konstruierte benutzerdefinierte Elemente zu. So lässt sich eine Komponente, die noch auf ihre Definition wartet, von einer bereits aktualisierten unterscheiden.
Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
:defined:defined ist eine Pseudoklasse ohne Argumente. Ihre Bedeutung wird durch die Dokumentsprache bestimmt. Unterscheidet diese Sprache nicht zwischen definierten und nicht definierten Elementen, stimmen alle Elemente überein. In HTML ist ein gewöhnliches p-Element definiert. Wird ein p jedoch mit einem gültigen is-Wert als Kandidat für ein angepasstes eingebautes Element erstellt, kann es bis zu einem erfolgreichen Upgrade undefiniert bleiben.
Ein benutzerdefiniertes Element, das noch auf seine Definition wartet, stimmt nicht mit :defined überein. Nach einer erfolgreichen Aktualisierung stimmt es überein. Allein die Registrierung eines Namens garantiert nicht den Erfolg für jede Instanz: Eine fehlgeschlagene Konstruktion ergibt kein erfolgreich definiertes Element.
Verwende demo-card:defined für die definierte Komponente und demo-card:not(:defined) für den entgegengesetzten Zustand. Eine Übereinstimmung bedeutet nicht, dass das Abrufen von Daten, das Laden von Bildern oder die asynchrone Initialisierung der Anwendung abgeschlossen ist.
Das Beispiel hält den Zustand vor und nach customElements.define() fest. Der endgültige Rahmen ist durchgezogen; möglicherweise wird der Zustand vor der Registrierung nie angezeigt. Vermeide es, :not(:defined) global auszublenden: Wenn die Definition nicht eintrifft, können Inhalte unzugänglich bleiben.
Beispiele
<!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>Ergebnis
built-in: true before: false after: true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.