From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- files/ru/web/api/element/index.html | 297 ++++++++++++++++++++++++++++++++++++ 1 file changed, 297 insertions(+) create mode 100644 files/ru/web/api/element/index.html (limited to 'files/ru/web/api/element/index.html') diff --git a/files/ru/web/api/element/index.html b/files/ru/web/api/element/index.html new file mode 100644 index 0000000000..3f95a90be6 --- /dev/null +++ b/files/ru/web/api/element/index.html @@ -0,0 +1,297 @@ +--- +title: Element +slug: Web/API/Element +tags: + - API + - DOM + - Element + - Interface + - Reference +translation_of: Web/API/Element +--- +

{{ APIRef("DOM") }}

+ +

Интерфейс Element представляет собой один из объектов в {{domxref("Document")}}. Этот интерфейс описывает методы и свойства, общие для всех видов элементов. Конкретные модели поведения описаны в интерфейсах, которые наследуют от Element, и добавляют дополнительную функциональность.

+ +

Например, интерфейс {{domxref("HTMLElement")}} является базовым интерфейсом для HTML-элементов, в то время как интерфейс {{domxref("SVGElement")}} является основой для всех SVG-элементов.

+ +

Языки, находящиеся вне области веб-платформы, также используют его. Например, XUL — через интерфейс XULElement.

+ +

{{InheritanceDiagram}}

+ +

Свойства

+ +

Наследует свойства от родительского узла {{domxref("Node")}} и от собственного родителя {{domxref("EventTarget")}} и реализует свойства {{domxref("ParentNode")}}, {{domxref("ChildNode")}}, {{domxref("NonDocumentTypeChildNode")}}, and {{domxref("Animatable")}}.

+ +
+
{{ domxref("Element.assignedSlot")}} {{experimental_inline}} {{readOnlyInline}}
+
Возвращает {{domxref("HTMLSlotElement")}} интерфейс, связанный с элементом.
+
{{ domxref("Element.attributes") }} {{readOnlyInline}}
+
Возвращает {{ domxref("NamedNodeMap") }}, в котором перечислены все атрибуты связанные с элементом.
+
{{ domxref("Element.classList") }} {{readOnlyInline}}
+
Возвращает {{ domxref("DOMTokenList") }} содержащий список атрибутов класса.
+
{{ domxref("ParentNode.childElementCount") }}
+
Это {{jsxref("Number")}} представляющее число дочерних узлов, представленных в элементе.
+
{{ domxref("ParentNode.children") }}
+
Is a live {{ domxref("HTMLCollection") }}, содержащая все дочерние элементы, в виде коллекции.
+
{{ domxref("Element.className") }}
+
Это {{domxref("DOMString")}}, представляющая класс элемента.
+
{{ domxref("Element.clientHeight") }} {{experimental_inline}} {{readOnlyInline}}
+
Возвращает {{jsxref("Number")}}, представляющее внутреннюю высоту элемента.
+
{{ domxref("Element.clientLeft") }} {{experimental_inline}} {{readOnlyInline}}
+
Возвращает {{jsxref("Number")}}, предсталяющее ширину левой границы элемента.
+
{{ domxref("Element.clientTop") }} {{experimental_inline}} {{readOnlyInline}}
+
Возвращает {{jsxref("Number")}}, представляющее ширину верхней границы элемента.
+
{{ domxref("Element.clientWidth") }} {{experimental_inline}} {{readOnlyInline}}
+
Возвращает {{jsxref("Number")}}, представляющее внутреннюю ширину элемента.
+
{{ domxref("ParentNode.firstElementChild") }}
+
Возвращает {{ domxref("Element") }}, первый дочерний элемент элемента или null, если у элемента нет дочерних элементов.
+
{{ domxref("Element.id") }}
+
Возвращает {{domxref("DOMString")}}, представляющий идентификатор (Id) элемента.
+
{{ domxref("Element.innerHTML") }} {{experimental_inline}}
+
Является {{domxref("DOMString")}}, представляющей разметку контента элемента.
+
{{domxref("Element.namespaceURI")}} {{readonlyInline}}
+
Пространство имён URI элемента или null, если это не пространство имен.
+
+
+

Примечание: В Firefox версии 3.5 и ранее, HTML элементы не находятся в пространстве имен. В более поздних версиях, HTML элементы находятся в пространстве имен  http://www.w3.org/1999/xhtml  как в деревьях HTML, так и XML. {{ gecko_minversion_inline("1.9.2") }}

