Интерфейс 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

Модификатор и тип	Поле	Описание
`static final short`	`ATTRIBUTE_NODE`	Узел является `Attr`.
`static final short`	`CDATA_SECTION_NODE`	Узел является `CDATASection`.
`static final short`	`COMMENT_NODE`	Узел является `Comment`.
`static final short`	`DOCUMENT_FRAGMENT_NODE`	Узел является `DocumentFragment`.
`static final short`	`DOCUMENT_NODE`	Узел является `Document`.
`static final short`	`DOCUMENT_POSITION_CONTAINED_BY`	Узел содержится в опорном узле.
`static final short`	`DOCUMENT_POSITION_CONTAINS`	Узел содержит опорный узел.
`static final short`	`DOCUMENT_POSITION_DISCONNECTED`	Узлы не связаны.
`static final short`	`DOCUMENT_POSITION_FOLLOWING`	Узел следует за опорным узлом.
`static final short`	`DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC`	Определение того, какой узел является предшествующим, а какой следующим, зависит от реализации.
`static final short`	`DOCUMENT_POSITION_PRECEDING`	Второй узел предшествует опорному узлу.
`static final short`	`DOCUMENT_TYPE_NODE`	Узел является `DocumentType`.
`static final short`	`ELEMENT_NODE`	Узел является `Element`.
`static final short`	`ENTITY_NODE`	Узел является `Entity`.
`static final short`	`ENTITY_REFERENCE_NODE`	Узел является `EntityReference`.
`static final short`	`NOTATION_NODE`	Узел является `Notation`.
`static final short`	`PROCESSING_INSTRUCTION_NODE`	Узел является `ProcessingInstruction`.
`static final short`	`TEXT_NODE`	Узел является узлом `Text`.

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

