- 既知のすべてのサブインタフェース:
DOMImplementationCSS
,HTMLDOMImplementation
public interface DOMImplementation
DOMImplementation
インタフェースは、文書オブジェクト・モデルの特定のインスタンスに依存しない操作を実行するためのメソッドをいくつか提供します。
「Document Object Model (DOM) Level 3 Core Specification」も参照してください。
-
メソッドのサマリー
修飾子と型メソッド説明createDocument(String namespaceURI, String qualifiedName, DocumentType doctype)
指定された型のDOM Documentオブジェクトとその文書要素を作成します。createDocumentType(String qualifiedName, String publicId, String systemId)
空のDocumentType
ノードを作成します。getFeature(String feature, String version)
このメソッドは、指定した機能とバージョンを持つ特殊な形式のAPIを、DOM Featuresで指定されたとおりに実装する特殊な形式のオブジェクトを返します。boolean
hasFeature(String feature, String version)
DOM実装が特定の機能とバージョンを「DOM Features」で指定されたとおりに実装しているかどうかをテストします。
-
メソッドの詳細
-
hasFeature
DOM実装が特定の機能とバージョンを「DOM Features」で指定されたとおりに実装しているかどうかをテストします。- パラメータ:
feature
- テストする機能の名前。version
- テストする機能のバージョン番号。- 戻り値:
- この機能が指定されたバージョンで実装されている場合は
true
。それ以外の場合はfalse
。
-
createDocumentType
DocumentType createDocumentType(String qualifiedName, String publicId, String systemId) throws DOMException空のDocumentType
ノードを作成します。 エンティティ宣言およびエンティティ指定(表記法指定)は使用できません。 エンティティ参照の拡張およびデフォルト属性の追加は行われません。- パラメータ:
qualifiedName
- 作成される文書型の修飾名。publicId
- 外部サブセットの公開識別子。systemId
- 外部サブセットのシステム識別子。- 戻り値:
Node.ownerDocument
がnull
に設定されている新しいDocumentType
ノード。- 例外:
DOMException
- INVALID_CHARACTER_ERR: 指定された修飾名がXML 1.0に定められているXML名でない場合に発生します。
NAMESPACE_ERR:qualifiedName
の形式が正しくない場合に発生します。
NOT_SUPPORTED_ERR: 実装が「XML」機能をサポートしておらず、文書を通じて公開された言語がXML名前空間(「HTML 4.01」など)をサポートしていない場合に発生する場合があります。- 導入されたバージョン:
- 1.4、DOMレベル2
-
createDocument
Document createDocument(String namespaceURI, String qualifiedName, DocumentType doctype) throws DOMException指定された型のDOM Documentオブジェクトとその文書要素を作成します。
文書を作成するために指定されたDocumentType
に基づいて、実装では、「HTML」の「DOM Level 2 HTML」などの、「Core」以外の追加機能をサポートする特殊なDocument
オブジェクトをインスタンス化できます。 これに対して、文書が作成されたあとにDocumentType
を設定すると、これを行うことがきわめて難しくなります。 かわりに、createHTMLDocument
「DOM Level 2 HTML」などの特殊なDocument
作成メソッドを使用して、特定の型のDocument
オブジェクトを取得できます。- パラメータ:
namespaceURI
- 作成する文書要素の名前空間URI、またはnull
。qualifiedName
- 作成される文書要素の修飾名、またはnull
。doctype
- 作成される文書の型、またはnull
。doctype
がnull
でない場合は、そのNode.ownerDocument
属性が作成される文書に設定される。- 戻り値:
- その文書要素を含む新しい
Document
オブジェクト。NamespaceURI
、qualifiedName
、およびdoctype
がnull
の場合、返されるDocument
は空で文書要素は含まれない。 - 例外:
DOMException
- INVALID_CHARACTER_ERR: 指定された修飾名がXML 1.0に定められているXML名でない場合に発生します。
NAMESPACE_ERR:qualifiedName
の形式が正しくない場合、qualifiedName
が接頭辞を持ち、かつnamespaceURI
がnull
の場合、qualifiedName
がnull
であり、かつnamespaceURI
がnull
とは異なる場合、qualifiedName
が「xml」の接頭辞を持ち、かつnamespaceURI
が「http://www.w3.org/XML/1998/namespace」の「XML名前空間」とは異なる場合、またはXMLによって名前空間が定義されていないため、DOM実装が"XML"
機能をサポートしていないが、null以外の名前空間URIが指定された場合に発生します。
WRONG_DOCUMENT_ERR:doctype
がすでに別の文書で使用されているか、または別の実装から作成された場合に発生します。
NOT_SUPPORTED_ERR: 実装が「XML」機能をサポートしておらず、文書を通じて公開された言語がXML名前空間(「HTML 4.01」など)をサポートしていない場合に発生する場合があります。- 導入されたバージョン:
- 1.4、DOMレベル2
-
getFeature
このメソッドは、指定した機能とバージョンを持つ特殊な形式のAPIを、DOM Featuresで指定されたとおりに実装する特殊な形式のオブジェクトを返します。 特殊な形式のオブジェクトは、バインディング固有のキャスティング・メソッドを使用して取得することもできますが、必ずしも説明されているようにはいきません。 このメソッドを使用すると、実装ではDOMImplementation
インタフェースをサポートしない特殊な形式のオブジェクトを利用できます。- パラメータ:
feature
- 要求された機能の名前。 機能名の前に追加されるプラス記号「+」は、このメソッドのコンテキストでは有意ではないので無視される。version
- テストする機能のバージョン番号。- 戻り値:
- 指定された機能とバージョンの特殊なAPIを実装するオブジェクト(存在する場合)を返します。指定された機能に関連付けられたインタフェースを実装するオブジェクトがない場合は
null
を返します。 このメソッドによって返されたDOMObject
がDOMImplementation
インタフェースを実装する場合は、主要コアDOMImplementation
に委譲し、hasFeature
やgetFeature
などの主要コアDOMImplementation
と整合性のない結果を返さないようにする必要がある。 - 導入されたバージョン:
- 1.5、DOMレベル3
-