+
+
+
+ +
+
{{ domxref("ParentNode.lastElementChild") }}
+
Является {{ domxref("Element") }}, последним непосредственным дочерним элементом данного элемента, или null, если у элемента нет дочерних элементов.
+
{{ domxref("NonDocumentTypeChildNode.nextElementSibling") }}
+
Является {{ domxref("Element") }}, элементом, непосредственно следующим за данным в древе, или null, если соседний элемент отсутствует.
+
{{ domxref("Element.outerHTML") }} {{experimental_inline}}
+
Является {{domxref("DOMString")}}, представляющей разметку элемента, включая его контент. При использовании в качестве сеттера заменяет элемент узлами, структурированными из указанной строки.
+
{{ domxref("NonDocumentTypeChildNode.previousElementSibling") }}
+
Является {{ domxref("Element") }}, элементом, непосредственно предшествующим в древе данному, или null, если соседний элемент отсутствует.
+
{{ domxref("Element.scrollHeight") }} {{experimental_inline}} {{readOnlyInline}}
+
Возвращает {{jsxref("Number")}}, представляющее высоту прокрутки элемента.
+
{{ domxref("Element.scrollLeft") }} {{experimental_inline}}
+
Является {{jsxref("Number")}}, представляющим количество пикселей, на которые контент элемента прокручен влево.
+
{{ domxref("Element.scrollLeftMax") }} {{non-standard_inline}} {{readOnlyInline}}
+
Возвращает {{jsxref("Number")}}, представляющее максимально возможное количество пикселей, на которые можно прокрутить контент элемента влево.
+
{{ domxref("Element.scrollTop") }} {{experimental_inline}}
+
Является {{jsxref("Number")}}, представляющим количество пикселей, на которые контент элемента прокручен от верха.
+
{{ domxref("Element.scrollTopMax") }} {{non-standard_inline}} {{readOnlyInline}}
+
Вовзращает {{jsxref("Number")}}, представляющее максимально возможное количество пикселей, на которые можно прокрутить контент элемента от верха.
+
{{ domxref("Element.scrollWidth") }} {{experimental_inline}} {{readOnlyInline}}
+
Возвращает {{jsxref("Number")}}, представляющее ширину прокрутки элемента.
+
{{domxref("Element.shadowRoot") }} {{experimental_inline}} {{readOnlyInline}}
+
...
+
{{ domxref("Element.tagName") }} {{readOnlyInline}}
+
Возвращает {{domxref("String")}} с именем тега указанного элемента.
+
{{ domxref("Element.undoManager")}} {{experimental_inline}} {{readOnlyInline}}
+
Returns the {{domxref("UndoManager")}} associated with the element.
+
{{ domxref("Element.undoScope")}} {{experimental_inline}}
+
Представляет собой {{jsxref("Boolean")}}, указывающим, является элемент undo scope host, или нет.
+
+ +
+

Примечание: В DOM3 namespaceURI, localName и prefix определялись в интерфейсе {{domxref("Node")}}. В DOM4 они были перенесены в Element.

+ +

Данное изменение поддерживается в Chrome начиная с версии 46.0 и в Firefox с версии 48.0.

+
+ +

Обработчики событий

+ +
+
{{ domxref("Element.ongotpointercapture") }}
+
Возвращает обработчик событий для событий типа {{event("gotpointercapture")}}.
+
{{ domxref("Element.onlostpointercapture") }}
+
Возвращает обработчик событий для событий типа {{event("lostpointercapture")}}.
+
+ +

Устаревшие обработчики событий

+ +
+
{{ domxref("Element.onwheel") }} {{ non-standard_inline() }}
+
Возвращает код обработчика для события wheel.
+ Сейчас реализован в {{domxref("GlobalEventHandlers.onwheel", "GlobalEventHandlers")}}.
+
+ +

Методы

+ +

Наследует методы от своих родителей {{domxref("Node")}}, и своего собственного родителя {{domxref("EventTarget")}}, и реализует методы {{domxref("ParentNode")}}, {{domxref("ChildNode")}}, {{domxref("NonDocumentTypeChildNode")}}, и {{domxref("Animatable")}}.

