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

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

TableCell

ячейка в HTML-таблице (Node, Element)

Объект TableCell представляет элементы

<td> и <th>

Свойства

readonly long celllndex

Позиция данной ячейки внутри строки.

unsigned long colSpan

Значение HTML-атрибута

colspan

в виде числа.

unsigned long rowSpan

Значение HTML-атрибута

rowspan

в виде числа.

TableRow

элемент <tr> в HTML-таблице (Node, Element)