速報

Cacooで問い合わせ記録約792件が流出|全機能停止と利用者の確認点

CATEGORY

本文内検索をCSSで強調する|Custom Highlight APIと未対応環境への備え

※本ページのリンクにはプロモーションが含まれています。

文書内の一致箇所を二色で強調し、検索結果の一覧と照合する開発者の概念イラスト

目次

Chrome 158の公式リリースノートには、名前を問わずすべてのカスタムハイライトを選ぶ::highlight(*)が追加されています。記事ビューアーや業務文書の検索画面では、検索語、注釈、現在の対象などに共通の配色を持たせやすくなります。ただし、検索の処理や結果への移動が自動で付く機能ではありません。まず本文を保持する検索と、色が付かない環境でも読める導線を設計します。

本稿は2026年11月17日時点の公式仕様に基づく実践解説です。Chrome 158の通常の安定版公開予定日は11月17日ですが、確認できた配布案内は11月12日のWindows向けEarly Stableです。全利用者への配布完了とは扱いません。また、Custom Highlight 自体を今回の新機能と混同せず、新しい共通を追加の改善として扱います。

スポンサーリンク

文字を囲み直す代わりに範囲を登録する

CSSWGのCustom Highlight API草案は、構造を変えずに任意のRangeへスタイルを適用する仕組みを定義しています。検索のたびに本文を分割してspanを挿入する処理を避けたい場面で比較できます。リンクや強調要素を含む本文を保持し、検索で見つけた位置だけを別の情報として登録する構成です。

役割は三つに分かれます。JavaScriptで開始点と終了点を持つRangeを作り、複数の範囲をHighlightへまとめ、CSS.highlightsへ名前付きで登録します。CSS側はその名前を使って表示を指定します。一つの検索語が何か所に現れても、同じ意味の強調なら一つのHighlightへまとめられます。

DOMを変えないことだけを理由に、既存実装より必ず高速だとは判断しません。本文を走査する処理とRangeを生成する処理はアプリ側に残ります。本稿では小さな読み取り専用の本文から導入し、長文や編集画面への拡張は計測結果を見て決める方法を提案します。

基礎の名前付きスタイルを先に用意する

最初は登録名を一つ決め、前景色と背景色を対で指定します。次のCSSは後述のJavaScriptが使うarticle-matchesという名前に対応します。色は説明用であり、実際のテーマ、リンク色、利用者の表示設定で読みやすさを確認してください。

::highlight(article-matches) {
  color: #191919;
  background-color: #ffe08a;
}

CSS Pseudo-Elements Level 4の草案では、ハイライトへ適用できるプロパティを限定しています。通常の要素のように余白や文字サイズを変えて部品を作る用途とは分けます。色を付けた語そのものをボタンと見なさず、「次の一致へ進む」操作が必要なら、実際のボタンや結果一覧を別に用意します。

スポンサーリンク

新しい全件指定は独立した対応判定で追加する

Chrome 158の案内では、星印を引数にした共通指定の詳細度はゼロで、特定の名前を指定した規則がカスケードで上書きできます。これは引数部分の違いです。親要素のIDやクラスを追加したセレクター全体まで常にゼロになる、という意味ではありません。

@supports selector(::highlight(*)) {
  ::highlight(*) {
    color: #191919;
    background-color: #ffe08a;
  }
}
::highlight(review-note) {
  color: #191919;
  background-color: #bce7e0;
}

この追加例は、複数のハイライトへ共通色を使い、review-noteだけ背景色を変える場合です。CSS Conditional Rules Level 4のselector()判定に基づき、星印の対応だけを条件にします。共通指定へ未対応でも、基礎のarticle-matchesは残します。未対応の星印と基礎の指定を一つのセレクターリストへまとめず、改善部分を独立させます。

共通指定は文書内の他のカスタムハイライトにも届きます。別のエディターや注釈部品が同居する画面では、すべて同じ色にしてよいかを確認します。名前の付け方とスタイルの所有範囲をチームでそろえ、アプリ共通の規則が外部部品の意味のある配色を消さないようにします。

