Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje