-
- All Known Subinterfaces:
-
DOMImplementationCSS
,HTMLDOMImplementation
public interface DOMImplementation
DOMImplementation
接口提供了许多独立于文档对象模型的特定实例的操作的方法。
-
-
方法摘要
所有方法 接口方法 抽象方法 Modifier and Type 方法 描述 Document
createDocument(String namespaceURI, String qualifiedName, DocumentType doctype)
使用其文档元素创建指定类型的DOM文档对象。DocumentType
createDocumentType(String qualifiedName, String publicId, String systemId)
创建一个空的DocumentType
节点。Object
getFeature(String feature, String version)
此方法返回一个专门的对象,该对象实现了指定的功能和版本的专门API,如 DOM Features所规定。boolean
hasFeature(String feature, String version)
测试DOM实现是否实现了特定功能和版本,如 DOM Features中所述 。
-
-
-
方法详细信息
-
hasFeature
boolean hasFeature(String feature, String version)
测试DOM实现是否实现了特定功能和版本,如 DOM Features所述 。- 参数
-
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
格式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
,实现可以实例化支持除“核心”之外的其他功能的专门的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
已被用于其他文档或由不同的实现创建,则doctype
。
NOT_SUPPORTED_ERR:如果实现不支持功能“XML”,并且通过文档公开的语言不支持XML命名空间(例如[ HTML 4.01 ]),则可能会被引发。 - 从以下版本开始:
- 1.4,DOM Level 2
-
getFeature
Object getFeature(String feature, String version)
该方法返回一个专门的对象,该对象实现了特定功能和版本的专门API,如DOM Features所述 。 也可以通过使用结合特定的铸造方法获得专门的物体,但不一定预期如下所述。 该方法还允许实现提供不支持DOMImplementation
接口的专门对象。- 参数
-
feature
- 要求的功能的名称。 请注意,功能名称之前的任何加号“+”将被忽略,因为在此方法的上下文中不重要。 -
version
- 这是要测试的功能的版本号。 - 结果
-
返回一个对象,该对象实现指定的功能和版本(如果有的话)的专用API,如果没有实现与该功能关联的接口的对象,则
null
。 如果DOMObject
此方法返回实现DOMImplementation
接口,它必须委托给主芯DOMImplementation
和不返回结果不一致与主芯DOMImplementation
如hasFeature
,getFeature
等 - 从以下版本开始:
- 1.5,DOM 3级
-
-