このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。
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 オブジェクトを、そのノード内のキャレットとキャレットの文字オフセットと共に返します。
構文
js
caretPositionFromPoint(x, y)
引数
返値
CaretPosition オブジェクト。
例
以下のデモの段落のどこかをクリックすると、クリックした位置に改行を挿入します。コードはデモの下にあります。
デモ
[フレーム]
下記のコードでは、最初に document.caretPositionFromPoint の 対応状況を調べますが、ブラウザーが対応していない場合は document.caretRangeFromPoint を調べて、代わりにそれを使用します。
JavaScript
js
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 |
ブラウザーの互換性
Enable JavaScript to view this browser compatibility table.