|
共通 DOM API | |||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
public interface Range
「Document Object Model (DOM) Level 2 Traversal and Range Specification」も参照してください。
| フィールドの概要 | |
|---|---|
static short |
END_TO_END
sourceRange の終了境界点と compareBoundaryPoints が呼び出される Range の終了境界点を比較します。 |
static short |
END_TO_START
sourceRange の終了境界点と compareBoundaryPoints が呼び出される Range の開始境界点を比較します。 |
static short |
START_TO_END
sourceRange の開始境界点と compareBoundaryPoints が呼び出される Range の終了境界点を比較します。 |
static short |
START_TO_START
sourceRange の開始境界点と compareBoundaryPoints が呼び出される Range の開始境界点を比較します。 |
| メソッドの概要 | |
|---|---|
DocumentFragment |
cloneContents()
Range の内容を複製します。 |
Range |
cloneRange()
この Range の境界点と同等の境界点を持つ新規 Range を作成します。 |
void |
collapse(boolean toStart)
境界点の 1 つに Range を折りたたみます。 |
short |
compareBoundaryPoints(short how,
Range sourceRange)
ドキュメントの 2 つの Range の境界点を比較します。 |
void |
deleteContents()
削除された内容への参照を返すことなく、含まれているドキュメントまたはドキュメントのフラグメントから Range の内容を削除します。 |
void |
detach()
Range が現在では使用されていないことおよび実装がこの Range に関連するリソースを放棄する可能性があることを示すために呼び出されます。 |
DocumentFragment |
extractContents()
含まれているドキュメントまたはドキュメントのフラグメントから Range の内容を移動します。 |
boolean |
getCollapsed()
Range が折りたたまれている場合は true。 |
Node |
getCommonAncestorContainer()
Range の 2 つの境界点のもっとも深い共通祖先コンテナ。 |
Node |
getEndContainer()
内部で Range が終了するノード。 |
int |
getEndOffset()
Range の終了ノード内のオフセット。 |
Node |
getStartContainer()
内部で Range が始まるノード。 |
int |
getStartOffset()
Range の開始ノード内のオフセット。 |
void |
insertNode(Node newNode)
ノードを Document または DocumentFragment の Range の開始位置に挿入します。 |
void |
selectNode(Node refNode)
ノードとその内容を選択します。 |
void |
selectNodeContents(Node refNode)
ノード内の内容を選択します。 |
void |
setEnd(Node refNode,
int offset)
Range の終了を記述する属性を設定します。 |
void |
setEndAfter(Node refNode)
Range の終了をノードのあとに設定します。 |
void |
setEndBefore(Node refNode)
終了位置をノードの前に設定します。 |
void |
setStart(Node refNode,
int offset)
Range の開始を記述する属性を設定します。 |
void |
setStartAfter(Node refNode)
開始位置をノードのあとに設定します。 |
void |
setStartBefore(Node refNode)
開始位置をノードの前に設定します。 |
void |
surroundContents(Node newParent)
Range の内容を所定のノードの親として再設定し、再設定したノードを Range の開始位置に挿入します。 |
String |
toString()
Range の内容を文字列として返します。 |
| フィールドの詳細 |
|---|
static final short START_TO_START
sourceRange の開始境界点と compareBoundaryPoints が呼び出される Range の開始境界点を比較します。
static final short START_TO_END
sourceRange の開始境界点と compareBoundaryPoints が呼び出される Range の終了境界点を比較します。
static final short END_TO_END
sourceRange の終了境界点と compareBoundaryPoints が呼び出される Range の終了境界点を比較します。
static final short END_TO_START
sourceRange の終了境界点と compareBoundaryPoints が呼び出される Range の開始境界点を比較します。
| メソッドの詳細 |
|---|
Node getStartContainer()
throws DOMException
DOMException - INVALID_STATE_ERR: このオブジェクト上ですでに detach() が呼び出されている場合に発生する
int getStartOffset()
throws DOMException
DOMException - INVALID_STATE_ERR: このオブジェクト上ですでに detach() が呼び出されている場合に発生する
Node getEndContainer()
throws DOMException
DOMException - INVALID_STATE_ERR: このオブジェクト上ですでに detach() が呼び出されている場合に発生する
int getEndOffset()
throws DOMException
DOMException - INVALID_STATE_ERR: このオブジェクト上ですでに detach() が呼び出されている場合に発生する
boolean getCollapsed()
throws DOMException
DOMException - INVALID_STATE_ERR: このオブジェクト上ですでに detach() が呼び出されている場合に発生する
Node getCommonAncestorContainer()
throws DOMException
DOMException - INVALID_STATE_ERR: このオブジェクト上ですでに detach() が呼び出されている場合に発生する
void setStart(Node refNode,
int offset)
throws RangeException,
DOMException
refNode - refNode 値。このパラメータは null 以外でなければならないoffset - startOffset 値
RangeException - INVALID_NODE_TYPE_ERR: refNode または refNode の祖先が Entity、Notation、または DocumentType ノードの場合に発生する
DOMException - INDEX_SIZE_ERR: offset が負であるか、refNode の子の単位数よりも大きい場合に発生する。refNode が CharacterData ノード (例、Text または Comment ノード) または ProcessingInstruction ノードの型の場合、子の単位は16 ビット単位である。ほかのすべてのケースで、子の単位は Nodes であるdetach() が呼び出されている場合に発生する refNodeが、この範囲が生成されたドキュメントとは異なるドキュメントから生成された場合に発生する
void setEnd(Node refNode,
int offset)
throws RangeException,
DOMException
refNode - refNode 値。このパラメータは null 以外でなければならないoffset - endOffset 値
RangeException - INVALID_NODE_TYPE_ERR: refNode または refNode の祖先が Entity、Notation、または DocumentType ノードの場合に発生する
DOMException - INDEX_SIZE_ERR: offset が負であるか、refNode の子の単位数よりも大きい場合に発生する。refNode が CharacterData ノード (例、Text または Comment ノード) または ProcessingInstruction ノードの型の場合、子の単位は16 ビット単位である。ほかのすべてのケースで、子の単位は Nodes であるdetach() が呼び出されている場合に発生する refNodeが、この範囲が生成されたドキュメントとは異なるドキュメントから生成された場合に発生する
void setStartBefore(Node refNode)
throws RangeException,
DOMException
refNode - Range は refNode の前から始まる
RangeException - INVALID_NODE_TYPE_ERR: refNode が Attr、Document、または DocumentFragment ノードではない場合、または refNode が Document、DocumentFragment、Attr、Entity、または Notation ノードの場合に発生する
DOMException - INVALID_STATE_ERR: detach() がこのオブジェクト上ですでに呼び出されている場合に発生する refNode が、この範囲を生成したドキュメントとは異なるドキュメントから が生成された場合に発生する
void setStartAfter(Node refNode)
throws RangeException,
DOMException
refNode - Range は refNode のあとから始まる
RangeException - INVALID_NODE_TYPE_ERR: refNode が Attr、Document、または DocumentFragment ノードではない場合、または refNode が Document、DocumentFragment、Attr、Entity、または Notation ノードの場合に発生する
DOMException - INVALID_STATE_ERR: detach() がこのオブジェクト上ですでに呼び出されている場合に発生する refNode が、この範囲を生成したドキュメントとは異なるドキュメントから が生成された場合に発生する
void setEndBefore(Node refNode)
throws RangeException,
DOMException
refNode - Range は refNode の前で終わる
RangeException - INVALID_NODE_TYPE_ERR: refNode が Attr、Document、または DocumentFragment ノードではない場合、または refNode が Document、DocumentFragment、Attr、Entity、または Notation ノードの場合に発生する
DOMException - INVALID_STATE_ERR: detach() がこのオブジェクト上ですでに呼び出されている場合に発生する refNode が、この範囲を生成したドキュメントとは異なるドキュメントから が生成された場合に発生する
void setEndAfter(Node refNode)
throws RangeException,
DOMException
refNode - Range は refNode のあとで終わる
RangeException - INVALID_NODE_TYPE_ERR: refNode が Attr、Document、または DocumentFragment ノードではない場合、または refNode が Document、DocumentFragment、Attr、Entity、または Notation ノードの場合に発生する
DOMException - INVALID_STATE_ERR: detach() がこのオブジェクト上ですでに呼び出されている場合に発生する refNode が、この範囲を生成したドキュメントとは異なるドキュメントから が生成された場合に発生する
void collapse(boolean toStart)
throws DOMException
toStart - true の場合、Range を開始境界点に折りたたみ、false の場合、終了境界点に折りたたむ
DOMException - INVALID_STATE_ERR: このオブジェクト上ですでに detach() が呼び出されている場合に発生する
void selectNode(Node refNode)
throws RangeException,
DOMException
refNode - 選択するノード
RangeException - INVALID_NODE_TYPE_ERR: refNode の祖先が Entity、Notation、または DocumentType ノードの場合、または refNode が Document、DocumentFragment、Attr、Entity、または Notation ノードの場合に発生する
DOMException - INVALID_STATE_ERR: detach() がこのオブジェクト上ですでに呼び出されている場合に発生する refNode が、この範囲を生成したドキュメントとは異なるドキュメントから が生成された場合に発生する
void selectNodeContents(Node refNode)
throws RangeException,
DOMException
refNode - 内容が選択されるノード
RangeException - INVALID_NODE_TYPE_ERR: refNode または refNode の祖先が Entity、Notation、または DocumentType ノードの場合に発生する
DOMException - INVALID_STATE_ERR: detach() がこのオブジェクト上ですでに呼び出されている場合に発生する refNode が、この範囲を生成したドキュメントとは異なるドキュメントから が生成された場合に発生する
short compareBoundaryPoints(short how,
Range sourceRange)
throws DOMException
how - 前述のように比較の種類を表すコードsourceRange - 現在の Range の比較対象の Range
sourceRange の対応する境界点の前、同等、またはあとかに応じて、それぞれ -1、0、または 1
DOMException - WRONG_DOCUMENT_ERR: 2 つの Range が同じ Document または DocumentFragment にない場合に発生する detach() がこのオブジェクト上ですでに呼び出されている場合に発生する
void deleteContents()
throws DOMException
DOMException - NO_MODIFICATION_ALLOWED_ERR: Range の内容の一部が読み取り専用の場合、または Range の内容を含むノードのどれかが読み取り専用の場合に発生するdetach() がこのオブジェクト上ですでに呼び出されている場合に発生する
DocumentFragment extractContents()
throws DOMException
DOMException - NO_MODIFICATION_ALLOWED_ERR: Range の内容の一部が読み取り専用の場合、または Range の内容を含むノードのどれかが読み取り専用の場合に発生するdetach() がこのオブジェクト上ですでに呼び出されている場合に発生する
DocumentFragment cloneContents()
throws DOMException
DOMException - HIERARCHY_REQUEST_ERR: DocumentType ノードが新しい DocumentFragment に抽出される場合に発生する detach() がこのオブジェクト上ですでに呼び出されている場合に発生する
void insertNode(Node newNode)
throws DOMException,
RangeException
newNode - Range の開始位置に挿入されるノード
DOMException - NO_MODIFICATION_ALLOWED_ERR: Range の開始の祖先コンテナが読み取り専用の場合に発生する newNode および Range の開始のコンテナが同じドキュメントから作成されていなかった場合に発生する newNode の型の子を許可しない型のコンテナの場合、または newNode がコンテナの祖先である場合に発生する detach() がこのオブジェクト上ですでに呼び出されている場合に発生する
RangeException - INVALID_NODE_TYPE_ERR: newNode が Attr、Entity、Notation、または Document ノードの場合に発生する
void surroundContents(Node newParent)
throws DOMException,
RangeException
newParent - 内容を囲むノード
DOMException - NO_MODIFICATION_ALLOWED_ERR: Range のどちらかの境界点の祖先コンテナが読み取り専用の場合に発生する newParent と Range の開始のコンテナが同じドキュメントから作成されなかった場合に発生する newParent の型の子を許可しない型のコンテナである場合、または newParent がコンテナの祖先の場合、あるいは node が、node の型によって許可されていない型の子ノードで終わる場合に発生する detach() がこのオブジェクト上ですでに呼び出されている場合に発生する
RangeException - BAD_BOUNDARYPOINTS_ERR: Range が部分的にテキスト以外のノードを選択した場合に発生する node が Attr、Entity、DocumentType、Notation、Document、または DocumentFragment ノードの場合に発生する
Range cloneRange()
throws DOMException
DOMException - INVALID_STATE_ERR: このオブジェクト上ですでに detach() が呼び出されている場合に発生する
String toString()
throws DOMException
Object 内の toStringDOMException - INVALID_STATE_ERR: このオブジェクト上ですでに detach() が呼び出されている場合に発生する
void detach()
throws DOMException
INVALID_STATE_ERR で DOMException がスローされます。
DOMException - INVALID_STATE_ERR: このオブジェクト上ですでに detach() が呼び出されている場合に発生する
|
共通 DOM API | |||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||