HTMLTableElement Class

HTMLTableElement class

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 the TABLE element definition in HTML 4.01.

See also the Document object Model (DOM) Level 2 HTML Specification.

public class HTMLTableElement : HTMLElement

Properties

NameDescription
[getAlign]
[setAlign] Specifies the table’s position with respect to the rest of the document. See the align attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01.
getAttributes A NamedNodeMap containing the attributes of this node (if it is an Element) or null otherwise.
getBaseURI The read-only baseURI property of the Node interface returns the absolute base URL of the document containing the node.
[getBgColor]
[setBgColor] Cell background color. See the bgcolor attribute definition in HTML 4.01. This attribute is deprecated in HTML 4.01.
[getBorder]
[setBorder] The width of the border around the table. See the border attribute definition in HTML 4.01.
getCaption Returns the table’s CAPTION, or void if none exists. @version DOM Level 2
[getCellPadding]
[setCellPadding] Specifies the horizontal and vertical space between cell content and cell borders. See the cellpadding attribute definition in HTML 4.01.
[getCellSpacing]
[setCellSpacing] Specifies the horizontal and vertical separation between cells. See the cellspacing attribute definition in HTML 4.01.
getChildElementCount Returns the current number of element nodes that are children of this element. 0 if this element has no child nodes that are of nodeType 1.
getChildNodes The read-only childNodes property of the Node interface returns a live NodeList of child nodes of the given element where the first child node is assigned index 0. Child nodes include elements, text and comments.
getChildren Returns the child elements of current element.
getClassList Returns a live DOMTokenList which contains tokens received from parsing the “class” attribute.
[getClassName]
[setClassName] The class attribute of the element. This attribute has been renamed due to conflicts with the “class” keyword exposed by many languages. See the class attribute definition in HTML 4.01.
[getDir]
[setDir] Specifies the base direction of directionally neutral text and the directionality of tables. See the dir attribute definition in HTML 4.01.
getFirstChild The read-only firstChild property of the Node interface returns the node’s first child in the tree, or null if the node has no children.
getFirstElementChild Returns the first child element node of this element. null if this element has no child elements.
[getFrame]
[setFrame] Specifies which external table borders to render. See the frame attribute definition in HTML 4.01.
[getId]
[setId] The element’s identifier. See the id attribute definition in HTML 4.01.
[getInnerHTML]
[setInnerHTML] Returns a fragment of HTML or XML that represents the element’s contents. Can be set, to replace the contents of the element with nodes parsed from the given String.
[getLang]
[setLang] Language code defined in RFC 1766. See the lang attribute definition in HTML 4.01.
getLastChild The read-only lastChild property of the Node interface returns the last child of the node. If its parent is an element, then the child is generally an element node, a text node, or a comment node. It returns null if there are no child elements
getLastElementChild Returns the last child element node of this element. null if this element has no child elements.
getLocalName Returns the local part of the qualified name of this node. For nodes of any type other than ELEMENT_NODE and ATTRIBUTE_NODE and nodes created with a DOM Level 1 method, such as Document.createElement(), this is always null.
getNamespaceURI The package URI of this node, or null if it is unspecified.
getNextElementSibling Returns the next sibling element node of this element. null if this element has no element sibling nodes that come after this one in the document tree.
getNextSibling The read-only nextSibling property of the Node interface returns the node immediately following the specified one in their parent’s childNodes, or returns null if the specified node is the last child in the parent element.
getNodeName The name of this node, depending on its type.
getNodeType A code representing the type of the underlying object.
[getNodeValue]
[setNodeValue] The nodeValue property of the Node interface returns or sets the value of the current node.
[getOuterHTML]
[setOuterHTML] Returns a fragment of HTML or XML that represents the element and its contents. Can be set, to replace the element with nodes parsed from the given String.
getOwnerDocument The read-only ownerDocument property of the Node interface returns the top-level document object of the node.
getParentElement The read-only parentElement property of Node interface returns the DOM node’s parent Element, or null if the node either has no parent, or its parent isn’t a DOM Element.
getParentNode The read-only parentNode property of the Node interface returns the parent of the specified node in the DOM tree.
getPrefix The package prefix of this node, or null if it is unspecified. When it is defined to be null, setting it has no effect
getPreviousElementSibling Returns the previous sibling element node of this element. null if this element has no element sibling nodes that come before this one in the document tree.
getPreviousSibling The read-only previousSibling property of the Node interface returns the node immediately preceding the specified one in its parent’s childNodes list, or null if the specified node is the first in that list.
getRows Returns the table’s TFOOT, or null if none exists.
[getRules]
[setRules] Specifies which internal table borders to render. See the rules attribute definition in HTML 4.01.
getSchemaTypeInfo The type information associated with this element.
getShadowRoot Returns shadowRoot stored on this element or null if it’s closed.
getStyle Represents a style attribute that allows author to directly apply style information to specific element.
[getSummary]
[setSummary] Description about the purpose or structure of a table. See the summary attribute definition in HTML 4.01.
getTagName The name of the element.
getTBodies Returns a collection of the table bodies (including implicit ones).
[getTextContent]
[setTextContent] This attribute returns the text content of this node and its descendants. When it is defined to be null, setting it has no effect. On setting, any possible children this node may have are removed and, if it the new String is not empty or null, replaced by a single Text node containing the String this attribute is set to.
getTFoot Returns the table’s THEAD, or null if none exists.
getTHead Returns the table’s CAPTION, or void if none exists.
[getTitle]
[setTitle] The element’s advisory title. See the title attribute definition in HTML 4.01.
[getWidth]
[setWidth] Specifies the desired table width. See the width attribute definition in HTML 4.01.

