CKTIS / CSS
:defined — pseudotřída definovaných prvků
Pseudotřída :defined vybírá prvky, které jazyk dokumentu považuje za definované. V HTML odpovídá běžným vestavěným prvkům a úspěšně vytvořeným vlastním prvkům. Umožňuje rozlišit komponentu čekající na svou definici od té, která už byla aktualizována.
Verze: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
:defined:defined je pseudotřída bez argumentů. Její význam určuje jazyk dokumentu. Pokud tento jazyk nerozlišuje definované a nedefinované prvky, odpovídají všechny prvky. V HTML je běžný prvek p definovaný. Pokud je ale p vytvořen s platnou hodnotou is jako kandidát na vlastní prvek odvozený od vestavěného prvku, může zůstat nedefinovaný až do úspěšné aktualizace.
Vlastní prvek čekající na svou definici neodpovídá :defined. Po úspěšné aktualizaci odpovídá. Samotná registrace názvu nezaručuje úspěch každé instance: neúspěšné vytvoření nevede k úspěšně definovanému prvku.
Pro definovanou komponentu použijte demo-card:defined a pro opačný stav demo-card:not(:defined). Odpovídání selektoru neznamená, že je dokončeno načítání dat, obrázků nebo asynchronní inicializace aplikace.
Příklad zaznamenává stav před voláním customElements.define() a po něm. Výsledný okraj je plný; stav před registrací se nemusí nikdy vykreslit. Vyhněte se globálnímu skrývání :not(:defined): pokud definice nedorazí, obsah může zůstat nedostupný.
Příklady
<!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>Výsledek
built-in: true before: false after: true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.