Table
HTML-элемент <table> (Node, Element)
Объект
<b>Table</b>
представляет HTML-элемент
<b><table></b>
и определяет несколько удобных свойств и методов для получения и модификации различных частей таблицы. Эти методы и свойства облегчают работу с таблицами, но они также могут быть продублированы с помощью базовых DOM-методов.
HTML-таблицы конструируются из разделов, строк и ячеек. См. также
<b>TableCell, TableRow и TableSection</b>
.
Свойства
В дополнение к свойствам, перечисленным ниже, элементы
<b>Table</b>
имеют также свойство
<b>summary</b>
, соответствующее HTML-атрибуту с тем же именем.
<b>Element caption</b>
Ссылка на элемент
<b><caption></b>
в таблице или null, если он отсутствует.
<b>readonly HTMLCollection rows</b>
Объект, подобный массиву, содержащий объекты
<b>TableRow</b>
, который представляет все строки в таблице. Включает все строки, определяемые внутри тегов
<b><thead>, <tfoot> и <tbody>.</b>
<b>readonly HTMLCollection tBodies</b>
Объект, подобный массиву, содержащий объекты
<b>TableSection</b>
, который представляет все разделы
<b><tbody></b>
в таблице.
<b>TableSection tFoot</b>
Элемент
<b><tfoot></b>
таблицы или null, если он отсутствует.
<b>TableSection tHead</b>
Элемент
<b><thead></b>
таблицы или null, если он отсутствует.
Методы
<b>Element createCaption()</b>
Возвращает объект
<b>Element</b>
, представляющий элемент <caption> таблицы. Если в таблице уже имеется элемент
<b><caption></b>
, метод просто вернет его. Если в таблице отсутствует элемент
<b><caption>,</b>
этот метод создаст новый (пустой) элемент, вставит его в таблицу и вернет вызывающей программе.
<b>TableSection createTBody()</b>
Создаст новый элемент
<b><tbody>,</b>
вставит в таблицу и вернет его. Новый элемент вставляется после последнего элемента
<b><tbody></b>
в таблице или в конец таблицы.
<b>TableSection createTFoot()</b>
Возвращает объект
<b>TableSection</b>
, представляющий первый элемент
<b><tfoot></b>
в таблице. Если в таблице уже есть нижний колонтитул, метод просто вернет его. Если таблица не имеет нижнего колонтитула, этот метод создаст новый (пустой) элемент
<b><tfoot>,</b>
вставит его в таблицу и вернет вызывающей программе.
<b>TableSection createTHead()</b>
Возвращает объект
<b>TableSection</b>
, представляющий первый элемент
<b><thead></b>
в таблице. Если в таблице уже имеется заголовок, метод просто вернет его. Если таблица не имеет заголовка, этот метод создаст новый (пустой) элемент
<b><thead>,</b>
вставит его в таблицу и вернет вызывающей программе.
<b>void deleteCaption()</b>
Удаляет из таблицы первый элемент
<b><caption>,</b>
если он существует.
<b>void deleteRow(long index)</b>
Удаляет из таблицы строку с индексом index. Строки нумеруются в порядке, в каком они следуют в исходном документе. Строки в разделах
<b><thead> и <tfoot></b>
нумеруются вместе со всеми остальными строками в таблице.
<b>void deleteTFoot()</b>
Удаляет из таблицы первый элемент
<b><tfoot></b>
, если он существует.
<b>void deleteTHead()</b>
Удаляет из таблицы первый элемент
<b><thead>,</b>
если он существует.
<b>TableRow insertRow([long index])</b>
Создает новый элемент
<b><tr>,</b>
вставляет в таблицу в позицию, определяемую аргументом index, и возвращает его.
Новая строка вставляется в том же разделе таблицы и непосредственно перед существующей строкой, в позиции, заданной аргументом index. Если значение аргумента index равно количеству строк в таблице (или -1), новая строка добавляется в конец последнего раздела таблицы. Если таблица изначально пуста, новая строка вставляется в новый раздел
<b><tbody>,</b>
который в свою очередь вставляется в таблицу.
Для добавления содержимого в только что созданную строку можно использовать вспомогательный метод
<b>TableRow.insertCell</b>
(). См. также описание метода
<b>insert-Row()</b>
объекта
<b>TableSection</b>
.
TableCell
ячейка в HTML-таблице (Node, Element)
Объект TableCell представляет элементы
<b><td> и <th></b>
.
Свойства
<b>readonly long celllndex</b>
Позиция данной ячейки внутри строки.
<b>unsigned long colSpan</b>
Значение HTML-атрибута
<b>colspan</b>
в виде числа.
<b>unsigned long rowSpan</b>
Значение HTML-атрибута
<b>rowspan</b>
в виде числа.
TableRow
элемент <tr> в HTML-таблице (Node, Element)
