KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

::highlight() — aangepaste tekstmarkeringen opmaken

Het pseudo-element ::highlight() geeft tekstbereiken die via de CSS Custom Highlight API zijn geregistreerd een stijl, zonder wrapper-elementen toe te voegen. CSS bepaalt het uiterlijk; JavaScript maakt de bereiken en registreert de markering onder een naam.

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

Syntax

::highlight(<custom-ident>)
/* Editor’s Draft: */
::highlight(<highlight-name-selector>)
/* <highlight-name-selector> = '*' | <custom-ident> */

::highlight() is de naam van een functioneel pseudo-element; het is geen geldige selector met een leeg argument. Het staat voor tekstdelen die onder een aangepaste markering vallen. Anders dan bij ::selection hoeft de gebruiker de tekst niet te selecteren. Bereiken kunnen elementgrenzen overschrijden zonder de DOM-structuur te veranderen.

De notaties ::highlight(<custom-highlight-name>) en ::highlight(<custom-ident>) beschrijven het selecteren van een markering op naam; punthaken geven plaatsaanduidingen aan en zijn geen letterlijke code. In ::highlight(demo) komt het argument demo overeen met de sleutel in CSS.highlights.set('demo', ...). CSS maakt zelf geen bereik: JavaScript geeft een Range door aan Highlight en registreert het object in CSS.highlights.

De Editor’s Draft breidt de syntax uit naar ::highlight(<highlight-name-selector>), met <custom-ident> of * als mogelijke argumenten. ::highlight(*) selecteert alle aangepaste markeringen, maar geen ingebouwde markeringen zoals ::selection. De vorm met een naam heeft specificiteit (0,0,1); de vorm met * heeft (0,0,0). Deze uitbreiding uit het concept moet afzonderlijk in de doelbrowser worden gecontroleerd.

Alleen eigenschappen die voor markeringen zijn toegestaan, zijn van toepassing, waaronder color en background-color; margin, display en font-size kunnen de lay-out ervan niet veranderen. Het voorbeeld omvat het bereik vanaf index 6 tot exclusief index 10, oftewel Beta. Controleren of de API beschikbaar is en de selectorsyntax wordt ondersteund, bewijst niet dat de weergave correct is; controleer ook het uiterlijk.

Voorbeelden

<!doctype html>
<meta charset="utf-8">
<title>Custom highlight</title>
<style>
  ::highlight(demo) {
    color: #000000;
    background-color: #ffff00;
  }
</style>
<p id="text">Alpha Beta Gamma</p>
<pre id="status"></pre>
<script>
  const status = document.getElementById('status');
  if (!('Highlight' in window) || !CSS.highlights ||
      !CSS.supports('selector(::highlight(demo))')) {
    status.textContent = 'Unsupported';
  } else {
    const text = document.getElementById('text').firstChild;
    const range = new Range();
    range.setStart(text, 6);
    range.setEnd(text, 10);
    CSS.highlights.set('demo', new Highlight(range));
    status.textContent = range.toString();
  }
</script>

Resultaat

Beta

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen