Class TableElement


  • @TagName("table")
    public class TableElement
    extends Element
    The create* and delete* methods on the table allow authors to construct and modify tables. [HTML 4.01] specifies that only one of each of the CAPTION, THEAD, and TFOOT elements may exist in a table. Therefore, if one exists, and the createTHead() or createTFoot() method is called, the method returns the existing THead or TFoot element.
    See Also:
    W3C HTML Specification
    • Constructor Detail

      • TableElement

        protected TableElement()
    • Method Detail

      • as

        public static TableElement as​(Element elem)
        Assert that the given Element is compatible with this class and automatically typecast it.
      • is

        public static boolean is​(JavaScriptObject o)
        Determines whether the given JavaScriptObject can be cast to this class. A null object will cause this method to return false.
      • is

        public static boolean is​(Node node)
        Determine whether the given Node can be cast to this class. A null node will cause this method to return false.
      • is

        public static boolean is​(Element elem)
        Determine whether the given Element can be cast to this class. A null node will cause this method to return false.
      • createCaption

        public final TableCaptionElement createCaption()
        Create a new table caption object or return an existing one.
        Returns:
        A CAPTION element.
      • createTFoot

        public final TableSectionElement createTFoot()
        Create a table footer row or return an existing one.
        Returns:
        A footer element (TFOOT)
      • createTHead

        public final TableSectionElement createTHead()
        Create a table header row or return an existing one.
        Returns:
        A new table header element (THEAD)
      • deleteCaption

        public final void deleteCaption()
        Delete the table caption, if one exists.
      • deleteRow

        public final void deleteRow​(int index)
        Delete a table row.
        Parameters:
        index - The index of the row to be deleted. This index starts from 0 and is relative to the logical order (not document order) of all the rows contained inside the table. If the index is -1 the last row in the table is deleted
      • deleteTFoot

        public final void deleteTFoot()
        Delete the header from the table, if one exists.
      • deleteTHead

        public final void deleteTHead()
        Delete the header from the table, if one exists.
      • getBorder

        public final int getBorder()
        The width of the border around the table.
        See Also:
        W3C HTML Specification
      • getCaption

        public final TableCaptionElement getCaption()
        The table's CAPTION, or null if none exists.
      • getCellPadding

        public final int getCellPadding()
        Specifies the horizontal and vertical space between cell content and cell borders.
        See Also:
        W3C HTML Specification
      • getCellSpacing

        public final int getCellSpacing()
        Specifies the horizontal and vertical separation between cells.
        See Also:
        W3C HTML Specification
      • getFrame

        public final java.lang.String getFrame()
        Specifies which external table borders to render.
        See Also:
        W3C HTML Specification
      • getRows

        public final NodeList<TableRowElement> getRows()
        Returns a collection of all the rows in the table, including all in THEAD, TFOOT, all TBODY elements.
      • getRules

        public final java.lang.String getRules()
        Specifies which internal table borders to render.
        See Also:
        W3C HTML Specification
      • getTBodies

        public final NodeList<TableSectionElement> getTBodies()
        Returns a collection of the table bodies (including implicit ones).
      • getTFoot

        public final TableSectionElement getTFoot()
        The table's TFOOT, or null if none exists.
      • getTHead

        public final TableSectionElement getTHead()
        The table's THEAD, or null if none exists.
      • getWidth

        public final java.lang.String getWidth()
        Specifies the desired table width.
        See Also:
        W3C HTML Specification
      • insertRow

        public final TableRowElement insertRow​(int index)
        Insert a new empty row in the table. The new row is inserted immediately before and in the same section as the current indexth row in the table. If index is -1 or equal to the number of rows, the new row is appended. In addition, when the table is empty the row is inserted into a TBODY which is created and inserted into the table. Note: A table row cannot be empty according to [HTML 4.01].
        Parameters:
        index - The row number where to insert a new row. This index starts from 0 and is relative to the logical order (not document order) of all the rows contained inside the table
        Returns:
        The newly created row
      • setBorder

        public final void setBorder​(int border)
        The width of the border around the table.
        See Also:
        W3C HTML Specification
      • setCaption

        public final void setCaption​(TableCaptionElement caption)
        The table's CAPTION, or null if none exists.
      • setCellPadding

        public final void setCellPadding​(int cellPadding)
        Specifies the horizontal and vertical space between cell content and cell borders.
        See Also:
        W3C HTML Specification
      • setCellSpacing

        public final void setCellSpacing​(int cellSpacing)
        Specifies the horizontal and vertical separation between cells.
        See Also:
        W3C HTML Specification
      • setFrame

        public final void setFrame​(java.lang.String frame)
        Specifies which external table borders to render.
        See Also:
        W3C HTML Specification
      • setRules

        public final void setRules​(java.lang.String rules)
        Specifies which internal table borders to render.
        See Also:
        W3C HTML Specification
      • setTFoot

        public final void setTFoot​(TableSectionElement tFoot)
        The table's TFOOT, or null if none exists.
      • setTHead

        public final void setTHead​(TableSectionElement tHead)
        The table's THEAD, or null if none exists.
      • setWidth

        public final void setWidth​(java.lang.String width)
        Specifies the desired table width.
        See Also:
        W3C HTML Specification