Элемент таблицы

пакет js.html

расширяет Element › DOMElement › Node › EventTarget

Доступно в js

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

Документация HTMLTableElement от Авторов Mozilla, лицензия CC-BY-SA 2.5.

См. также:

• https://developer.mozilla.org/en-US/docs/Web/API/HTMLTableElement

Переменные

align:String

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

bgColor:String

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

border:String

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

caption:TableCaptionElement

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

cellPadding:String

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

cellSpacing:String

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

frame:String

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

read onlyrows:HTMLCollection

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

rules:String

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

summary:String

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

read onlytBodies:HTMLCollection

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

tFoot:TableSectionElement

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

tHead:TableSectionElement

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

width:String

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

Методы

createCaption():Element

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

createTBody():Element

createTFoot():Element

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

createTHead():Element

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

deleteCaption():Void

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

deleteRow(index:Int):Void

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

Выбрасывает:

deleteTFoot():Void

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

deleteTHead():Void

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

insertRow(index:Int = -1):Element

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

Выбрасывает: