From f78be0017f65d72c148c698192cf3fce770bd3eb Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Tue, 13 Jul 2021 02:32:44 +0900 Subject: conflicting/Web/API/DocumentOrShadowRoot を削除 (#1361) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * conflicting/Web/API/DocumentOrShadowRoot を削除 conflicting/Web/API/DocumentOrShadowRoot 以下を削除。 同時に、 Document.getSelection() のドキュメントを 2021/06/13 時点の最新版に同期 --- files/ja/web/api/document/getselection/index.html | 86 +++++++++-------------- 1 file changed, 33 insertions(+), 53 deletions(-) (limited to 'files/ja/web/api/document') diff --git a/files/ja/web/api/document/getselection/index.html b/files/ja/web/api/document/getselection/index.html index eee7650877..5e416caf0b 100644 --- a/files/ja/web/api/document/getselection/index.html +++ b/files/ja/web/api/document/getselection/index.html @@ -1,86 +1,66 @@ --- -title: DocumentOrShadowRoot.getSelection() +title: Document.getSelection() slug: Web/API/Document/getSelection tags: - API - - DocumentOrShadowRoot - - Doument + - Document - Method - Reference - - ShadowRoot - getSelection - - getSelection() - - shadow dom -translation_of: Web/API/DocumentOrShadowRoot/getSelection +browser-compat: api.Document.getSelection +translation_of: Web/API/Document/getSelection original_slug: Web/API/DocumentOrShadowRoot/getSelection --- -
{{APIRef("DOM")}}{{SeeCompatTable}}
+
{{APIRef("DOM")}}
-

getSelection() は {{DOMxRef("DocumentOrShadowRoot")}} インターフェイスのプロパティで、ユーザーが選択したテキストの範囲、またはキャレットの現在位置を表す {{DOMxRef("Selection")}} オブジェクトを返します。

+

getSelection() は {{DOMxRef("Document")}} インターフェイスのプロパティで、ユーザーが選択したテキストの範囲、またはキャレットの現在位置を表す {{DOMxRef("Selection")}} オブジェクトを返します。

-

構文

+

構文

-
var selection = documentOrShadowRootInstance.getSelection()
+
getSelection()
-

引数

+

引数

なし。

-

返値

+

返値

{{DOMxRef("Selection")}} オブジェクト。

-

例

+

例

-
function foo() {
-    var selObj = document.getSelection();
-    alert(selObj);
-    var selRange = selObj.getRangeAt(0);
-    // do stuff with the range
-}
+

Selection オブジェクトを取得

-

メモ

+
+let selection = document.getSelection();
+let selRange = selection.getRangeAt(0);
+// この範囲に対して何かをする
 
-
Selection オブジェクトの文字列表現

+console.log(selection); // Selection オブジェクト
+
-

JavaScript では、オブジェクトが string を取る関数 ({{DOMxRef("Window.alert()")}} など) に渡された場合、オブジェクトの {{JSxRef("Object.toString", "toString()")}} メソッドが呼び出され、関数にその返値が渡されます。これにより、プロパティやメソッドを持つ実際のオブジェクトであった場合、他の関数に使われると文字列になって現れることがあります。

+

Selection オブジェクトの文字列表現

-

上記の例では、 selObj.toString() が呼び出されてから {{DOMxRef("Window.alert()")}} に渡されます。しかし、 JavaScript の String のプロパティやメソッド、例えば length や substr が {{DOMxRef("Selection")}} オブジェクトに対して呼び出されると、そのプロパティやメソッドを持っていないため、エラーが発生するか予期しない結果が返ることがあります。 Selection オブジェクトを文字列として扱うには、 toString() メソッドを直接呼び出してください。

+

JavaScript では、オブジェクトが文字列を取る関数 ({{DOMxRef("Window.alert()")}} など) に渡された場合、オブジェクトの {{JSxRef("Object.toString", "toString()")}} メソッドが呼び出され、関数にその返値が渡されます。これにより、プロパティやメソッドを持つ実際のオブジェクトであった場合、他の関数に使われると文字列になって現れることがあります。

-
var selectedText = selObj.toString();
+
alert(selection);
- +

ただし、すべての関数で自動的に toString() が呼び出されるとは限りません。 Selection オブジェクトを文字列として使用する場合は、 toString() メソッドを直接呼び出してください。

- +
let selectedText = selection.toString();
+ +

{{domxref("Window.getSelection()")}} を呼び出すと、 Document.getSelection() と同等の動作をします。

-

Firefox において現在は getSelection() は {{htmlelement("input")}} 要素の中では動作しないことに注意してください。 {{domxref("HTMLInputElement.setSelectionRange()")}}) を使用することで回避できます。

+

Firefox において現在は getSelection() は {{htmlelement("input")}} 要素の中では動作しないことに注意してください。 {{domxref("HTMLInputElement.setSelectionRange()")}} を使用することで回避できます。

selection と focus との違いにも注意してください。 {{domxref("Document.activeElement")}} はフォーカスを持つ要素を返します。

-

仕様書

- - - - - - - - - - - - - - -
仕様書状態備考
{{SpecName("Shadow DOM", "#extensions-to-the-documentorshadowroot-mixin", "DocumentOrShadowRoot")}}{{Spec2("Shadow DOM")}}初回定義
- -

ブラウザーの互換性

- -
-

{{Compat("api.DocumentOrShadowRoot.getSelection")}}

-
+

仕様書

+ +{{Specifications}} + +

ブラウザーの互換性

+ +

{{Compat}}

-- cgit v1.2.3-54-g00ecf