CKTIS / CSS
::highlight() — styliser des surbrillances de texte personnalisées
Le pseudo-élément ::highlight() met en forme des plages de texte enregistrées via la CSS Custom Highlight API, sans ajouter d’éléments englobants. CSS définit l’apparence, tandis que JavaScript crée les plages et enregistre la surbrillance sous un nom.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
::highlight(<custom-ident>)
/* Editor’s Draft: */
::highlight(<highlight-name-selector>)
/* <highlight-name-selector> = '*' | <custom-ident> */::highlight() désigne un pseudo-élément fonctionnel ; ce n’est pas un sélecteur valide avec un argument vide. Il représente les portions de texte couvertes par une surbrillance personnalisée. Contrairement à ::selection, il ne nécessite pas que l’utilisateur sélectionne le texte. Les plages peuvent traverser les limites d’éléments sans modifier la structure DOM.
Les notations ::highlight(<custom-highlight-name>) et ::highlight(<custom-ident>) décrivent la sélection d’une surbrillance par son nom ; les chevrons indiquent des espaces réservés, et non du code littéral. Dans ::highlight(demo), l’argument demo correspond à la clé de CSS.highlights.set('demo', ...). CSS seul ne crée pas de plage : JavaScript transmet un Range à Highlight et enregistre l’objet dans CSS.highlights.
L’Editor’s Draft étend la syntaxe à ::highlight(<highlight-name-selector>), qui accepte <custom-ident> ou *. ::highlight(*) sélectionne toutes les surbrillances personnalisées, mais pas les surbrillances intégrées comme ::selection. La forme nommée a une spécificité de (0,0,1), tandis que la forme avec * a une spécificité de (0,0,0). Cette extension du brouillon doit être vérifiée séparément dans le navigateur cible.
Seules les propriétés autorisées pour les surbrillances s’appliquent, notamment color et background-color ; margin, display et font-size ne peuvent pas modifier leur disposition. L’exemple couvre la plage de l’indice 6 à l’indice exclusif 10, soit Beta. Vérifier la disponibilité de l’API et la syntaxe du sélecteur ne prouve pas que le rendu est correct ; il faut aussi contrôler l’apparence.
Exemples
<!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>Résultat
Beta
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.