読み取り専用本文の完全一致検索から始める

以下は未実行の説明例です。本文がDOMに用意された後、末尾のscriptまたはdeferを付けた外部スクリプトとしてJavaScriptを実行する想定です。reader内は表示する段落とリンクだけに限定し、script、style、非表示のテンプレートを入れません。検索は大文字・小文字を区別し、前後の空白を除いた入力語と同じ文字列を探します。

<form id="article-search">
  <label for="query">本文内の検索語</label>
  <input id="query" type="search">
  <button type="submit">検索</button>
</form>
<p id="search-status" role="status"></p>
<article id="reader">
  <p>検索では本文を保持します。本文の内容を確認します。</p>
</article>
const form = document.querySelector("#article-search");
const input = document.querySelector("#query");
const content = document.querySelector("#reader");
const status = document.querySelector("#search-status");
const name = "article-matches";

form.addEventListener("submit", (event) => {
  event.preventDefault();
  const supported = "CSS" in window &&
    "highlights" in CSS && "Highlight" in window &&
    CSS.supports("selector(::highlight(article-matches))");
  if (!supported) {
    status.textContent = "この環境では強調できません。ブラウザーのページ内検索をご利用ください。";
    return;
  }
  CSS.highlights.delete(name);
  const word = input.value.trim();
  if (!word) {
    status.textContent = "検索語を入力してください。";
    return;
  }
  const ranges = [];
  const walker = document.createTreeWalker(content, NodeFilter.SHOW_TEXT);
  let node;
  while ((node = walker.nextNode()) && ranges.length < 200) {
    let from = 0;
    let at;
    while (ranges.length < 200 &&
      (at = node.data.indexOf(word, from)) !== -1) {
      const range = new Range();
      range.setStart(node, at);
      range.setEnd(node, at + word.length);
      ranges.push(range);
      from = at + word.length;
    }
  }
  CSS.highlights.set(name, new Highlight(...ranges));
  status.textContent = ranges.length === 200
    ? "先頭から200件まで強調しました。"
    : ranges.length + "件を強調しました。";
});

フォームを送信した時点で検索するため、入力中に毎回走査せず、日本語の変換操作と検索の実行を分けられます。上限は強調範囲200件とし、上限到達時は総件数を断定しません。200件のときに本当に残りがあるかまでは調べていないため、「200件まで」という表示にしています。

WHATWG DOMのRange定義に沿って、検索したテキストノードと、そのノード内の位置を開始・終了点に渡します。本文全体のtextContentで得た位置を、最初のノードへそのまま渡さないでください。ノードの長さを超える位置はエラーになります。例では同じnode.dataに対して検索し、その位置からRangeを作ります。

スポンサーリンク

要素をまたぐ語句と文字の正規化は別に設計する

この例は一つのテキストノード内だけを探します。例えば「本文」の途中に強調タグが入り、二つのノードへ分かれた語は見つかりません。要素をまたぐ検索へ拡張するなら、連結した検索用文字列の位置と、元のノード・位置の対応表を作り、両端を正しく戻す工程が必要です。

大小文字の変換やUnicode正規化を加える場合も、加工後の位置を元の本文へ無条件に流用しないでください。文字列の長さが変わる変換では位置がずれます。絵文字や結合文字の途中を強調しないことも確認します。まず製品として必要な検索規則を決め、単純な完全一致の例に、曖昧検索まで備わっていると扱わないことが大切です。

再検索では、自分が登録したarticle-matchesだけを削除しています。CSS.highlights.clear()で文書全体を消すと、別部品の注釈まで失う可能性があります。画面を破棄するときも自分の登録を削除し、本文を差し替えたら検索結果を作り直す方針にします。RangeがDOM変更へ追従することと、同じ検索語に一致し続けることは別です。

色の表示と検索結果の通知を分けて確認する