+ +
+
{{ domxref("EventTarget.addEventListener()") }}
+
Регистрирует обработчик событий для опрделенного типа событий в элементе.
+
{{ domxref("Element.closest()")}} {{experimental_inline}}
+
Возращает {{domxref("Element")}}, потомка этого элемента (или сам этот элемент), который является ближайшим предком элементов, выбраных селекторами, указанными в параметре.
+
{{ domxref("Element.createShadowRoot()")}} {{experimental_inline}}
+
…
+
{{ domxref("EventTarget.dispatchEvent()") }}
+
Отправляет событие для этого узла в DOM и возвращает {{jsxref("Boolean")}}, который указывает, что по крайней мере один обработчик не отменил его.
+
{{domxref("Element.find()")}}{{experimental_inline}}
+
...
+
{{domxref("Element.findAll()")}}{{experimental_inline}}
+
...
+
{{domxref("Animatable.getAnimationPlayers()")}} {{experimental_inline}}
+
…
+
{{ domxref("Element.getAttribute()") }}
+
Извлекает значение именованного атрибута из текущего узла и возвращает его в виде{{jsxref("Object")}}.
+
{{ domxref("Element.getAttributeNS()") }}
+
Извлекает значение атрибута с указанным именем и пространством имен из текущего узла и возвращает его как {{jsxref("Object")}}.
+
{{ domxref("Element.getAttributeNode()") }} {{obsolete_inline}}
+
Извлекает представление узла именованного атрибута из текущего узла и возвращает его в виде {{ domxref("Attr") }}.
+
{{ domxref("Element.getAttributeNodeNS()") }} {{obsolete_inline}}
+
Извлекает представление узла атрибута с указанным именем и пространством имен из текущего узла и возвращает его в виде {{ domxref("Attr") }}.
+
{{ domxref("Element.getBoundingClientRect()") }} {{experimental_inline}}
+
...
+
{{ domxref("Element.getClientRects()") }} {{experimental_inline}} TYPE of returnvalue????
+
Returns a collection of rectangles that indicate the bounding rectangles for each line of text in a client.
+
{{domxref("Element.getDestinationInsertionPoints()")}} {{experimental_inline}}
+
…
+
{{ domxref("Element.getElementsByClassName()") }}
+
Возвращает коллекцию {{ domxref ("HTMLCollection")}}, которая содержит все элементы, у которых название класса совпадает с тем, что заданно в параметрах функции.
+
{{ domxref("Element.getElementsByTagName()") }}
+
Возвращает коллекцию {{ domxref ("HTMLCollection")}}, которая содержит все элементы, у которых название тега совпадает с тем, что заданно в параметрах функции.
+
{{ domxref("Element.getElementsByTagNameNS()") }}
+
Возвращает коллекцию {{ domxref ("HTMLCollection")}}, которая содержит все элементы, у которых название тега и пространства имён совпадает с тем, что заданно в параметрах функции.
+
{{ domxref("Element.hasAttribute()") }}
+
Вовзращает {{jsxref("Boolean")}}, указывающее, имеет элемент определенный атрибут, или нет.
+
{{ domxref("Element.hasAttributeNS()") }}
+
Возвращает {{jsxref("Boolean")}}, указывающий, имеет элемент определенный атрибут в определенном пространстве имен, или нет.
+
{{ domxref("Element.insertAdjacentHTML") }} {{experimental_inline}}
+
Анализирует текст как HTML или XML и вставляет полученные узлы в указанную позицию дерева элементов.
+
{{ domxref("Element.matches()") }} {{experimental_inline}}
+
Возвращает {{jsxref ("Boolean")}}, указывающий, будет ли элемент выбран указанной строкой селектора.
+
{{ domxref("Element.querySelector()") }}
+
Возвращает первый {{DOMxRef ("Node")}}, который соответствует указанной строке селектора элемента.
+
{{ domxref("Element.querySelectorAll") }}
+
Возвращает список {{DOMxRef ("NodeList")}} узлов, которые соответствуют указанной строке селектора элемента.
+
{{ domxref("Element.releasePointerCapture")}} {{experimental_inline}}
+
Позволяет понять, имеет ли элемент с указанным ID  захват указателя для указателя
+
{{domxref("ChildNode.remove()")}}
+
Удаляет элемент из списка дочерних элементов родительского элемента.
+
{{ domxref("Element.removeAttribute()") }}
+
Удаляет именованный атрибут из текущего узла.
+
{{ domxref("Element.removeAttributeNS()") }}
+
Удаляет атрибут с указанным именем и пространством имен, из текущего узла.
+
{{ domxref("Element.removeAttributeNode()") }} {{obsolete_inline}}
+
Удаляет представление узла именованного атрибута из текущего узла.
+
{{ domxref("EventTarget.removeEventListener()") }}
+
Удаляет прослушиватель событий из элемента.
+
{{ domxref("Element.requestFullscreen()") }} {{experimental_inline}}
+
Асинхронно запрашивает браузер, чтобы сделать элемент полноэкранным.
+
{{ domxref("Element.requestPointerLock()")}} {{experimental_inline}}
+
Позволяет асинхронно запрашивать блокировку указателя для данного элемента.
+
+ +
+
{{ domxref("Element.scrollIntoView()") }} {{experimental_inline}}
+
Прокручивает страницу до тех пор, пока элемент не попадет в представление.
+
{{ domxref("Element.setAttribute()") }}
+
Устанавливает значение именованного атрибута из текущей узла.
+
{{ domxref("Element.setAttributeNS()") }}
+
Устанавливает значение атрибута с опрделенным именем и пространством имен из текущей узла.
+
{{ domxref("Element.setAttributeNode()") }} {{obsolete_inline}}
+
Задает представление узла именованного атрибута из текущего узла.
+
{{ domxref("Element.setAttributeNodeNS()") }} {{obsolete_inline}}
+
Установите представление узла атрибута с указанным именем и пространством имен из текущего узла.
+
{{ domxref("Element.setCapture()") }} {{non-standard_inline}}
+
Настройка захвата событий мыши, перенаправление всех событий мыши на этот элемент.
+
{{domxref("Element.setPointerCapture()")}}
+
Определяет указанный элемент как цель захвата будущих событий указателя.
+
+ +

