DOM:window.getSelection

出典: MDC

« Gecko DOM リファレンス

目次 1 Summary 2 Syntax 3 Example 4 Notes 5 Specification 6 See also

[編集] Summary

ユーザーが選択した範囲を示す、selection オブジェクトを返します。

[編集] Syntax

selection = window.getSelection() ;

• selection は Selection オブジェクトです。

[編集] Example

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

[編集] Notes

JavaScript では、文字列を引数にとる関数(window.alert や document.write)に selection オブジェクトが渡されるとき、selection オブジェクトのかわりにそのオブジェクトと対応する文字列(たとえば、選択範囲の文字列)が渡されます。このために、それが実際には独自のプロパティやメソッドを持っているオブジェクトであるにもかかわらず、selection オブジェクトは文字列のように見えることもあります。しかしこれは、正確にはtoString() の返り値が渡されているのです。

上の例では、selObj が window.alert に渡されるときに自動的に「変換されて」います。しかし、JavaScript の String プロパティや、length・substr などといったメソッドを使用する際には、明示的にtoStringを呼び出す必要があります。

[編集] Specification

DOM Level 0. Not part of specification.

[編集] See also

Selection, Range