Range.extractContents() - コンテンツを切り取る
extractContents()は、Rangeのメソッドです。範囲のコンテンツを切り取って、それを子ノードに持つDocumentFragmentを返します。
概要
- 名前
- extractContents
- 所属
- Range
- IDL
[CEReactions, NewObject] DocumentFragment extractContents();
- 仕様書
- https://dom.spec.whatwg.org/#dom-range-extractcontents
説明
引数はありません。範囲のコンテンツを子ノードに持つ新しいDocumentFragmentを返します。
チュートリアル
始点と終点の位置により、切り取りの内容が違うのでご注意下さい。例えば、下記のようにp要素の直前、直後に始点と終点がある場合、メソッドを実行すると、p要素ごと切り取られます。
|始点|<p>SYNCER</p>|終点|
下記のようにp要素の先頭、末尾(テキストノードの直前、直後)に始点と終点がある場合、メソッドを実行すると、p要素の中身だけが切り取られて空の要素が残ります。
<p>|始点|SYNCER|終点|</p>
デモ
Range.extractContents()のデモです。選択範囲をRangeで表現したオブジェクトにメソッドを実行します。テキストを選択すると3秒後にメソッドが実行されて、その範囲のコンテンツを切り取ります。返り値のDocumentFragmentの内容を別の場所に表示します。
<!-- このコードは編集できます。 -->
<!DOCTYPE html>
<head>
<style>
body { word-break: break-all ; tab-size: 2 ; }
div#result { white-space: pre-wrap ; }
</style>
</head>
<body>
<div>
<p>12345678901234567890</p>
</div>
<hr>
<div id="result"></div>
<script>
var selection = getSelection() ;
var timeoutId ;
document.onselectionchange = function () {
getRangeInfo() ;
clearTimeout( timeoutId ) ;
timeoutId = setTimeout( function() {
var range = selection.getRangeAt(0) ;
getRangeInfo() ;
var documentFragment = range.extractContents() ;
console.log( documentFragment ) ;
appendText( documentFragment + "\n" ) ;
for( var i=0,l=documentFragment.childNodes.length; l>i; i++ ) {
appendText( "\t" + "childNodes[" + i + "]" + documentFragment.childNodes[i] + "\n" ) ;
appendText( "\t" + "childNodes[" + i + "].data: " + documentFragment.childNodes[i].data + "\n" ) ;
}
}, 3000 ) ;
}
function getRangeInfo() {
document.getElementById( "result" ).textContent = "" ;
var range = selection.getRangeAt(0) ;
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\n" ) ;
}
function appendText ( text ) {
document.getElementById( "result" ).appendChild( document.createTextNode( text ) ) ;
}
</script>
</body>
</html>
サポート状況
Chrome | Firefox | Safari | Edge | IE | Opera | iOS Safari | Android |
---|---|---|---|---|---|---|---|
● | ● | ● | ● | ● | ● | ● | ● |
関連記事
- Range.selectNode()
- selectNode()は、Rangeのメソッドです。ノードの直前に始点を、直後に終点を設定します。
- Range.commonAncestorContainer
- commonAncestorContainerは、Rangeのプロパティです。始点と終点を共通して含む、最も近い祖先ノードを返します。
- Selection.containsNode()
- containsNode()は、Selectionのメソッドです。選択範囲があるノードを含んでいるか否かを確認します。
- Selection.selectAllChildren()
- selectAllChildren()は、Selectionのメソッドです。あるノードの内側を選択範囲にセットします。