|
Common DOM API | ||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||||
Element インタフェースは、HTML または XML ドキュメントの要素を表します。要素は、ドキュメントに関連付けられた属性を持っています。Element インタフェースは Node から継承するので、一般的な Node インタフェース属性 attributes は、要素のすべての属性セットを取得するために使用されます。Element インタフェースには、名前によって Attr オブジェクトを取得するか、名前によって属性値を取得するメソッドがあります。XML では、属性値にエンティティ参照が含まれる場合、属性値を表すかなり複雑なサブツリーを調べるために Attr オブジェクトを取得する必要があります。一方 HTML では、すべての属性が簡単な文字列の値を持つところでは、直接属性値にアクセスするメソッドが便利かつ安全に使用できなければなりません。DOM Level 2 では、normalize メソッドが移動した Node インタフェースから継承されます。
詳細については、 「Document Object Model (DOM) Level 2 Core Specification」 も参照してください。
| フィールドの概要 |
| インタフェース org.w3c.dom.Node から継承したフィールド |
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE |
| メソッドの概要 | |
String |
getAttribute(String name)
属性値を名前で取得します。 |
Attr |
getAttributeNode(String name)
指定された名前を持つ属性ノードを取得します。 |
Attr |
getAttributeNodeNS(String namespaceURI,
String localName)
ローカル名と名前空間 URI を指定して Attr ノードを取得します。 |
String |
getAttributeNS(String namespaceURI,
String localName)
ローカル名と名前空間 URI を指定して属性値を取得します。 |
NodeList |
getElementsByTagName(String name)
指定されたタグ名を持つすべての子孫 Elements が格納された NodeList を返しますが、これらの要素は、Element ツリーのあらかじめ順序が決められたトラバーサルで得られた順番で格納されます。 |
NodeList |
getElementsByTagNameNS(String namespaceURI,
String localName)
指定されたローカル名と名前空間 URI を持つすべての子孫 Elements が格納された NodeList を返しますが、それらの要素は、この Element ツリーの行きがけ順トラバーサルで得られた順番で格納されます。 |
String |
getTagName()
たとえば、要素の名前は次のようになります。 |
boolean |
hasAttribute(String name)
指定された名前がこの要素で指定されているか、またはデフォルト値を持つ場合は true、そうでない場合は false を返します。 |
boolean |
hasAttributeNS(String namespaceURI,
String localName)
指定されたローカル名と名前空間 URI を持つ属性がこの要素に指定されている場合、またはその属性がデフォルト値を持つ場合は true を返し、そうでない場合は false を返します。 |
void |
removeAttribute(String name)
指定された名前を持つ属性を削除します。 |
Attr |
removeAttributeNode(Attr oldAttr)
指定された属性ノードを削除します。 |
void |
removeAttributeNS(String namespaceURI,
String localName)
ローカル名と名前空間 URI を指定して属性を削除します。 |
void |
setAttribute(String name,
String value)
新しい属性を追加します。 |
Attr |
setAttributeNode(Attr newAttr)
新しい属性ノードを追加します。 |
Attr |
setAttributeNodeNS(Attr newAttr)
新しい属性を追加します。 |
void |
setAttributeNS(String namespaceURI,
String qualifiedName,
String value)
新しい属性を追加します。 |
| インタフェース org.w3c.dom.Node から継承したメソッド |
appendChild, cloneNode, getAttributes, getChildNodes, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, hasAttributes, hasChildNodes, insertBefore, isSupported, normalize, removeChild, replaceChild, setNodeValue, setPrefix |
| メソッドの詳細 |
public String getTagName()
<elementExample id="demo"> ... </elementExample> ,
tagName は、値 "elementExample" を持ちます。これは、DOM のすべてのオペレーションと同様に XML では大文字小文字を区別します。HTML DOM は、HTML ソースドキュメントの文字形式にかかわらず、HTML 要素の tagName を標準的な大文字形式で返します。
public String getAttribute(String name)
name - 取得する属性の名前
Attr の値 (文字列)、そうでない場合は空の文字列
public void setAttribute(String name,
String value)
throws DOMException
Attr ノードに任意の Text と EntityReference ノードを加え、適切なサブツリーを構築し、それを setAttributeNode を使って属性値として設定する必要があります。setAttributeNS メソッドを使います。
name - 作成または変更する属性名value - 設定する文字列値
DOMException - INVALID_CHARACTER_ERR: 指定された名前に不正な文字が含まれている場合に発行される
public void removeAttribute(String name)
throws DOMException
removeAttributeNS メソッドを使います。
name - 削除する属性の名前
DOMException - NO_MODIFICATION_ALLOWED_ERR: このノードが読み取り専用の場合に発行されるpublic Attr getAttributeNode(String name)
getAttributeNodeNS メソッドを使います。
name - 取得する属性の名前 (nodeName)
nodeName) を持つ属性が存在する場合はその Attr ノード、そうでない場合は null
public Attr setAttributeNode(Attr newAttr)
throws DOMException
nodeName) の属性が要素内にすでに存在する場合、その既存の属性は新しい属性で置換されます。setAttributeNodeNS メソッドを使います。
newAttr - 属性リストに追加する Attr ノード
newAttr 属性が既存の属性を置き換える場合は置き換えられた Attr ノード、そうでない場合は null
DOMException - WRONG_DOCUMENT_ERR: newAttr を作成したドキュメントがこの要素を作成したドキュメントと異なっている場合に発行されるnewAttr がすでに別の Element オブジェクトの属性として使われている場合に発行される。DOM ユーザは、目的の Attr ノードを明示的にコピーしないと、ほかの要素内でそれを再利用できない
public Attr removeAttributeNode(Attr oldAttr)
throws DOMException
Attr がデフォルト値を持っている場合は、直ちに置き換えられます。置き換える属性は、元の接頭辞 (適用可能な場合) とともに、同じ URI 名前空間とローカル名を持ちます。
oldAttr - 属性リストから削除する Attr ノード
Attr ノード
DOMException - NO_MODIFICATION_ALLOWED_ERR: このノードが読み取り専用の場合に発行される oldAttr がその要素の属性でない場合に発行されるpublic NodeList getElementsByTagName(String name)
Elements が格納された NodeList を返しますが、これらの要素は、Element ツリーのあらかじめ順序が決められたトラバーサルで得られた順番で格納されます。
name - 一致させるタグ名。特殊な値 "*" はすべてのタグに一致する
Element ノードのリスト
public String getAttributeNS(String namespaceURI,
String localName)
namespaceURI - 取得する属性の名前空間 URIlocalName - 取得する属性のローカル名
Attr の値 (文字列)、そうでない場合は空の文字列
public void setAttributeNS(String namespaceURI,
String qualifiedName,
String value)
throws DOMException
qualifiedName の接頭辞部に変更され、その値が value パラメータに変更されます。この値は簡単な文字列です。設定されたとおりに構文解析されません。このように、すべてのマークアップ (エンティティ参照として認識される構文など) がリテラル文字列として扱われ、書き出されるときには実装によって適切にエスケープされる必要があります。エンティティ参照を含む属性値を割り当てるためには、ユーザは Attr ノードに任意の Text と EntityReference ノードを加え、適切なサブツリーを構築し、setAttributeNodeNS または setAttributeNode を使用してそれを属性値として割り当てる必要があります。
namespaceURI - 作成または変更する属性の名前空間 URIqualifiedName - 作成または変更する属性の修飾名value - 設定する文字列値
DOMException - INVALID_CHARACTER_ERR: 指定された修飾名に XML 1.0 仕様で規定されていない文字が含まれている場合に発行されるqualifiedName の形式が Namespaces in XML 仕様に準拠していない場合、qualifiedName に接頭辞が含まれているのに namespaceURI が null である場合、qualifiedName の接頭辞が「xml」であるのに namespaceURI が「http://www.w3.org/XML/1998/namespace」でない場合、または qualifiedName またはその接頭辞が「xmlns」であるのに namespaceURI が「http://www.w3.org/2000/xmlns/」でない場合に発行されるXML 機能をサポートしていない場合は、無条件に発行される
public void removeAttributeNS(String namespaceURI,
String localName)
throws DOMException
namespaceURI - 削除する属性の名前空間 URIlocalName - 削除する属性のローカル名
DOMException - NO_MODIFICATION_ALLOWED_ERR: このノードが読み取り専用の場合に発行される
public Attr getAttributeNodeNS(String namespaceURI,
String localName)
Attr ノードを取得します。
namespaceURI - 取得する属性の名前空間 URIlocalName - 取得する属性のローカル名
Attr ノード、そうでない場合は null
public Attr setAttributeNodeNS(Attr newAttr)
throws DOMException
newAttr - 属性リストに追加する Attr ノード
newAttr 属性が同じローカル名と URI 名前空間を持つ既存の属性を置き換える場合、置き換えられた Attr ノードが返されます。そうでない場合は、null が返されます。
DOMException - WRONG_DOCUMENT_ERR: newAttr を作成したドキュメントがこの要素を作成したドキュメントと異なっている場合に発行されるnewAttr がすでに別の Element オブジェクトの属性として使われている場合に発行される。DOM ユーザは、目的の Attr ノードを明示的にコピーしないと、ほかの要素内でそれを再利用できないXML 機能をサポートしていない場合は、無条件に発行される
public NodeList getElementsByTagNameNS(String namespaceURI,
String localName)
Elements が格納された NodeList を返しますが、それらの要素は、この Element ツリーの行きがけ順トラバーサルで得られた順番で格納されます。
namespaceURI - 一致させる要素の URI 名前空間。特殊な値 "*" はすべての名前空間に一致するlocalName - 一致させる要素のローカル名。特殊な値 "*" は、すべてのローカル名に一致する
Elements を含む新しい NodeList オブジェクトpublic boolean hasAttribute(String name)
true、そうでない場合は false を返します。
name - 検索する属性の名前
true、そうでない場合は false
public boolean hasAttributeNS(String namespaceURI,
String localName)
true を返し、そうでない場合は false を返します。
namespaceURI - 検索する属性の名前空間 URIlocalName - 検索する属性のローカル名
true、そうでない場合は false
|
Common DOM API | ||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||||