Справочная статья 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
.
string id
Значение атрибута
id
. Никакие два элемента в одном документе не должны иметь одинаковые значения атрибута
id
.
string innerHTHL
Доступная для чтения и записи строка, которая определяет текст разметки HTML или XML, содержащийся внутри элемента, за исключением открывающего и закрывающего тегов самого элемента. Операция чтения этого свойства возвращает содержимое элемента в виде строки HTML- или XML-текста. Операция записи замещает содержимое элемента представлением HTML- или XML-текста после его синтаксического разбора.
readonly boolean isContentEditable
Это свойство имеет значение true, если элемент доступен для редактирования, и false - в противном случае. Элемент может быть доступен для редактирования вследствие установки свойства
contenteditable
в нем или в его родителе, или вследствие установки свойства
designMode
вмещающего объекта
Document.
string lang
Значение атрибута
lang
, определяющее код языка для содержимого элемента.