Module  jdk.xml.dom
软件包  org.w3c.dom.html

Interface HTMLDocument

  • All Superinterfaces:
    Document ， Node 

    public interface HTMLDocument
extends Document
    一个HTMLDocument是HTML层次结构的根，并保存整个内容。 除了提供对层次结构的访问之外，它还提供了一些方便的方法来访问文档中的某些信息集。

    以下属性已被弃用，有利于BODY元素的相应BODY ：alinkColor背景bgColor fgColor linkColor vlinkColor在DOM级别2中，方法getElementById继承自被移动的Document接口。

    另见Document Object Model (DOM) Level 2 Specification 。

    从以下版本开始：
    1.4，DOM Level 2

    • 方法详细信息

      • getTitle

        String getTitle​()
        由文件头中的 TITLE元素指定的文档的标题。

      • setTitle

        void setTitle​(String title)

      • getReferrer

        String getReferrer​()
        返回链接到此页面的页面的URI。 如果用户直接导航到页面（不是通过链接，而是通过书签），则该值为空字符串。

      • getDomain

        String getDomain​()
        服务于该文档的服务器的域名，如果服务器无法通过域名标识， null 。

      • getURL

        String getURL​()
        文档的完整URI。

      • getBody

        HTMLElement getBody​()
        包含文档内容的元素。 在具有BODY内容的文件中，返回BODY元素。 在框架集文档中，这将返回最外面的FRAMESET元素。

      • getImages

        HTMLCollection getImages​()
        文档中所有IMG元素的集合。 该行为限于IMG元素的向后兼容性。

      • getApplets

        HTMLCollection getApplets​()
        所有 OBJECT元素的集合，包括文档中的小程序和 APPLET （已弃用）元素。

      • getLinks

        HTMLCollection getLinks​()
        所有 AREA元素和锚（ A ）元素的集合，其中一个值为 href属性的文档。

      • getForms

        HTMLCollection getForms​()
        文件的所有形式的集合。

      • getAnchors

        HTMLCollection getAnchors​()
        一个文档中所有锚（ A ）元素的集合，其值为name属性。 注意。 由于向后兼容性的原因，返回的锚点集只包含使用name属性创建的那些锚点，而不是使用id属性创建的id 。

      • getCookie

        String getCookie​()
        与此文档相关联的Cookie。 如果没有，则该值为空字符串。 否则，该值为字符串：与该页面相关联的所有Cookie的“名称，值”对的分号分隔列表。 例如， name=value;expires=date 。

      • setCookie

        void setCookie​(String cookie)

      • open

        void open​()
        注意。 此方法和以下方法允许用户使用未解析HTML的字符串添加或替换文档的结构模型。 在编写为HTML和XML文档提供类似功能的替代方法时正在考虑中。 以后的方法在以后的某个时候可能会被弃用，有利于更通用的机制。
        打开一个文件流进行写入。 如果目标中存在文档，则此方法将清除它。

      • close

        void close​()
        关闭由 open()打开的文档流，并强制渲染。

      • write

        void write​(String text)
        将一串文本写入由open()打开的文档流。 文本被解析为文档的结构模型。
        参数
        text - 要在文档结构模型中解析成某些结构的字符串。

      • writeln

        void writeln​(String text)
        在open()打开的文件流中写入一串文本，后跟换行符。 文本被解析为文档的结构模型。
        参数
        text - 要在文档结构模型中解析为某些结构的字符串。

      • getElementsByName

        NodeList getElementsByName​(String elementName)
        返回（ name值由（ elementName ）给出的（可能为空）的元素集合。
        参数
        elementName - 元素的 name属性值。
        结果
        匹配元素。