Document: caretPositionFromPoint() メソッド

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

caretPositionFromPoint() は Document インターフェイスのメソッドで、この DOM ノードを含む CaretPosition オブジェクトを、そのノード内のキャレットとキャレットの文字オフセットと共に返します。

構文

caretPositionFromPoint(x, y)

引数

x: ポイントの水平座標。
y: ポイントの垂直座標。

返値

CaretPosition オブジェクト。

例

以下のデモの段落のどこかをクリックすると、クリックした位置に改行を挿入します。コードはデモの下にあります。

デモ

下記のコードでは、最初に document.caretPositionFromPoint の対応状況を調べますが、ブラウザーが対応していない場合は document.caretRangeFromPoint を調べて、代わりにそれを使用します。

JavaScript

function insertBreakAtPoint(e) {
  let range;
  let textNode;
  let offset;

  if (document.caretPositionFromPoint) {
    range = document.caretPositionFromPoint(e.clientX, e.clientY);
    textNode = range.offsetNode;
    offset = range.offset;
  } else if (document.caretRangeFromPoint) {
    // WebKit 独自の代替メソッドを使用
    range = document.caretRangeFromPoint(e.clientX, e.clientY);
    textNode = range.startContainer;
    offset = range.startOffset;
  } else {
    // どちらのメソッドも対応していなければ、何もしない
    return;
  }
  // TEXT_NODE のみを分割
  if (textNode?.nodeType === 3) {
    let replacement = textNode.splitText(offset);
    let br = document.createElement("br");
    textNode.parentNode.insertBefore(br, replacement);
  }
}

let paragraphs = document.getElementsByTagName("p");
for (const paragraph of paragraphs) {
  paragraph.addEventListener("click", insertBreakAtPoint, false);
}

let message = document.getElementById("message");
if (document.caretPositionFromPoint) {
  message.textContent =
    "このブラウザーは標準の document.caretPositionFromPoint に対応しています";
  message.classList.add("supported");
} else if (document.caretRangeFromPoint) {
  message.textContent =
    "このブラウザーは標準外の document.caretRangeFromPoint に対応しています";
  message.classList.add("supported");
}

HTML

<div id="message">
  このブラウザーは document.caretRangeFromPoint にも
  document.caretPositionFromPoint にも対応していません。
</div>

html

<p>
  Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
  eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
  voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita
  kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.
</p>

#message {
  color: red;
  font-weight: bold;
}

#message.fallback {
  color: darkorange;
}

#message.supported {
  color: green;
}

仕様書

Specification
CSSOM View Module # dom-document-caretpositionfrompoint

ブラウザーの互換性

BCD tables only load in the browser