Интерфейс HTMLTableElement

Все суперинтерфейсы:: Element, HTMLElement, Node

public interface HTMLTableElement extends HTMLElement

Методы create* и delete* таблицы позволяют авторам создавать и изменять таблицы. HTML 4.0 указывает, что в таблице может существовать только один элемент каждого из типов CAPTION , THEAD и TFOOT. Поэтому, если такой элемент существует и вызывается метод createTHead() или createTFoot(), метод возвращает существующий элемент THead или TFoot. См. описание элемента TABLE в HTML 4.0.

См. также Спецификацию объектной модели документа (DOM) уровня 2.

Начиная с версии:: 1.4, DOM уровня 2

Краткое описание полей

Поля, объявленные в интерфейсе Node

ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

Краткое описание методов

Модификатор и тип	Метод	Описание
`HTMLElement`	`createCaption()`	Создаёт новый объект заголовка таблицы или возвращает существующий.
`HTMLElement`	`createTFoot()`	Создаёт строку нижнего колонтитула таблицы или возвращает существующую.
`HTMLElement`	`createTHead()`	Создаёт строку заголовка таблицы или возвращает существующую.
`void`	`deleteCaption()`	Удаляет заголовок таблицы, если он существует.
`void`	`deleteRow(int index)`	Удаляет строку таблицы.
`void`	`deleteTFoot()`	Удаляет нижний колонтитул таблицы, если он существует.
`void`	`deleteTHead()`	Удаляет заголовок таблицы, если он существует.
`String`	`getAlign()`	Задаёт положение таблицы относительно остальной части документа.
`String`	`getBgColor()`	Цвет фона ячейки.
`String`	`getBorder()`	Ширина рамки вокруг таблицы.
`HTMLTableCaptionElement`	`getCaption()`	Возвращает `CAPTION` таблицы или void, если такого элемента нет.
`String`	`getCellPadding()`	Задаёт горизонтальное и вертикальное расстояние между содержимым ячеек и их границами.
`String`	`getCellSpacing()`	Задаёт горизонтальное и вертикальное расстояние между ячейками.
`String`	`getFrame()`	Задаёт, какие внешние границы таблицы отображать.
`HTMLCollection`	`getRows()`	Возвращает коллекцию всех строк таблицы, включая все строки в `THEAD` , `TFOOT` и все элементы `TBODY`.
`String`	`getRules()`	Задаёт, какие внутренние границы таблицы отображать.
`String`	`getSummary()`	Описание назначения или структуры таблицы.
`HTMLCollection`	`getTBodies()`	Возвращает коллекцию определённых тел таблицы.
`HTMLTableSectionElement`	`getTFoot()`	Возвращает `TFOOT` таблицы или `null`, если такого элемента нет.
`HTMLTableSectionElement`	`getTHead()`	Возвращает `THEAD` таблицы или `null`, если такого элемента нет.
`String`	`getWidth()`	Задаёт желаемую ширину таблицы.
`HTMLElement`	`insertRow(int index)`	Вставляет в таблицу новую пустую строку.
`void`	`setAlign(String align)`
`void`	`setBgColor(String bgColor)`
`void`	`setBorder(String border)`
`void`	`setCaption(HTMLTableCaptionElement caption)`
`void`	`setCellPadding(String cellPadding)`
`void`	`setCellSpacing(String cellSpacing)`
`void`	`setFrame(String frame)`
`void`	`setRules(String rules)`
`void`	`setSummary(String summary)`
`void`	`setTFoot(HTMLTableSectionElement tFoot)`
`void`	`setTHead(HTMLTableSectionElement tHead)`
`void`	`setWidth(String width)`

Методы, объявленные в интерфейсе Element

getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getElementsByTagName, getElementsByTagNameNS, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, removeAttribute, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNode, setAttributeNodeNS, setAttributeNS, setIdAttribute, setIdAttributeNode, setIdAttributeNS

Методы, объявленные в интерфейсе HTMLElement

getClassName, getDir, getId, getLang, getTitle, setClassName, setDir, setId, setLang, setTitle

Методы, объявленные в интерфейсе Node

appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData

Подробное описание методов

getCaption

HTMLTableCaptionElement getCaption()

Возвращает CAPTION таблицы или void, если такого элемента нет.

setCaption

void setCaption(HTMLTableCaptionElement caption)

getTHead

HTMLTableSectionElement getTHead()

