模块  jdk.xml.dom
软件包  org.w3c.dom.html

Interface HTMLTableElement

  • All Superinterfaces:
    ElementHTMLElementNode

    public interface HTMLTableElement
    extends HTMLElement
    表上的create *和delete *方法允许作者构造和修改表。 HTML 4.0指定只每个中的一个CAPTIONTHEAD ,和TFOOT元件可以在一个表中存在。 因此,如果存在,并且调用了createTHead()或createTFoot()方法,则该方法返回现有的THead或TFoot元素。 请参阅HTML 4.0中的TABLE元素定义。

    另见Document Object Model (DOM) Level 2 Specification

    从以下版本开始:
    1.4,DOM Level 2
    • 方法详细信息

      • getRows

        HTMLCollection getRows()
        返回表中的所有行,包括所有的集合 THEADTFOOT ,所有 TBODY元素。
      • getTBodies

        HTMLCollection getTBodies()
        返回已定义的表主体的集合。
      • getAlign

        String getAlign()
        指定表格相对于文档其余部分的位置。 请参阅HTML 4.0中的align属性定义。 HTML 4.0中不推荐使用此属性。
      • setAlign

        void setAlign​(String align)
      • getBgColor

        String getBgColor()
        细胞背景颜色。 请参阅HTML 4.0中的bgcolor属性定义。 HTML 4.0中不推荐使用此属性。
      • setBgColor

        void setBgColor​(String bgColor)
      • getBorder

        String getBorder()
        桌子周围的边框宽度。 请参阅HTML 4.0中的border属性定义。
      • setBorder

        void setBorder​(String border)
      • getCellPadding

        String getCellPadding()
        指定单元格内容和单元格边框之间的水平和垂直空间。 请参阅HTML 4.0中的cellpadding属性定义。
      • setCellPadding

        void setCellPadding​(String cellPadding)
      • getCellSpacing

        String getCellSpacing()
        指定单元格之间的水平和垂直间距。 请参阅HTML 4.0中的cellspacing属性定义。
      • setCellSpacing

        void setCellSpacing​(String cellSpacing)
      • getFrame

        String getFrame()
        指定要呈现的外部表格边框。 请参阅HTML 4.0中的frame属性定义。
      • setFrame

        void setFrame​(String frame)
      • getRules

        String getRules()
        指定要呈现的内部表格边框。 请参阅HTML 4.0中的rules属性定义。
      • setRules

        void setRules​(String rules)
      • getSummary

        String getSummary()
        关于表的目的或结构的描述。 请参阅HTML 4.0中的摘要属性定义。
      • setSummary

        void setSummary​(String summary)
      • getWidth

        String getWidth()
        指定所需的表宽度。 请参阅HTML 4.0中的width属性定义。
      • setWidth

        void setWidth​(String width)
      • createTHead

        HTMLElement createTHead()
        创建表标题行或返回现有标题行。
        结果
        一个新的表头元素( THEAD )。
      • deleteTHead

        void deleteTHead()
        从表中删除标题(如果存在)。
      • createTFoot

        HTMLElement createTFoot()
        创建表格页脚行或返回现有行。
        结果
        页脚元素( TFOOT )。
      • deleteTFoot

        void deleteTFoot()
        从表中删除页脚(如果存在)。
      • createCaption

        HTMLElement createCaption()
        创建一个新的表标题对象或返回一个现有的标题对象。
        结果
        一个 CAPTION元素。
      • deleteCaption

        void deleteCaption()
        删除表格标题(如果存在)。
      • insertRow

        HTMLElement insertRow​(int index)
                       throws DOMException
        在表中插入一个新的空行。 新行将紧接在表格中当前index行之前和之后插入。 如果index等于行数,则追加新行。 此外,当表为空时,行被插入到TBODY ,该行被创建并插入到表中。 注意。 根据HTML 4.0 Recommendation,表行不能为空。
        参数
        index - 要插入新行的行号。 此索引从0开始,并且相对于表中包含的所有行,而不管部分父项。
        结果
        新创建的行。
        异常
        DOMException - INDEX_SIZE_ERR:如果指定的索引大于行数或索引为负数,则引发此异常。
      • deleteRow

        void deleteRow​(int index)
                throws DOMException
        删除表格行。
        参数
        index - 要删除的行的索引。 此索引从0开始,并且相对于表中包含的所有行,而不管部分父项。
        异常
        DOMException - INDEX_SIZE_ERR: Raised if the specified index is greater than or equal to the number of rows or if the index is negative.