DOM:range
出典: MDC
Range オブジェクトとはdocument の断片で、ある document 中の node や text node の一部を含むことのできるものです。
range は Document オブジェクトの createRange メソッドにより生成することができます。また、selection オブジェクトの getRangeAt メソッドにより取得することもできます。
目次 |
[編集] Properties
- collapsed
- range の始点と終点が同じ位置にあるか、boolean値を返します。
- commonAncestorContainer
- startContainer と endContainer をともに含む、最も深い Node を返します。
- endContainer
- Range の終点を含む Node を返します。
- endOffset
- endContainer の中での Range の終点の位置を示す数字を返します。
- startContainer
- Range の始点を含む Node を返します。
- startOffset
- startContainer の中での Range の始点の位置を示す数字を返します。
[編集] Methods
[編集] Positioning Methods
これらのメソッドは、range の始点と終点を操作するためのものです。
- setStart
- Range の始点を set します。
- setEnd
- Range の終点を set します。
- setStartBefore
- 他の Node を基準に Range の始点を set します。
- setStartAfter
- 他の Node を基準に Range の始点を set します。
- setEndBefore
- 他の Node を基準に Range の終点を set します。
- setEndAfter
- 他の Node を基準に Range の終点を set します。
- selectNode
- Range を、ある node とその内容を含むように set します。
- selectNodeContents
- Range を、ある node の内容を含むように set します。
- collapse
- Range をその端点の一方へ折りたたみます。
[編集] Editing Methods
これらのメソッドは、range から Node を取得し、range の内容を変更するものです。
- cloneContents
- Range の中身をコピーした document fragment を返します。
- deleteContents
- Range の中身を document から削除します。
- extractContents
- Range の中身を document の tree から document fragment に移動します。
- insertNode
- Range の始点に node を挿入します。
- surroundContents
- Range の中身を 新しい node の中に移動します。
[編集] Other Methods
- compareBoundaryPoints
- 2つの range の端点の位置を比較します。
- cloneRange
- 元の range と同じ端点を持つ range オブジェクトを返します。
- detach
- パフォーマンスを改善するために、range を使用状態から開放します。
- toString
- Range の内容を文字列として返します。
[編集] Gecko Methods
ここでは、Rangeのメソッドのうち、Mozilla 独自の、W3C DOM 仕様には含まれないものを解説します。
- compareNode 廃止
- node が range の前にあるか、後にあるか、中にあるか、外にあるかを示す定数を返します。
- comparePoint
- 指定された点が range の前にあるか、中にあるか、後にあるかを -1, 0, 1で示します。
- createContextualFragment
- 渡された文字列をXML (or HTML) コードとして解釈し、document fragment として返します。
- intersectsNode 廃止
- Returns a boolean indicating whether the given node intersects the range.
- isPointInRange
- 与えられた点が range の中にあるか、boolean 値を返します。