Range.setStartBefore() - 始点をノードの直前に設定する

2017/10/16

setStartBefore()は、Rangeのメソッドです。始点を、ノードの直前に設定します。直前というのはノードの外側です。

概要

名前

setStartBefore

所属

IDL

void setStartBefore(Node node);

仕様書

https://dom.spec.whatwg.org/#dom-range-setstartbefore

説明

引数(node)には、対象のノードを指定する。このノードの直前が始点に設定される。

チュートリアル

直前とはノードの外側です。例えば下記のp要素を引数にした場合、要素の直前、つまり外側に始点が設定されます。この場合、コンテナ(startContainer)はdiv要素ということになります。

<div>
	|始点|<p>hoge fuga piyo</p>
</div>

p要素内のテキストノードを引数にした場合、下記のように始点が設定され、コンテナ(startContainer)はp要素になります。

<div>
	<p>|始点|hoge fuga piyo</p>
</div>

デモ

Range.setStartBefore()のデモです。選択範囲をRangeで表現したオブジェクトにメソッドを実行します。テキストを選択してみて下さい。1つ目のp要素の中にあるテキストノードを引数にメソッドを実行しています。そのため、始点はこのテキストノードの直前(外側)になり、startContainerの値は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] ;	// テキストノード ("1234567890")
	range.setStartBefore( 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>