Range.selectNode() - ノードの外側に始点と終点を設定する
selectNode()は、Rangeのメソッドです。ノードの直前に始点を、直後に終点を設定します。
概要
- 名前
- selectNode
- 所属
- Range
- IDL
void selectNode(Node node);
- 仕様書
- https://dom.spec.whatwg.org/#dom-range-selectnode
説明
引数(node)には、対象のノードを指定します。このノードの直前、直後に始点と終点が設定されます。
チュートリアル
直前、直後とはノードの外側です。例えば下記のp要素を引数にした場合、要素の直前、直後、つまり外側に始点と終点が設定されます。この場合、コンテナ(startContainer、endContainer)はdiv要素ということになります。
<div>
|始点|<p>hoge fuga piyo</p>|終点|
</div>
p要素内のテキストノードを引数にした場合、下記のように始点、終点が設定され、コンテナ(startContainer、endContainer)はp要素になります。
<div>
<p>|始点|hoge fuga piyo|終点|</p>
</div>
デモ
Range.selectNode()のデモです。選択範囲をRangeで表現したオブジェクトにメソッドを実行します。テキストを選択してみて下さい。1つ目のp要素の中にあるテキストノードを引数にメソッドを実行しています。そのため、始点、終点はこのテキストノードの直前、直後になり、startContainer、endContainerの値は共にp要素になっているのを確認しましょう。
<!-- このコードは編集できます。 -->
<!DOCTYPE html>
<head>
<style>
body { word-break: break-all ; }
div#result { white-space: pre-wrap ; }
</style>
</head>
<body>
<div>
<p>1234567890</p>
<p>あいうえおかきくけこ</p>
<p>abcdefghij</p>
<p>ABCDEFGHIJ</p>
</div>
<hr>
<div id="result"></div>
<script>
document.onselectionchange = function () {
document.getElementById( "result" ).textContent = "" ;
var selection = getSelection() ;
var range = selection.getRangeAt(0) ;
var element = document.getElementsByTagName( "p" )[0] ; // p要素
var textNode = element.childNodes[0] ; // テキストノード ("ABCDEFGHIJ")
range.selectNode( textNode ) ;
console.log( range ) ;
appendText( range + "\n\n" ) ;
appendText( "startContainer: " + range.startContainer + "\n" ) ;
appendText( "startContainer.data: " + range.startContainer.data + "\n" ) ;
appendText( "startOffset: " + range.startOffset + "\n" ) ;
appendText( "endContainer: " + range.endContainer + "\n" ) ;
appendText( "endContainer.data: " + range.endContainer.data + "\n" ) ;
appendText( "endOffset: " + range.endOffset + "\n" ) ;
appendText( "collapsed: " + range.collapsed + "\n" ) ;
appendText( "commonAncestorContainer: " + range.commonAncestorContainer + "\n" ) ;
appendText( "commonAncestorContainer.data: " + range.commonAncestorContainer.data + "\n" ) ;
}
function appendText ( text ) {
document.getElementById( "result" ).appendChild( document.createTextNode( text ) ) ;
}
</script>
</body>
</html>
サポート状況
Chrome | Firefox | Safari | Edge | IE | Opera | iOS Safari | Android |
---|---|---|---|---|---|---|---|
● | ● | ● | ● | ● | ● | ● | ● |
関連記事
- Range.setEnd()
- setEnd()は、Rangeのメソッドです。終点を位置で設定します。
- Range.endContainer
- endContainerは、Rangeのプロパティです。終点を含むノードを返します。
- Range.selectNodeContents()
- selectNodeContents()は、Rangeのメソッドです。ノードの先頭に始点を、末尾に終点を設定します。
- 指定文字を置換、削除する
- 文字列の中の指定した部分を置換したり削除します。