База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / CSS

::highlight() — стилизиране на персонализирани текстови откроявания

Псевдоелементът ::highlight() стилизира текстови диапазони, регистрирани чрез CSS Custom Highlight API, без да добавя обвиващи елементи. CSS задава изгледа, а JavaScript създава диапазоните и регистрира открояването под име.

Версия: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Синтаксис

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

::highlight() е името на функционален псевдоелемент; това не е валиден селектор с празен аргумент. Той представя части от текст, обхванати от персонализирано открояване. За разлика от ::selection, не изисква потребителят да избира текста. Диапазоните могат да преминават през границите на елементи, без да променят DOM структурата.

Записите ::highlight(<custom-highlight-name>) и ::highlight(<custom-ident>) описват избор на открояване по име; ъгловите скоби обозначават заместители, а не буквален код. В ::highlight(demo) аргументът demo съответства на ключа в CSS.highlights.set('demo', ...). Само CSS не създава диапазон: JavaScript подава Range на Highlight и регистрира обекта в CSS.highlights.

Editor’s Draft разширява синтаксиса до ::highlight(<highlight-name-selector>), като приема <custom-ident> или *. ::highlight(*) избира всички персонализирани откроявания, но не и вградените, като ::selection. Именуваната форма има специфичност (0,0,1), а формата с * — (0,0,0). Това разширение от проекта трябва да се провери отделно в целевия браузър.

Прилагат се само свойства, разрешени за откроявания, включително color и background-color; margin, display и font-size не могат да променят разположението им. Примерът обхваща диапазона от индекс 6 до изключващ индекс 10, тоест Beta. Проверката на наличността на API и синтаксиса на селектора не доказва правилно визуализиране; трябва да се провери и изгледът.

Примери

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

Резултат

Beta

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници