Module jdk.xml.dom
Package org.w3c.dom.html

Interface HTMLTableElement

所有超级接口:
Element, HTMLElement, Node
public interface HTMLTableElement extends HTMLElement
表上的create*和delete*方法允许作者构建和修改表格。HTML 4.0规定表格中只能存在一个CAPTION、THEAD和TFOOT元素。因此，如果存在其中一个，并且调用createTHead()或createTFoot()方法，则该方法将返回现有的THead或TFoot元素。请参阅HTML 4.0中的TABLE元素定义。

另请参阅文档对象模型（DOM）Level 2规范。

自版本:
1.4, DOM Level 2

  • Method Details

    • getCaption

      HTMLTableCaptionElement getCaption()
      返回表格的CAPTION，如果不存在则返回void。

    • setCaption

      void setCaption(HTMLTableCaptionElement caption)

    • getTHead

      HTMLTableSectionElement getTHead()
      返回表格的THEAD，如果不存在则返回null。

    • setTHead

      void setTHead(HTMLTableSectionElement tHead)

    • getTFoot

      HTMLTableSectionElement getTFoot()
      返回表格的TFOOT，如果不存在则返回null。

    • setTFoot

      void setTFoot(HTMLTableSectionElement tFoot)

    • getRows

      HTMLCollection getRows()
      返回表格中所有行的集合，包括所有THEAD、TFOOT和所有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中的summary属性定义。

    • 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建议，表格行不能为空。
      参数:
      index - 要插入新行的行号。此索引从0开始，相对于表格中包含的所有行，而不考虑部分父级。
      返回:
      新创建的行。
      抛出:
      DOMException - INDEX_SIZE_ERR: 如果指定的索引大于行数或索引为负。

    • deleteRow

      void deleteRow(int index) throws DOMException
      删除表格行。
      参数:
      index - 要删除的行的索引。此索引从0开始，相对于表格中包含的所有行，而不考虑部分父级。
      抛出:
      DOMException - INDEX_SIZE_ERR: 如果指定的索引大于或等于行数或索引为负。