WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

::highlight() — eigene Texthervorhebungen gestalten

Das Pseudoelement ::highlight() gestaltet Textbereiche, die über die CSS Custom Highlight API registriert wurden, ohne zusätzliche umschließende Elemente einzufügen. CSS legt das Aussehen fest; JavaScript erstellt die Bereiche und registriert die Hervorhebung unter einem Namen.

Version: 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() bezeichnet ein funktionales Pseudoelement; es ist kein gültiger Selektor mit leerem Argument. Es steht für Textabschnitte, die von einer eigenen Hervorhebung erfasst werden. Anders als bei ::selection muss der Benutzer den Text nicht auswählen. Bereiche können Elementgrenzen überschreiten, ohne die DOM-Struktur zu verändern.

Die Schreibweisen ::highlight(<custom-highlight-name>) und ::highlight(<custom-ident>) beschreiben die Auswahl einer Hervorhebung anhand ihres Namens; spitze Klammern kennzeichnen Platzhalter und sind kein wörtlicher Code. In ::highlight(demo) entspricht das Argument demo dem Schlüssel in CSS.highlights.set('demo', ...). CSS allein erstellt keinen Bereich: JavaScript übergibt ein Range an Highlight und registriert das Objekt in CSS.highlights.

Der Editor’s Draft erweitert die Syntax zu ::highlight(<highlight-name-selector>); als Argument sind <custom-ident> oder * zulässig. ::highlight(*) wählt alle eigenen Hervorhebungen aus, jedoch keine integrierten Hervorhebungen wie ::selection. Die benannte Form hat die Spezifität (0,0,1), die Form mit * die Spezifität (0,0,0). Diese Erweiterung des Entwurfs muss im Zielbrowser gesondert überprüft werden.

Es gelten nur Eigenschaften, die für Hervorhebungen zugelassen sind, darunter color und background-color; margin, display und font-size können deren Layout nicht ändern. Das Beispiel umfasst den Bereich vom Index 6 bis zum exklusiven Index 10, also Beta. Die Verfügbarkeit der API und die Selektorsyntax zu prüfen, beweist nicht, dass die Darstellung korrekt ist; auch das Aussehen muss überprüft werden.

Beispiele

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

Ergebnis

Beta

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.

Quellen