HTMLTableElement

Интерфейс HTMLTableElement предоставляет специальные свойства и методы (сверх обычного интерфейса объекта HTMLElement, который он также наследует) для управления макетом и представлением таблиц в HTML-документе.

Наследует свойства от родительского класса HTMLElement.

HTMLTableElement.caption

Объект HTMLTableCaptionElement, представляющий первый <caption>, являющийся потомком элемента, или null, если такового нет. При установке, если объект не соответствует <caption>, выбрасывается исключение DOMException с именем HierarchyRequestError. Если объект корректен, он вставляется в дерево в качестве первого потомка этого элемента, а первый <caption> , являющийся потомком данного элемента, удаляется из дерева, если таковой имеется.

HTMLTableElement.tHead

Объект HTMLTableSectionElement, представляющий первый <thead>, являющийся потомком элемента, или null, если такового нет. При установке, если объект не соответствует <thead>, выбрасывается исключение DOMException с именем HierarchyRequestError. Если объект корректен, он вставляется в дерево непосредственно перед первым элементом, который не является <caption> ни <colgroup>, или в качестве последнего потомка, если такого элемента нет, и первый <thead> , являющийся потомком этого элемента, удаляется из дерева, если таковой имеется.

HTMLTableElement.tFoot

Объект HTMLTableSectionElement, представляющий первый <tfoot>, являющийся потомком элемента, или null, если такового нет. При установке, если объект не соответствует <tfoot>, выбрасывается исключение DOMException с именем HierarchyRequestError. Если объект корректен, он вставляется в дерево непосредственно перед первым элементом, который не является <caption>, <colgroup>, ни <thead>, или в качестве последнего потомка, если такого элемента нет, и первый <tfoot> , являющийся потомком этого элемента, удаляется из дерева, если таковой имеется.

HTMLTableElement.rows Только для чтения

Возвращает живой HTMLCollection, содержащий все строки элемента, то есть все <tr>, являющиеся потомками элемента, или потомками одного из его <thead>, <tbody> и <tfoot> потомков. Элементы <thead> появляются первыми, в порядке обхода дерева, а элементы <tbody> последними, также в порядке обхода дерева. HTMLCollection является живым и автоматически обновляется при изменении HTMLTableElement.

HTMLTableElement.tBodies Только для чтения

Возвращает живой HTMLCollection, содержащий все <tbody> элемента. HTMLCollection является живым и автоматически обновляется при изменении HTMLTableElement.

HTMLTableElement.align Устаревшее

Строка, содержащая перечисление значений, отражающих атрибут align. Он указывает выравнивание содержимого элемента по отношению к окружающему контексту. Возможные значения — "left", "right", и "center".

HTMLTableElement.bgColor Устаревшее

Строка, содержащая цвет фона ячеек. Она отражает устаревший атрибут bgColor.

HTMLTableElement.border Устаревшее

Строка, содержащая ширину границы таблицы в пикселях. Она отражает устаревший атрибут border.

HTMLTableElement.cellPadding Устаревшее

Строка, содержащая ширину горизонтального и вертикального отступа между содержимым ячейки и её границами в пикселях. Она отражает устаревший атрибут cellpadding.

HTMLTableElement.cellSpacing Устаревшее

Строка, содержащая ширину горизонтального и вертикального отступа между ячейками в пикселях. Она отражает устаревший атрибут cellspacing.

HTMLTableElement.frame Устаревшее

Строка, содержащая тип внешних границ таблицы. Она отражает устаревший атрибут frame и может принимать одно из следующих значений: "void", "above", "below", "hsides", "vsides", "lhs", "rhs", "box", или "border".

HTMLTableElement.rules Устаревшее

Строка, содержащая тип внутренних границ таблицы. Она отражает устаревший атрибут rules и может принимать одно из следующих значений: "none", "groups", "rows", "cols", или "all".

HTMLTableElement.summary Устаревшее

Строка, содержащая описание цели или структуры таблицы. Она отражает устаревший атрибут summary.

HTMLTableElement.width Устаревшее

Строка, содержащая длину в пикселях или процентах желаемой ширины всей таблицы. Она отражает устаревший атрибут width.

Наследует методы от родителя, HTMLElement.

HTMLTableElement.createTHead()

Возвращает HTMLTableSectionElement, представляющий первый <thead>, который является дочерним элементом. Если таковой не найден, создаётся новый и вставляется в дерево сразу перед первым элементом, который не является <caption> ни <colgroup>, или в качестве последнего дочернего элемента, если такого нет.

HTMLTableElement.deleteTHead()

Удаляет первый <thead>, являющийся дочерним элементом.

HTMLTableElement.createTFoot()

Возвращает HTMLTableSectionElement, представляющий первый <tfoot>, который является дочерним элементом. Если таковой не найден, создаётся новый и вставляется в дерево как последний дочерний элемент.

HTMLTableElement.deleteTFoot()

Удаляет первый <tfoot>, являющийся дочерним элементом.

HTMLTableElement.createTBody()

Возвращает HTMLTableSectionElement, представляющий новый <tbody>, который является дочерним элементом. Он вставляется в дерево после последнего элемента, являющегося <tbody>, или в качестве последнего дочернего элемента, если такового нет.

HTMLTableElement.createCaption()

Возвращает HTMLElement, представляющий первый <caption>, который является дочерним элементом. Если таковой не найден, создаётся новый и вставляется в дерево в качестве первого дочернего элемента элемента <table>.

HTMLTableElement.deleteCaption()

Удаляет первый <caption>, являющийся дочерним элементом.

HTMLTableElement.insertRow()

Возвращает HTMLTableRowElement, представляющий новую строку таблицы. Вставляет её в коллекцию строк непосредственно перед элементом <tr> в заданной index позиции. При необходимости создаётся <tbody>. Если index имеет значение -1, новая строка добавляется в конец коллекции. Если index меньше -1 или больше количества строк в коллекции, возбуждается DOMException со значением IndexSizeError.

HTMLTableElement.deleteRow()

Удаляет строку, соответствующую index в параметре. Если значение index равно -1, удаляется последняя строка; если оно меньше -1 или больше количества строк в коллекции, возбуждается DOMException со значением IndexSizeError.

• HTML-элемент, реализующий этот интерфейс: <table>.