本文へ移動

k8o

お問い合わせ

255文字以内で入力してください

GitHub Issueからのお問い合わせもお待ちしております。

Blog

公開: 2025年8月25日(月)更新: 2026年11月9日(月)約14分で読めます

getComposedRangesでShadow DOM内の選択を取得

getComposedRanges()は、Shadow DOMの中や境界をまたいで選んだ範囲を、中のテキストノードの位置で返すSelectionのメソッドです。getRangeAt(0)では崩れる選択範囲も正しく取れます。

Newly availableSelection composed ranges2025年〜
  • Chrome137
  • Edge137
  • Firefox142
  • Safari17

はじめに

getComposedRangesメソッドは、ユーザーが選択した範囲を、Shadow DOMの中のノードの位置まで含めて返すSelectionオブジェクトのメソッドです。中を見てよいShadowRootを渡すと、その中のテキストノードと文字の位置がStaticRangeで返ります。Firefox 142が対応して、Baseline 2025に入りました。

選択範囲がふつうのDOMの中にあるときは、getRangeAt(0)で範囲が取れます。Shadow DOMの中を選んだときや、外から中へまたいで選んだときは、getRangeAt(0)が返す範囲がブラウザによって違い、Shadow DOMの中の位置が分からないことがあります。たとえばChromeでマウスを使って外から中へ選ぶと、getRangeAt(0)の終わりはホスト要素の位置になり、toString()の結果にもShadow DOMの中の文字が入りません。getComposedRangesメソッドなら、どのブラウザでも中の位置まで取れます。

html
<p id="host"></p>
<script>
  const host = document.getElementById('host');
  const shadowRoot = host.attachShadow({ mode: 'open' });
  shadowRoot.textContent = 'Shadow DOMの中の文字';

  document.addEventListener('selectionchange', () => {
    const selection = document.getSelection();
    const [range] = selection.getComposedRanges({ shadowRoots: [shadowRoot] });
    console.log(range?.startContainer, range?.startOffset, range?.endOffset);
  });
</script>

Shadow DOMの中の文字を選ぶと、コンソールにShadow DOMの中のテキストノードと、選んだ文字の始まりと終わりの位置が出ます。

Selection

Selectionは、ユーザーが選択したテキストの範囲やキャレットの位置を表すオブジェクトです。window.getSelection()で取り出し、toString()で選んだ文字列を、getRangeAt(0)で選択範囲をRangeとして取り出せます。選択範囲が変わるたびに、documentにselectionchangeイベントが届きます。

ts
document.addEventListener('selectionchange', () => {
  const selection = window.getSelection();
  if (!selection || selection.rangeCount === 0) return;
  console.log(selection.toString(), selection.getRangeAt(0));
});

getComposedRanges

getComposedRanges()は、Shadow DOMの境界をまたいで選んだ範囲を、Shadow DOMの中の位置まで含めて返します。

ts
const ranges = window.getSelection()?.getComposedRanges({ shadowRoots: [shadowRoot1, shadowRoot2] });

戻り値はStaticRangeの配列です。RangeはDOMが変わると位置が追従しますが、StaticRangeは作った時点の位置のままです。

オプションのshadowRootsには、中の位置を見てよいShadowRootの配列を渡します。渡したShadowRootの中にある端は、Shadow DOMの中の位置で返ります。渡していないShadowRootの中にある端はShadow DOMの外に出され、ホスト要素の親と、その中でのホスト要素の位置で返ります。

html
<div id="sample">
  <p id="heading">サンプルテキスト</p>
  <p id="host">あさ、眼をさますときの気持は、面白い。かくれんぼのとき、押入れの真っ暗い中に、じっと、しゃがんで隠れていて、突然、でこちゃんに、がらっと襖をあけられ、日の光がどっと来て、でこちゃんに、「見つけた!」と大声で言われて、まぶしさ、それから、へんな間の悪さ、それから、胸がどきどきして、着物のまえを合せたりして、ちょっと、てれくさく、押入れから出て来て、急にむかむか腹立たしく、あの感じ、いや、ちがう、あの感じでもない、なんだか、もっとやりきれない。</p>
</div>
<p>本文の一部をドラッグして選ぶと、範囲が指す文字が下に出ます。</p>
<dl>
  <dt>getRangeAt(0)</dt>
  <dd id="range-at"></dd>
  <dt>getComposedRanges({ shadowRoots })</dt>
  <dd id="with-roots"></dd>
  <dt>getComposedRanges()</dt>
  <dd id="without-roots"></dd>
</dl>
結果

結果の欄の本文は、閉じたShadow DOM(mode: 'closed')の中にあります。本文の一部を選ぶと、3つの方法で取り出した範囲が、どの文字を指しているかが出ます。getRangeAt(0)は、Firefoxでは選んだ文字を指しますが、ChromeとSafariでは空の範囲になり、どこを選んだのか分かりません。ShadowRootを渡したgetComposedRanges()は、選んだ文字をそのまま指します。渡さないと、範囲の端がShadow DOMの外に出され、本文の段落まるごとを指します。

見出しから本文までまたいで選ぶと、getRangeAt(0)の結果はブラウザでばらばらです。Chromeでは見出しの文字だけを、Firefoxでは本文の文字だけを指し、SafariではrangeCountが0になって取り出せません。ShadowRootを渡したgetComposedRanges()なら、見出しの文字から本文の選んだ文字までを指します。

getComposedRanges(shadowRoot)のように、ShadowRootをオブジェクトに入れずに渡す古い書き方もあります。SafariとFirefoxでは中の位置が返りますが、Chromeでは無視され、渡さないときと同じ結果になります。TypeScriptでも型エラーになるので、{ shadowRoots: [...] }の形で渡します。

おわりに

getComposedRanges()を使うと、Shadow DOMの中や境界をまたいで選んだ範囲を、中のテキストノードと文字の位置で受け取れます。ShadowRootは{ shadowRoots: [...] }の形で渡し、渡したShadowRootの中の端だけが中の位置で返ります。