W3C WAIのステータスメッセージ解説は、検索完了時の件数などを、フォーカスを移さず支援技術へ伝える対象として挙げています。例ではrole="status"を本文と別の段落に用意し、送信後に件数または利用不可の案内を入れています。本文全体をライブ領域にして、毎回全文を読み上げさせる構成にはしていません。

ハイライトへ色が付いたことだけで、読み上げ利用者が該当箇所へ到達できるとは判断しません。結果の前後を示す一覧や、対象段落へ進む導線が必要かを評価します。未対応時も本文をエラーメッセージで置き換えず、ブラウザーのページ内検索を使える状態を保ちます。色を強調の唯一の手掛かりにしないことが、採用範囲を広げる前提です。

検証では、同じ語が複数回ある本文、該当なし、空入力、ちょうど200件と上限超過、リンクや強調タグで分割された語を用意します。名前付きだけに対応する環境、星印も使える環境、APIがない環境を分け、検索後の通常の文字選択・コピー、キーボード操作、読み上げ通知も確認します。

色が出ないときは、検索結果の範囲ができているか、登録名とCSSの名前が一致するか、対象ノードが現在の本文に残っているかを順に調べます。星印の対応だけを調べ続けず、基礎の名前付き指定へ戻して切り分けてください。表示を整えるCSSと、本文を探す処理、結果を伝える操作を別々に確認できる構成から導入します。

関連記事

text-overflowの省略記号と全文への導線では、表示を省略しても情報へ到達できる構成を扱っています。検索対象を一行表示にする画面では、強調と省略を組み合わせた後も、該当箇所と全文を確認できるかを見直してください。

参考資料

Chrome Platform Status:Chrome 158 Release Notes
Chrome Releases:2026年11月12日のEarly Stable
CSSWG:CSS Custom Highlight API Level 1(編集者草案)
CSSWG:CSS Pseudo-Elements Level 4(編集者草案)
CSSWG:CSS Conditional Rules Level 4(編集者草案)
WHATWG:DOM StandardのRange
W3C WAI:ステータスメッセージの達成基準4.1.3の解説

この記事を書いた人

Ryohei

Webエンジニア / アプリ開発者 / 技術ブログ運営者

福岡のWeb制作会社に勤務するWebエンジニアです。10年以上にわたりWeb制作・開発に携わり、ヒアリングや進行管理から、コーディング、CMSの構築、システム開発、サーバーの構築・保守・運用まで、Webサイト制作の工程を幅広く担当しています。Webサイトは、これまでに100以上の構築・保守を手がけてきました。

個人でもWebサイトの制作・改修やWebアプリの開発・運用を行い、AIを活用した開発にも取り組んでいます。近年はWebセキュリティにも注力しています。

2015年から技術メディア「Into the Program」を運営し、実務や開発で得た知識をもとに、プログラミングの実装方法やWebサイトの運用・セキュリティ情報を発信しています。

主な分野
Webサイト構築・保守・運用 / HTML/CSS / JavaScript / PHP / WordPress / サーバー構築・保守・運用 / アプリ開発 / セキュリティ対策
資格・試験合格
情報セキュリティマネジメント試験
基本情報技術者試験
AWS認定ソリューションアーキテクト アソシエイト
PHP8技術者認定ウィザード
メディア運営
2015年〜

記事の作成・更新について

セキュリティ記事は、ベンダーの公式アドバイザリやCVE・JVNなどの一次情報を参照し、出典と情報確認日を記載します。実環境での検証を行った場合は、その環境と確認範囲を明示します。重要な追加情報や誤りを把握した場合は、内容を確認して追記・訂正します。

関連する記事

おすすめの書籍

キーワードから探す

スポンサーリンク

DOM

HTMLの文書を、JavaScriptから操作できるように木構造で表したもの。要素の追加や変更、イベントの処理に使う。

詳しく見る

セレクタ

CSSのスタイルやJavaScriptの処理を当てる対象の要素を指定するための書き方。「.class」「#id」など。

詳しく見る

API

ソフトウェアやサービスの機能を、ほかのプログラムから決まった方法で呼び出して使えるようにした窓口。

詳しく見る