Книга: JavaScript. Подробное руководство, 6-е издание

Table

Table

HTML-элемент <table> (Node, Element)

Объект Table представляет HTML-элемент <table> и определяет несколько удобных свойств и методов для получения и модификации различных частей таблицы. Эти методы и свойства облегчают работу с таблицами, но они также могут быть продублированы с помощью базовых DOM-методов.

HTML-таблицы конструируются из разделов, строк и ячеек. См. также TableCell, TableRow и TableSection.

Свойства

В дополнение к свойствам, перечисленным ниже, элементы Table имеют также свойство summary, соответствующее HTML-атрибуту с тем же именем.

Element caption

Ссылка на элемент <caption> в таблице или null, если он отсутствует.

readonly HTMLCollection rows

Объект, подобный массиву, содержащий объекты TableRow, который представляет все строки в таблице. Включает все строки, определяемые внутри тегов <thead>, <tfoot> и <tbody>.
readonly HTMLCollection tBodies

Объект, подобный массиву, содержащий объекты TableSection, который представляет все разделы <tbody> в таблице.

TableSection tFoot

Элемент <tfoot> таблицы или null, если он отсутствует.

TableSection tHead

Элемент <thead> таблицы или null, если он отсутствует.

Методы

Element createCaption()

Возвращает объект Element, представляющий элемент <caption> таблицы. Если в таблице уже имеется элемент <caption>, метод просто вернет его. Если в таблице отсутствует элемент <caption>, этот метод создаст новый (пустой) элемент, вставит его в таблицу и вернет вызывающей программе.

TableSection createTBody()

Создаст новый элемент <tbody>, вставит в таблицу и вернет его. Новый элемент вставляется после последнего элемента <tbody> в таблице или в конец таблицы.

TableSection createTFoot()

Возвращает объект TableSection, представляющий первый элемент <tfoot> в таблице. Если в таблице уже есть нижний колонтитул, метод просто вернет его. Если таблица не имеет нижнего колонтитула, этот метод создаст новый (пустой) элемент <tfoot>, вставит его в таблицу и вернет вызывающей программе.

TableSection createTHead()

Возвращает объект TableSection, представляющий первый элемент <thead> в таблице. Если в таблице уже имеется заголовок, метод просто вернет его. Если таблица не имеет заголовка, этот метод создаст новый (пустой) элемент <thead>, вставит его в таблицу и вернет вызывающей программе.

void deleteCaption()

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

void deleteRow(long index)

Удаляет из таблицы строку с индексом index. Строки нумеруются в порядке, в каком они следуют в исходном документе. Строки в разделах <thead> и <tfoot> нумеруются вместе со всеми остальными строками в таблице.

void deleteTFoot()

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

void deleteTHead()

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

TableRow insertRow([long index])

Создает новый элемент <tr>, вставляет в таблицу в позицию, определяемую аргументом index, и возвращает его.

Новая строка вставляется в том же разделе таблицы и непосредственно перед существующей строкой, в позиции, заданной аргументом index. Если значение аргумента index равно количеству строк в таблице (или -1), новая строка добавляется в конец последнего раздела таблицы. Если таблица изначально пуста, новая строка вставляется в новый раздел <tbody>, который в свою очередь вставляется в таблицу.

Для добавления содержимого в только что созданную строку можно использовать вспомогательный метод TableRow.insertCell(). См. также описание метода insert-Row() объекта TableSection.

Оглавление книги