Модификатор и тип	Метод	Описание
`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

Модификатор и тип	Метод	Описание
`String`	`getAttribute(String name)`	Получает значение атрибута по имени.
`Attr`	`getAttributeNode(String name)`	Получает узел атрибута по имени.
`Attr`	`getAttributeNodeNS(String namespaceURI, String localName)`	Получает узел `Attr` по локальному имени и URI пространства имен.
`String`	`getAttributeNS(String namespaceURI, String localName)`	Получает значение атрибута по локальному имени и URI пространства имен.
`NodeList`	`getElementsByTagName(String name)`	Возвращает `NodeList` всех дочерних `Elements` с заданным именем тега в порядке следования в документе.
`NodeList`	`getElementsByTagNameNS(String namespaceURI, String localName)`	Возвращает `NodeList` всех дочерних `Elements` с заданным локальным именем и URI пространства имен в порядке следования в документе.
`TypeInfo`	`getSchemaTypeInfo()`	Сведения о типе, связанные с этим элементом.
`String`	`getTagName()`	Имя элемента.
`boolean`	`hasAttribute(String name)`	Возвращает `true`, если для этого элемента задан атрибут с указанным именем или он имеет значение по умолчанию, и `false` в противном случае.
`boolean`	`hasAttributeNS(String namespaceURI, String localName)`	Возвращает `true`, если для этого элемента задан атрибут с указанным локальным именем и URI пространства имен или он имеет значение по умолчанию, и `false` в противном случае.
`void`	`removeAttribute(String name)`	Удаляет атрибут по имени.
`Attr`	`removeAttributeNode(Attr oldAttr)`	Удаляет указанный узел атрибута.
`void`	`removeAttributeNS(String namespaceURI, String localName)`	Удаляет атрибут по локальному имени и URI пространства имен.
`void`	`setAttribute(String name, String value)`	Добавляет новый атрибут.
`Attr`	`setAttributeNode(Attr newAttr)`	Добавляет новый узел атрибута.
`Attr`	`setAttributeNodeNS(Attr newAttr)`	Добавляет новый атрибут.
`void`	`setAttributeNS(String namespaceURI, String qualifiedName, String value)`	Добавляет новый атрибут.
`void`	`setIdAttribute(String name, boolean isId)`	Если параметр `isId` имеет значение `true`, этот метод объявляет указанный атрибут идентификатором, определяемым пользователем.
`void`	`setIdAttributeNode(Attr idAttr, boolean isId)`	Если параметр `isId` имеет значение `true`, этот метод объявляет указанный атрибут идентификатором, определяемым пользователем.
`void`	`setIdAttributeNS(String namespaceURI, String localName, boolean isId)`	Если параметр `isId` имеет значение `true`, этот метод объявляет указанный атрибут идентификатором, определяемым пользователем.

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

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

Модификатор и тип	Метод	Описание
`String`	`getClassName()`	Атрибут class элемента.
`String`	`getDir()`	Задает базовое направление текста с нейтральным направлением и направленность таблиц.
`String`	`getId()`	Идентификатор элемента.
`String`	`getLang()`	Код языка, определенный в RFC 1766.
`String`	`getTitle()`	Вспомогательный заголовок элемента.
`void`	`setClassName(String className)`
`void`	`setDir(String dir)`
`void`	`setId(String id)`
`void`	`setLang(String lang)`
`void`	`setTitle(String title)`

Методы, объявленные в интерфейсе 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

Модификатор и тип	Метод	Описание
`Node`	`appendChild(Node newChild)`	Добавляет узел `newChild` в конец списка дочерних узлов этого узла.
`Node`	`cloneNode(boolean deep)`	Возвращает копию этого узла, то есть служит универсальным конструктором копирования узлов.
`short`	`compareDocumentPosition(Node other)`	Сравнивает опорный узел, то есть узел, для которого вызывается этот метод, с другим узлом, переданным в качестве параметра, с точки зрения их положения в документе и в соответствии с порядком следования в документе.
`NamedNodeMap`	`getAttributes()`	Объект `NamedNodeMap`, содержащий атрибуты этого узла (если он является `Element`), или `null` в противном случае.
`String`	`getBaseURI()`	Абсолютный базовый URI этого узла или `null`, если реализации не удалось получить абсолютный URI.
`NodeList`	`getChildNodes()`	Объект `NodeList`, содержащий все дочерние узлы этого узла.
`Object`	`getFeature(String feature, String version)`	Этот метод возвращает специализированный объект, реализующий специализированные API указанной функции и версии, как определено в .
`Node`	`getFirstChild()`	Первый дочерний узел этого узла.
`Node`	`getLastChild()`	Последний дочерний узел этого узла.
`String`	`getLocalName()`	Возвращает локальную часть квалифицированного имени этого узла.
`String`	`getNamespaceURI()`	URI пространства имен этого узла или `null`, если он не указан (см. ).
`Node`	`getNextSibling()`	Узел, непосредственно следующий за этим узлом.
`String`	`getNodeName()`	Имя этого узла, зависящее от его типа; см. таблицу выше.
`short`	`getNodeType()`	Код, представляющий тип базового объекта, как определено выше.
`String`	`getNodeValue()`	Значение этого узла, зависящее от его типа; см. таблицу выше.
`Document`	`getOwnerDocument()`	Объект `Document`, связанный с этим узлом.
`Node`	`getParentNode()`	Родительский узел этого узла.
`String`	`getPrefix()`	Префикс пространства имен этого узла или `null`, если он не указан.
`Node`	`getPreviousSibling()`	Узел, непосредственно предшествующий этому узлу.
`String`	`getTextContent()`	Этот атрибут возвращает текстовое содержимое данного узла и его потомков.
`Object`	`getUserData(String key)`	Получает объект, связанный с ключом в этом узле.
`boolean`	`hasAttributes()`	Возвращает, содержит ли этот узел (если он является элементом) какие-либо атрибуты.
`boolean`	`hasChildNodes()`	Возвращает, есть ли у этого узла дочерние узлы.
`Node`	`insertBefore(Node newChild, Node refChild)`	Вставляет узел `newChild` перед существующим дочерним узлом `refChild`.
`boolean`	`isDefaultNamespace(String namespaceURI)`	Этот метод проверяет, является ли указанный `namespaceURI` пространством имен по умолчанию.
`boolean`	`isEqualNode(Node arg)`	Проверяет, равны ли два узла.
`boolean`	`isSameNode(Node other)`	Возвращает, является ли этот узел тем же узлом, что и заданный.
`boolean`	`isSupported(String feature, String version)`	Проверяет, реализует ли реализация DOM определенную функцию и поддерживается ли эта функция данным узлом, как указано в .
`String`	`lookupNamespaceURI(String prefix)`	Ищет URI пространства имен, связанный с заданным префиксом, начиная с этого узла.
`String`	`lookupPrefix(String namespaceURI)`	Ищет префикс, связанный с заданным URI пространства имен, начиная с этого узла.
`void`	`normalize()`	Приводит все узлы `Text` на всей глубине поддерева, расположенного под этим `Node`, включая узлы атрибутов, к «нормальной» форме, в которой узлы `Text` разделяются только структурными элементами (например, элементами, комментариями, инструкциями по обработке, разделами CDATA и ссылками на сущности), то есть отсутствуют соседние узлы `Text` и пустые узлы `Text`.
`Node`	`removeChild(Node oldChild)`	Удаляет дочерний узел, указанный параметром `oldChild`, из списка дочерних узлов и возвращает его.
`Node`	`replaceChild(Node newChild, Node oldChild)`	Заменяет дочерний узел `oldChild` на `newChild` в списке дочерних узлов и возвращает узел `oldChild`.
`void`	`setNodeValue(String nodeValue)`	Значение этого узла, зависящее от его типа; см. таблицу выше.
`void`	`setPrefix(String prefix)`	Префикс пространства имен этого узла или `null`, если он не указан.
`void`	`setTextContent(String textContent)`	Этот атрибут возвращает текстовое содержимое данного узла и его потомков.
`Object`	`setUserData(String key, Object data, UserDataHandler handler)`	Связывает объект с ключом в этом узле.

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

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.