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.