- 已知的所有子接口:
-
DOMImplementationCSS
,HTMLDOMImplementation
public interface DOMImplementation
DOMImplementation
接口提供了执行与文档对象模型的任何特定实例无关的操作的多个方法。
-
Method Summary
Modifier and TypeMethodDescriptioncreateDocument
(String namespaceURI, String qualifiedName, DocumentType doctype) 创建具有其文档元素的指定类型的DOM文档对象。createDocumentType
(String qualifiedName, String publicId, String systemId) 创建一个空的DocumentType
节点。getFeature
(String feature, String version) 该方法返回一个专门的对象,该对象实现了指定特性和版本的专门API,如DOM特性中所述。boolean
hasFeature
(String feature, String version) 测试DOM实现是否实现了特定特性和版本,如DOM特性中所述。
-
Method Details
-
hasFeature
测试DOM实现是否实现了特定特性和版本,如DOM特性中所述。- 参数:
-
feature
- 要测试的特性的名称。 -
version
- 要测试的特性的版本号。 - 返回:
-
如果该特性在指定版本中实现,则返回
true
,否则返回false
。
-
createDocumentType
DocumentType createDocumentType(String qualifiedName, String publicId, String systemId) throws DOMException 创建一个空的DocumentType
节点。实体声明和符号不可用。实体引用扩展和默认属性添加不会发生。- 参数:
-
qualifiedName
- 要创建的文档类型的合格名称。 -
publicId
- 外部子集的公共标识符。 -
systemId
- 外部子集的系统标识符。 - 返回:
-
一个新的
DocumentType
节点,其Node.ownerDocument
设置为null
。 - 抛出:
-
DOMException
- INVALID_CHARACTER_ERR: 如果指定的合格名称不符合[XML 1.0]中的XML名称。
NAMESPACE_ERR: 如果qualifiedName
格式不正确。
NOT_SUPPORTED_ERR: 如果实现不支持特性"XML",并且文档中公开的语言不支持XML命名空间(例如[HTML 4.01])可能会引发此异常。 - 自从:
- 1.4, DOM Level 2
-
createDocument
Document createDocument(String namespaceURI, String qualifiedName, DocumentType doctype) throws DOMException 创建具有其文档元素的指定类型的DOM文档对象。
请注意,根据提供给创建文档的DocumentType
,实现可能会实例化支持比"Core"更多功能的专门Document
对象,例如"HTML" [DOM Level 2 HTML]。另一方面,在创建文档后设置DocumentType
会使这种情况发生的可能性非常小。或者,可以使用专门的Document
创建方法,如createHTMLDocument
[DOM Level 2 HTML],来获取特定类型的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 Namespaces],或者如果DOM实现不支持特性"XML"但提供了非空命名空间URI,因为XML定义了命名空间。
WRONG_DOCUMENT_ERR: 如果doctype
已经与不同文档一起使用,或者是从不同实现创建的,则会引发此异常。
NOT_SUPPORTED_ERR: 如果实现不支持特性"XML",并且文档中公开的语言不支持XML命名空间(例如[HTML 4.01])可能会引发此异常。 - 自从:
- 1.4, DOM Level 2
-
getFeature
该方法返回一个专门的对象,该对象实现了指定特性和版本的专门API,如DOM特性中所述。专门对象也可以通过使用特定于绑定的转换方法获得,但不一定会如讨论中所述。该方法还允许实现提供不支持DOMImplementation
接口的专门对象。- 参数:
-
feature
- 请求的特性的名称。请注意,在此方法的上下文中,任何前缀为加号"+"的特性名称都将被忽略,因为在这种方法的上下文中不重要。 -
version
- 要测试的特性的版本号。 - 返回:
-
返回一个实现指定特性和版本的专门API的对象,如果有的话,或者如果没有实现与该特性相关联的接口的对象,则返回
null
。如果此方法返回的DOMObject
实现了DOMImplementation
接口,则它必须委托给主要核心DOMImplementation
,并且不得返回与主要核心DOMImplementation
不一致的结果,如hasFeature
、getFeature
等。 - 自从:
- 1.5, DOM Level 3
-