Methods

NameDescription
addEventListener(String, IEventListener)The addEventListener() method of the EventTarget interface sets up a function that will be called whenever the specified event is delivered to the target.
addEventListener(String, DOMEventHandler, bool)The addEventListener() method of the EventTarget interface sets up a function that will be called whenever the specified event is delivered to the target.
addEventListener(String, IEventListener, bool)The addEventListener() method of the EventTarget interface sets up a function that will be called whenever the specified event is delivered to the target.
appendChild(Node)The appendChild() method of the Node interface adds a node to the end of the list of children of a specified parent node. If the given child is a reference to an existing node in the document, appendChild() moves it from its current position to the new position (there is no requirement to remove the node from its parent node before appending it to some other node).
attachShadow(ShadowRootMode)Creates shadow root and attaches it to current element.
cloneNode()The cloneNode() method of the Node interface returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
cloneNode(bool)The cloneNode() method of the Node interface returns a duplicate of the node on which this method was called. Its parameter controls if the subtree contained in a node is also cloned or not.
createCaption()Create a new table caption object or return an existing one.
createTFoot()Create a table footer row or return an existing one.
createTHead()Create a table header row or return an existing one.
deleteCaption()Delete the table caption, if one exists.
deleteRow(int)Delete a table row.
deleteTFoot()Delete the footer from the table, if one exists.
deleteTHead()Delete the header from the table, if one exists.
dispatchEvent(Event)Dispatches an Event at the specified EventTarget, (synchronously) invoking the affected EventListeners in the appropriate order. The normal event processing rules (including the capturing and optional bubbling phase) also apply to events dispatched manually with dispatchEvent().
dispose()Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
getAttribute(String)Retrieves an attribute value by name.
getAttributeNode(String)Retrieves an attribute node by name.
getAttributeNodeNS(String, String)Retrieves an Attr node by local name and package URI.
getAttributeNS(String, String)Retrieves an attribute value by local name and package URI.
getElementsByClassName(String)Returns HTMLCollection object containing all the elements within element that have all the classes specified in argument.
getElementsByTagName(String)Returns HTMLCollection object containing all elements with a given tag name, in document order.
getElementsByTagNameNS(String, String)Returns HTMLCollection object containing all elements with a given local name and package URI String in document order.
getPlatformType()This method is used to retrieve the ECMAScript object .
hasAttribute(String)Returns true when an attribute with a given name is specified on this element or has a default value, false otherwise.
hasAttributeNS(String, String)Returns true when an attribute with a given local name and package URI is specified on this element or has a default value, false otherwise.
hasAttributes()Returns whether this node (if it is an element) has any attributes
hasChildNodes()The hasChildNodes() method of the Node interface returns a boolean value indicating whether the given Node has child nodes or not.
insertBefore(Node, Node)The insertBefore() method of the Node interface inserts a node before a reference node as a child of a specified parent node.
insertRow(int)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 TBODYwhich is created and inserted into the table.A table row cannot be empty according to [HTML 4.01].
isDefaultNamespace(String)The isDefaultNamespace() method of the Node interface accepts a package URI as an argument. It returns a boolean value that is true if the package is the default package on the given node and false if not.
isEqualNode(Node)The isEqualNode() method of the Node interface tests whether two nodes are equal. Two nodes are equal when they have the same type, defining characteristics (for elements, this would be their ID, number of children, and so forth), its attributes match, and so on. The specific set of data points that must match varies depending on the types of the nodes.
isSameNode(Node)The isSameNode() method of the Node interface is a legacy alias the for the === strict equality operator. That is, it tests whether two nodes are the same (in other words, whether they reference the same object).
lookupNamespaceURI(String)The lookupNamespaceURI() method of the Node interface takes a prefix as parameter and returns the package URI associated with it on the given node if found (and null if not).
lookupPrefix(String)The lookupPrefix() method of the Node interface returns a String containing the prefix for a given package URI, if present, and null if not. When multiple prefixes are possible, the first prefix is returned.
normalize()Puts all Text nodes in the full depth of the sub-tree underneath this Node, including attribute nodes, into a “normal” form where only structure (e.g., elements, comments, processing instructions, CDATA sections, and entity references) separates Text nodes, i.e., there are neither adjacent Text nodes nor empty Text nodes. This can be used to ensure that the DOM view of a document is the same as if it were saved and re-loaded, and is useful when operations (such as XPointer [XPointer] lookups) that depend on a particular document tree structure are to be used. If the parameter “normalize-characters” of the DOMConfiguration object attached to the Node.ownerDocument is true, this method will also fully normalize the characters of the Text nodes.
querySelector(String)Returns the first Element in document, which match selector
querySelectorAll(String)Returns a NodeList of all the Elements in document, which match selector
remove()Removes this instance.
removeAttribute(String)Removes an attribute by name.
removeAttributeNode(Attr)Removes the specified attribute node.
removeAttributeNS(String, String)Removes an attribute by local name and package URI.
removeChild(Node)The removeChild() method of the Node interface removes a child node from the DOM and returns the removed node.
removeEventListener(String, IEventListener)This method allows the removal of event listeners from the event target. If an is removed from an while it is processing an event, it will not be triggered by the current actions. Event Listeners can never be invoked after being removed.
removeEventListener(String, DOMEventHandler, bool)This method allows the removal of event listeners from the event target. If an is removed from an while it is processing an event, it will not be triggered by the current actions. Event Listeners can never be invoked after being removed.
removeEventListener(String, IEventListener, bool)This method allows the removal of event listeners from the event target. If an is removed from an while it is processing an event, it will not be triggered by the current actions. Event Listeners can never be invoked after being removed.
replaceChild(Node, Node)Replaces the child node oldChild with newChild in the list of children, and returns the oldChild node. If newChild is a DocumentFragment object, oldChild is replaced by all of the DocumentFragment children, which are inserted in the same order. If the newChild is already in the tree, it is first removed.
setAttribute(String, String)Adds a new attribute. If an attribute with that name is already present in the element, its value is changed to be that of the value parameter
setAttributeNode(Attr)Adds a new attribute node. If an attribute with that name (nodeName) is already present in the element, it is replaced by the new one.
setAttributeNodeNS(Attr)Adds a new attribute. If an attribute with that local name and that package URI is already present in the element, it is replaced by the new one.
setAttributeNS(String, String, String)Adds a new attribute. If an attribute with the same local name and package URI is already present on the element, its prefix is changed to be the prefix part of the qualifiedName, and its value is changed to be the value parameter.
setIdAttribute(String, bool)If the parameter isId is true, this method declares the specified attribute to be a user-determined ID attribute.
setIdAttributeNode(Attr, bool)If the parameter isId is true, this method declares the specified attribute to be a user-determined ID attribute.
setIdAttributeNS(String, String, bool)If the parameter isId is true, this method declares the specified attribute to be a user-determined ID attribute.
toString()Returns a String that represents this instance.

