Range.setStart() - 始点を位置で設定する
setStart()は、Rangeのメソッドです。始点を位置で設定します。
概要
- 名前
- setStart
- 所属
- Range
- IDL
void setStart(Node node, unsigned long offset);
- 仕様書
- https://dom.spec.whatwg.org/#dom-range-setstart
説明
第1引数(node)には、始点を含むノード(startContainer)を指定します。
第2引数(offset)には、ノードの先頭からのオフセット(startOffset)を数値で指定します。
デモ
Range.setStart()のデモです。選択範囲をRangeで表現したオブジェクトにメソッドを実行します。テキストを選択してみて下さい。メソッドを実行するため、startOffsetの値が必ず2になるのを確認して下さい。
<!-- このコードは編集できます。 -->
<!DOCTYPE html>
<head>
<style>
body { word-break: break-all ; }
div#result { white-space: pre-wrap ; }
</style>
</head>
<body>
<p>1234567890<br>あいうえおかきくけこ<br>abcdefghij<br>ABCDEFGHIJ</p>
<hr>
<div id="result"></div>
<script>
document.onselectionchange = function () {
document.getElementById( "result" ).textContent = "" ;
var selection = getSelection() ;
var range = selection.getRangeAt(0) ;
var node = range.startContainer ;
range.setStart( node, 2 ) ; // 引数を調整してみよう!
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
- Rangeは、範囲を管理するための機能を備えたインターフェイスです。
- Range.insertNode()
- insertNode()は、Rangeのメソッドです。範囲の始点にノードを挿入します。
- Range.surroundContents()
- surroundContents()は、Rangeのメソッドです。範囲のコンテンツの周りをノードで囲みます。