SYNCERのロゴ
アイキャッチ画像

Range.comparePoint() - ポイントとの位置関係を比較する

comparePoint()は、Rangeのメソッドです。ポイントと範囲の位置関係を比較します。

概要

名前
comparePoint
所属
Range
IDL
short comparePoint(Node node, unsigned long offset);
仕様書
https://dom.spec.whatwg.org/#dom-range-ispointinrange

説明

第1引数(node)には、ポイントを含むノードを指定します。

第2引数(offset)には、ポイントの位置を意味する、ノードの先頭からのオフセット(文字数)を指定します。

返り値は下記の3種類です。

-1
ポイントは、自身の始点よりも前にある。
0
-1でも1でもない。
1
ポイントは、自身の終点よりも後にある。

デモ

Range.comparePoint()のデモです。選択範囲をRangeで表現したオブジェクトにメソッドを実行します。選択範囲と、「お」と「か」の間のポイントとの位置関係を比較します。

<!-- このコードは編集できます。 -->

<!DOCTYPE html>
<head>
<style>
body { word-break: break-all ; tab-size: 2 ; }
div#result { white-space: pre-wrap ; }
</style>
</head>
<body>
<div>
<p>あいうえおかきくけこ</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] ;
	var textNode = element.childNodes[0] ;	// "あいうえおかきくけこ"
	var retuenValue = range.comparePoint( textNode, 5 ) ;

	console.log( range ) ;
	console.log( retuenValue ) ;
	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" ) ;
	appendText( "comparePoint( textNode, 5 ): " + retuenValue + "\n\n" ) ;
}

function appendText ( text ) {
	document.getElementById( "result" ).appendChild( document.createTextNode( text ) ) ;
}
</script>
</body>
</html>

サポート状況

ChromeFirefoxSafariEdgeIEOperaiOS SafariAndroid
××
  • Twitterでシェア
  • Facebookでシェア
  • Google+でシェア
  • はてなブックマークでシェア
  • pocketに保存
  • LINEでシェア
更新履歴
2017年10月16日 (月)
コンテンツを公開しました。