Events

NameDescription
event OnAbortGets or sets event handler for OnAbort event.
event OnBlurGets or sets event handler for OnBlur event.
event OnCancelGets or sets event handler for OnCancel event.
event OnCanplayGets or sets event handler for OnCanplay event.
event OnCanPlayThroughGets or sets event handler for OnCanPlayThrough event.
event OnChangeGets or sets event handler for OnChange event.
event OnClickGets or sets event handler for OnClick event.
event OnCueChangeGets or sets event handler for OnCueChange event.
event OnDblClickGets or sets event handler for OnDblClick event.
event OnDurationChangeGets or sets event handler for OnDurationChange event.
event OnEmptiedGets or sets event handler for OnEmptied event.
event OnEndedGets or sets event handler for OnEnded event.
event OnErrorGets or sets event handler for OnError event.
event OnFocusGets or sets event handler for OnFocus event.
event OnInputGets or sets event handler for OnInput event.
event OnInvalidGets or sets event handler for OnInvalid event.
event OnKeyDownGets or sets event handler for OnKeyDown event.
event OnKeyPressGets or sets event handler for OnKeyPress event.
event OnKeyUpGets or sets event handler for OnKeyUp event.
event OnLoadGets or sets event handler for OnLoad event.
event OnLoadedDataGets or sets event handler for OnLoadedData event.
event OnLoadedMetadataGets or sets event handler for OnLoadedMetadata event.
event OnLoadStartGets or sets event handler for OnLoadStart event.
event OnMouseDownGets or sets event handler for OnMouseDown event.
event OnMouseEnterGets or sets event handler for OnMouseEnter event.
event OnMouseLeaveGets or sets event handler for OnMouseLeave event.
event OnMouseMoveGets or sets event handler for OnMouseMove event.
event OnMouseOutGets or sets event handler for OnMouseOut event.
event OnMouseOverGets or sets event handler for OnMouseOver event.
event OnMouseUpGets or sets event handler for OnMouseUp event.
event OnMouseWheelGets or sets event handler for OnMouseWheel event.
event OnPauseGets or sets event handler for OnPause event.
event OnPlayGets or sets event handler for OnPlay event.
event OnPlayingGets or sets event handler for OnPlaying event.
event OnProgressGets or sets event handler for OnProgress event.
event OnRateChangeGets or sets event handler for OnRateChange event.
event OnResetGets or sets event handler for OnReset event.
event OnResizeGets or sets event handler for OnResize event.
event OnScrollGets or sets event handler for OnScroll event.
event OnSeekedGets or sets event handler for OnSeeked event.
event OnSeekingGets or sets event handler for OnSeeking event.
event OnSelectGets or sets event handler for OnSelect event.
event OnShowGets or sets event handler for OnShow event.
event OnStalledGets or sets event handler for OnStalled event.
event OnSubmitGets or sets event handler for OnSubmit event.
event OnSuspendGets or sets event handler for OnSuspend event.
event OnTimeUpdateGets or sets event handler for OnTimeUpdate event.
event OnToggleGets or sets event handler for OnToggle event.
event OnVolumeChangeGets or sets event handler for OnVolumeChange event.
event OnWaitingGets or sets event handler for OnWaiting event.

See Also