Возвращает THEAD таблицы или null, если такого элемента нет.

setTHead

void setTHead(HTMLTableSectionElement tHead)

getTFoot

HTMLTableSectionElement getTFoot()

Возвращает TFOOT таблицы или null, если такого элемента нет.

setTFoot

void setTFoot(HTMLTableSectionElement tFoot)

getRows

HTMLCollection getRows()

Возвращает коллекцию всех строк таблицы, включая все строки в THEAD , TFOOT и все элементы TBODY.

getTBodies

HTMLCollection getTBodies()

Возвращает коллекцию определённых тел таблицы.

getAlign

String getAlign()

Задаёт положение таблицы относительно остальной части документа. См. описание атрибута align в HTML 4.0. Этот атрибут устарел в HTML 4.0.

setAlign

void setAlign(String align)

getBgColor

String getBgColor()

Цвет фона ячейки. См. описание атрибута bgcolor в HTML 4.0. Этот атрибут устарел в HTML 4.0.

setBgColor

void setBgColor(String bgColor)

getBorder

String getBorder()

Ширина рамки вокруг таблицы. См. описание атрибута border в HTML 4.0.

setBorder

void setBorder(String border)

getCellPadding

String getCellPadding()

Задаёт горизонтальное и вертикальное расстояние между содержимым ячеек и их границами. См. описание атрибута cellpadding в HTML 4.0.

setCellPadding

void setCellPadding(String cellPadding)

getCellSpacing

String getCellSpacing()

Задаёт горизонтальное и вертикальное расстояние между ячейками. См. описание атрибута cellspacing в HTML 4.0.

setCellSpacing

void setCellSpacing(String cellSpacing)

getFrame

String getFrame()

Задаёт, какие внешние границы таблицы отображать. См. описание атрибута frame в HTML 4.0.

setFrame

void setFrame(String frame)

getRules

String getRules()

Задаёт, какие внутренние границы таблицы отображать. См. описание атрибута rules в HTML 4.0.

setRules

void setRules(String rules)

getSummary

String getSummary()

Описание назначения или структуры таблицы. См. описание атрибута summary в HTML 4.0.

setSummary

void setSummary(String summary)

getWidth

String getWidth()

Задаёт желаемую ширину таблицы. См. описание атрибута width в HTML 4.0.

setWidth

void setWidth(String width)

createTHead

HTMLElement createTHead()

Создаёт строку заголовка таблицы или возвращает существующую.

Возвращает:: Новый элемент заголовка таблицы (THEAD ).

deleteTHead

void deleteTHead()

Удаляет заголовок таблицы, если он существует.

createTFoot

HTMLElement createTFoot()

Создаёт строку нижнего колонтитула таблицы или возвращает существующую.

Возвращает:: Элемент нижнего колонтитула (TFOOT ).

deleteTFoot

void deleteTFoot()

Удаляет нижний колонтитул таблицы, если он существует.

createCaption

HTMLElement createCaption()

Создаёт новый объект заголовка таблицы или возвращает существующий.

Возвращает:: Элемент CAPTION.

deleteCaption

void deleteCaption()

Удаляет заголовок таблицы, если он существует.

insertRow

HTMLElement insertRow(int index) throws DOMException

Вставляет в таблицу новую пустую строку. Новая строка вставляется непосредственно перед текущей строкой index th и в том же разделе таблицы. Если index равно количеству строк, новая строка добавляется в конец. Кроме того, если таблица пуста, строка вставляется в TBODY, который создаётся и добавляется в таблицу. Примечание. Согласно рекомендации HTML 4.0, строка таблицы не может быть пустой.

Параметры:: index — номер строки, перед которой нужно вставить новую строку. Индексация начинается с 0 и выполняется относительно всех строк таблицы, независимо от их принадлежности к разделам.
Возвращает:: Созданная строка.
Вызывает исключение:: DOMException — INDEX_SIZE_ERR: возникает, если указанный индекс превышает количество строк или является отрицательным.

deleteRow

void deleteRow(int index) throws DOMException

Удаляет строку таблицы.

Параметры:: index — индекс удаляемой строки. Индексация начинается с 0 и выполняется относительно всех строк таблицы, независимо от их принадлежности к разделам.
Вызывает исключение:: DOMException — INDEX_SIZE_ERR: возникает, если указанный индекс больше или равен количеству строк либо является отрицательным.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/jdk.xml.dom/org/w3c/dom/html/HTMLTableElement.html