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

Флэнаган Дэвид
Шрифт:

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

Свойства

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

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

readonly Attг[] attributes

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

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

readonly unsigned long childElementCount

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

readonly HTMLCollection children

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

Element
, такие как
Text
и
Comment
).

readonly DOMTokenList classList

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

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

string className

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

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

62

Имя свойства указывается в форме единственного числа.
– Прим, перев.

readonly long clientHeight

readonly long clientWidth

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

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

readonly long clientLeft

readonly long clientTop

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

CSSStyleDeclaration currentStyle

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

Window.getComputedStyle
.

readonly object dataset

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

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

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

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

readonly Element firstElementChild

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

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