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

Справочная статья HTMLElement, имевшаяся в предыдущем издании этой книги, теперь объединена с этой справочной статьей. Обратите внимание, что некоторые свойства, методы и обработчики, описываемые здесь, могут использоваться только при работе с HTML-документами и не могут применяться к XML-документам.

Свойства

Помимо свойств, перечисленных ниже, HTML-атрибуты HTML-элементов доступны в виде свойств объектов

<b>Element</b>
. HTML-теги и их стандартные атрибуты перечислены в конце этой справочной статьи.

<b>readonly Attг[] attributes</b>

Объект, подобный массиву, содержащий объекты

<b>Attr</b>
, представляющие HTML-или XML-атрибуты данного элемента. Однако в общем случае объекты
<b>Element</b>
обеспечивают доступ к атрибутам, как к JavaScript-свойствам, поэтому почти никогда не возникает необходимости использовать массив
<b>attributes[].</b>

<b>readonly unsigned long childElementCount</b>

Количество дочерних элементов (не дочерних узлов), которые имеет данный элемент.

<b>readonly HTMLCollection children</b>

Объект, подобный массиву, содержащий дочерние элементы (исключая дочерние узлы, не являющиеся элементами

<b>Element</b>
, такие как
<b>Text</b>
и
<b>Comment</b>
).

<b>readonly DOMTokenList classList</b>

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

<b>class</b>
элемента представляет собой список имен классов, разделенных пробелами. Данное свойство позволяет получить доступ к отдельным элементам этого списка и определяет методы чтения, добавления, удаления и переключения отдельных имен классов. Подробности смотрите в справочной статье DOMTokenList.

<b>string className</b>

Это свойство представляет атрибут

<b>class</b>
элемента. В языке JavaScript
<b>class</b>
является зарезервированным словом, поэтому свойство получило имя
<b>className</b>
, а не
<b>class</b>
. Обратите внимание, что такое имя этого свойства [62] может вводить в заблуждение, поскольку атрибут
<b>class</b>
часто включает более одного имени класса.

<b>readonly long clientHeight </b>

<b>readonly long clientWidth</b>

Если данный элемент является корневым элементом (

<b>document.documentElement</b>
), эти свойства возвращают внутренние размеры окна, т. е. размеры видимой области, куда не входят полосы прокрутки и другие элементы управления, добавляемые броузером. Иначе эти свойства возвращают размеры содержимого элемента плюс отступы.

<b>readonly long clientLeft </b>

<b>readonly long clientTop</b>

Эти свойства возвращают расстояние в пикселах между левой или верхней рамкой элемента и левой или верхней границей отступов. Обычно это просто толщина левой или верхней стороны рамки, но сюда также может входить ширина полос прокрутки, если они отображаются вдоль левого или верхнего края элемента.

<b>CSSStyleDeclaration currentStyle</b>

Это свойство, реализованное только в IE, является представлением каскадного набора всех CSS-свойств, применяемых к элементу. В IE версии 8 и ниже его можно использовать как замену стандартному методу

<b>Window.getComputedStyle()</b>
.

<b>readonly object dataset</b>

С любым HTML-элементом можно связать любые значения, присваивая их атрибутам, имена которых начинаются с префикса «data-». Данное свойство

<b>dataset</b>
представляет множество атрибутов с данными и упрощает работу с ними. Значение этого свойства ведет себя как обычный объект. Каждое свойство объекта соответствует одному атрибуту с данными. Если элемент имеет атрибут с именем
<b>data-x</b>
, объект
<b>dataset</b>
получит свойство с именем х, и
<b>dataset</b>
, х будет возвращать то же значение, что и вызов
<b>getAttribute(&quot;data-x&quot;).</b>

Операции чтения и присваивания значений свойствам объекта

<b>dataset</b>
будут читать и присваивать значения соответствующим атрибутам с данными этого элемента. Оператор delete можно использовать для удаления атрибутов с данными, а цикл
<b>for/in</b>
- для их перечисления.

<b>readonly Element firstElementChild</b>

Это свойство подобно свойству

<b>fіrstChild</b>
объекта
<b>Node</b>
, но оно игнорирует узлы
<b>Text</b>
и
<b>Comment</b>
и возвращает только элементы типа
<b>Element</b>
.

<b>string id</b>

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

<b>id</b>
. Никакие два элемента в одном документе не должны иметь одинаковые значения атрибута
<b>id</b>
.

<b>string innerHTHL</b>

Доступная для чтения и записи строка, которая определяет текст разметки HTML или XML, содержащийся внутри элемента, за исключением открывающего и закрывающего тегов самого элемента. Операция чтения этого свойства возвращает содержимое элемента в виде строки HTML- или XML-текста. Операция записи замещает содержимое элемента представлением HTML- или XML-текста после его синтаксического разбора.

<b>readonly boolean isContentEditable</b>

Это свойство имеет значение true, если элемент доступен для редактирования, и false - в противном случае. Элемент может быть доступен для редактирования вследствие установки свойства

<b>contenteditable</b>
в нем или в его родителе, или вследствие установки свойства
<b>designMode</b>
вмещающего объекта
<b>Document.</b>

<b>string lang</b>

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

<b>lang</b>
, определяющее код языка для содержимого элемента.

<b>readonly Element lastElementChild</b>