Спецификации

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName("Web Animations", '', '')}}{{Spec2("Web Animations")}}Добавлен метод getAnimationPlayers().
{{SpecName('Undo Manager', '', 'Element')}}{{Spec2('Undo Manager')}}Добавлены свойства undoScope и undoManager.
{{SpecName('Pointer Events', '#extensions-to-the-element-interface', 'Element')}}{{Spec2('Pointer Events')}}Добавлены следующие обработчики событий: ongotpointercapture и onlostpointercapture.
+ Добавлены следующие методы: setPointerCapture() и releasePointerCapture().
{{SpecName('Selectors API Level 2', '#interface-definitions', 'Element')}}{{Spec2('Selectors API Level 2')}}Добавлены следующие методы: matches() (реализовано как mozMatchesSelector()), find(), findAll().
{{SpecName('Selectors API Level 1', '#interface-definitions', 'Element')}}{{Spec2('Selectors API Level 1')}}Добавлены следующиен методы: querySelector() и querySelectorAll().
{{SpecName('Pointer Lock', 'index.html#element-interface', 'Element')}}{{Spec2('Pointer Lock')}}Добавлен метод requestPointerLock().
{{SpecName('Fullscreen', '#api', 'Element')}}{{Spec2('Fullscreen')}}Добавлен метод requestFullscreen().
{{SpecName('DOM Parsing', '#extensions-to-the-element-interface', 'Element')}}{{Spec2('DOM Parsing')}}Добавлены следующие свойства: innerHTML, и outerHTML.
+ Добавлен следующий метод: insertAdjacentHTML().
{{SpecName('CSSOM View', '#extensions-to-the-element-interface', 'Element')}}{{Spec2('CSSOM View')}}Добавлены следующие свойства: scrollTop, scrollLeft, scrollWidth, scrollHeight, clientTop, clientLeft, clientWidth, и clientHeight.
+ Добавлены следующие методы: getClientRects(), getBoundingClientRect(), и scrollIntoView().
{{SpecName('Element Traversal', '#ecmascript-bindings', 'Element')}}{{Spec2('Element Traversal')}}Добавлено наследование интерфейса {{domxref("ElementTraversal")}}.
{{SpecName('DOM WHATWG', '#interface-element', 'Element')}}{{Spec2('DOM WHATWG')}}Удалены следующие методы: closest(), setIdAttribute(), setIdAttributeNS(), и setIdAttributeNode().
+ Удалено свойство schemaTypeInfo.
+ Измененно возращаемое значение getElementsByTag() и getElementsByTagNS().
+ Moved hasAttributes() form the Node interface to this one.
{{SpecName('DOM3 Core', 'core.html#ID-745549614', 'Element')}}{{Spec2('DOM3 Core')}}Added the following methods: setIdAttribute(), setIdAttributeNS(), and setIdAttributeNode(). These methods were never implemented and have been removed in later specifications.
+ Added the schemaTypeInfo property. This property was never implemented and has been removed in later specifications.
{{SpecName('DOM2 Core', 'core.html#ID-745549614', 'Element')}}{{Spec2('DOM2 Core')}}Мнтод normalize() был перемещён в {{domxref("Node")}}.
{{SpecName('DOM1', 'level-one-core.html#ID-745549614', 'Element')}}{{Spec2('DOM1')}}Начальное определение.
+ +

Совместимость с браузерами

+ +
{{Compat("api.Element")}}
+ +
-- cgit v1.2.3-54-g00ecf