Элементы и атрибуты - Программирование от RIN.RU

Программирование

ПОИСК

Главная / DHTML /

8  Perl
8  PHP
8  JavaScript
8  HTML
8  DHTML
8  XML
8  CSS
8  C / C++
8  Pascal и Delphi
8  Турбо Ассемблер
8  MySQL
8  CASE-технологии
8  Алгоритмы
8  Python
8  Обратная связь
8  Гостевая книга

Элементы и атрибуты - Программирование от RIN.RU

Элементы и атрибуты

Элемент: интерфейс Element

Поддержка : Поддерживается для XML-документов (XMLDOMEelement); для HTML-документов поддерживается частично.
Соответствует стандарту.

Интерфейс Element соответствует элементу XML- или HTML-документа. Он наследует интерфейс Node.

Свойства интерфейса Element
Свойство Изменяемое Модель Описание
tagName Нет DOM 1 Имя тега.

Методы интерфейса Element
Метод Модель Описание
getAttribute DOM 1 Возвращает значение заданного атрибута.
getAttributeNS DOM 2 Возвращает значение заданного атрибута с учетом пространства имен.
getAttributeNode DOM 1 Возвращает заданный узел Attr.
getAttributeNodeNS DOM 2 Возвращает заданный узел Attr с учетом пространства имен.

getElementsByTagName DOM 1 Возвращает список потомков, имеющих заданный тег.
getElementsByTagNameNS DOM 2 Возвращает список потомков, имеющих заданный тег, с учетом пространства имен.
hasAttribute DOM 2 Проверяет наличие заданного атрибута.
hasAttributeNS DOM 2 Проверяет наличие заданного атрибута с учетом пространства имен.
removeAttribute DOM 1 Удаляет заданный атрибут.
removeAttributeNS DOM 2 Удаляет заданный атрибут с учетом пространства имен.
removeAttributeNode DOM 1 Удаляет заданный узел Attr.
setAttribute DOM 1 Добавляет новый атрибут.
setAttributeNS DOM 2 Добавляет новый атрибут с учетом пространства имен.
setAttributeNode DOM 1 Добавляет новый узел Attr.
setAttributeNodeNS DOM 2 Добавляет новый узел Attr с учетом пространства имен.

Свойство tagName

Синтаксис: элемент.tagName
Изменяемое: нет

Поддержка : Соответствует стандарту.
Соответствует стандарту.

Свойство tagName возвращает строку, содержащую имя тега данного элемента. Имя тега HTML всегда преобразуется в прописные буквы, тогда как имя тега XML хранится так, как оно задано в документе. Это свойство является избыточным, т. к. его значение всегда совпадает со значением свойства nodeName. Пример: оператор

alert(document.documentElement.tagName);

выведет на экран строку HTML.

Метод getAttribute

Синтаксис: элемент.getAttribute(name)
Аргументы: name - выражение типа DOMString
Результат: значение типа DOMString
Исключения: нет

Поддержка : Соответствует стандарту.
Соответствует стандарту.

Метод getAttribute возвращает значение атрибута, имеющего имя name. Если атрибут не имеет значения, то возвращается пустая строка. Пример:

<BODY text="blue">
<SCRIPT>
alert(document.body.getAttribute("text"));
</SCRIPT>
</BODY>

Оператор alert в Internet Explorer выведет строку #0000ff, а в Gecko - строку blue.

Метод getAttributeNS

Синтаксис: элемент.getAttributeNS(namespaceURI, localName)
Аргументы: namespaceURI, localName - выражения типа DOMString
Результат: значение типа DOMString

Поддержка : Не поддерживается.
Не поддерживается.

Метод getAttributeNS возвращает значение заданного атрибута. Если атрибут не имеет значения, то возвращается пустая строка. Этот метод предназначен для XML-документов и для HTML-документов может не поддерживаться. Аргумент namespaceURI задает URI пространства имен, а localName - локальное имя атрибута.

Метод getAttributeNode

Синтаксис: элемент.getAttributeNode(name)
Аргументы: name - выражение типа DOMString
Результат: значение типа Attr или null
Исключения: нет

Поддержка : Только для XML-документов.
Соответствует стандарту.

Метод getAttributeNode возвращает указатель на объект Attr, соответствующий атрибуту с именем name. Если такого атрибута нет, то возвращается null. Пример:

<BODY text="blue">
<SCRIPT>
alert(document.body.getAttributeNode("text").nodeValue);
</SCRIPT>
</BODY>

Оператор alert в Gecko выведет строку blue (Internet Explorer этот метод не поддерживает).

Метод getAttributeNodeNS

Синтаксис: элемент.getAttributeNodeNS(namespaceURI, localName)
Аргументы: namespaceURI, localName - выражения типа DOMString
Результат: значение типа Attr или null
Исключения: нет

Поддержка : Не поддерживается.
Не поддерживается.

Метод getAttributeNodeNS возвращает указатель на объект Attr, соответствующий заданному атрибуту. Если такого атрибута нет, то возвращается null. Этот метод предназначен для XML-документов и для HTML-документов может не поддерживаться. Аргумент namespaceURI задает URI пространства имен, а localName - локальное имя атрибута.

Метод getElementsByTagName

Синтаксис: элемент.getElementsByTagName(tagname)
Аргументы: tagname - выражение типа DOMString
Результат: объект NodeList
Исключения: нет

Поддержка : Соответствует стандарту (см. прим.).
Соответствует стандарту.

Метод getElementsByTagNames создает новый объект NodeList, состоящий из всех потомков данного элемента типа Element, имеющих заданное имя и возвращает указатель на него. Аргумент tagname задает искомый тег; если он равен "*", то возвращается список всех элементов документа.

Примечание. Internet Explorer не поддерживает специальное имя "*". В нем вместо element.getElementsByTagName("*") следует использовать нестандартное свойство element.all.

Следующий пример выводит на экран количество графических образов в документе, а затем URI первого образа:

var imgList = document.body.getElementsByTagName("IMG");
alert(imgList.length);
alert(imgList[0].src);

Метод getElementsByTagNameNS

Синтаксис: элемент.getElementsByTagNameNS(namespaceURI, localName)
Аргументы: namespaceURI, localName - выражения типа DOMString
Результат: объект NodeList
Исключения: нет

Поддержка : Не поддерживается.
Не поддерживается.

Метод getElementsByTagNamesNS создает новый объект NodeList, состоящий из всех потомков данного элемента типа Element, имеющих заданное имя и возвращает указатель на него. Он предназначен для XML-документов и для HTML-документов может не поддерживаться. Аргумент namespaceURI задает URI пространства имен, а localName - локальное имя искомого тега в этом пространстве имен; если он равен "*", то возвращается список всех элементов документа, относящихся к данному словарю.

Метод hasAttribute

Синтаксис: элемент.hasAttribute(name)
Аргументы: name - выражение типа DOMString
Результат: логическое значение
Исключения: нет

Поддержка : Не поддерживается.
Соответствует стандарту.

Метод hasAttribute возвращает true, если элемент имеет атрибут с именем name, и false в противном случае. Пример:

<BODY text="blue">
<SCRIPT>
alert(document.body.hasAttribute("text"));
alert(document.body.hasAttribute("size"));
</SCRIPT>
</BODY>

Первый оператор alert выведет в Gecko строку true, второй - строку false.

Метод hasAttributeNS

Синтаксис: элемент.hasAttributeNS(namespaceURI, localName)
Аргументы: namespaceURI, localName - выражения типа DOMString
Результат: логическое значение
Исключения: нет

Поддержка : Не поддерживается.
Не поддерживается.

Метод hasAttributeNS возвращает true, если элемент имеет заданный атрибут, и false в противном случае. Он предназначен для XML-документов и для HTML-документов может не поддерживаться. Аргумент namespaceURI задает URI пространства имен, а localName - локальное имя атрибута.

Метод removeAttribute

Синтаксис: элемент.removeAttribute(name)
Аргументы: name - выражение типа DOMString
Исключения: NO_MODIFICATION_ALLOWED_ERR

Поддержка : Соответствует стандарту.
Соответствует стандарту.

Метод removeAttribute удаляет атрибут с именем name. Если атрибут имеет значение по умолчанию, то он немедленно появляется вновь, со значением по умолчанию. Пример:

var elem = document.getElementsByTagName("BODY")[0];
elem.removeAttribute("text");
alert(elem.getAttribute("text"));

Оператор alert выведет на экран пустую строку.

Метод removeAttributeNS

Синтаксис: элемент.removeAttributeNS(namespaceURI, localName)
Аргументы: namespaceURI, localName - выражения типа DOMString
Исключения: NO_MODIFICATION_ALLOWED_ERR

Поддержка : Не поддерживается.
Не поддерживается.

Метод removeAttributeNS удаляет заданный атрибут. Если атрибут имеет значение по умолчанию, то он немедленно появляется вновь, со значением по умолчанию. Этот метод предназначен для XML-документов и для HTML-документов может не поддерживаться. Аргумент namespaceURI задает URI пространства имен, а localName -локальное имя атрибута.

Метод removeAttributeNode

Синтаксис: элемент.removeAttributeNode(oldAttr)
Аргументы: oldAttr - выражение типа Attr
Результат: объект типа Attr
Исключения: NO_MODIFICATION_ALLOWED_ERR, NOT_FOUND_ERR

Поддержка : Только для XML-документов.
Соответствует стандарту.

Метод removeAttributeNode удаляет заданный узел oldAttr и возвращает указатель на него. Если атрибут имеет значение по умолчанию, то он немедленно появляется вновь, со значением по умолчанию. Пример:

document.body.removeAttributeNode(elem.getAttributeNode("text"));

Метод setAttribute

Синтаксис: элемент.setAttribute(name, value)
Аргументы: name, value - выражения типа DOMString

Поддержка : Соответствует стандарту.
Соответствует стандарту.

Метод setAttribute создает новый атрибут с именем name и значением value. Если атрибут с таким именем уже есть, то ему просто присваивается новое значение. Следующий пример изменяет цвет отображения текста документа на зеленый:

document.body.setAttribute("text", "green");

При работе с XML-документами следует учитывать, что значение value рассматривается как обычная строка и не анализируется XML-процессором. Поэтому если мы хотим присвоить атрибуту значение, содержащее ссылки на разделы, то должны сначала создать новый узел Attr, затем создать необходимые узлы Text и EntityReference, включить их в дерево атрибута и присоединить все созданное дерево к элементу методом setAttributeNode.

Метод setAttributeNS

Синтаксис: элемент.setAttributeNS(namespaceURI, qualifiedName, value)
Аргументы: namespaceURI, qualifiedName, value - выражения типа DOMString
Исключения: INVALID_CHARACTER_ERR, NO_MODIFICATION_ALLOWED_ERR, NAMESPACE_ERR

Поддержка : Не поддерживается.
Не поддерживается.

Метод setAttributeNS создает новый атрибут с заданным именем и значением value. Если атрибут с таким именем уже есть, то ему просто присваивается новое значение. Этот метод предназначен для XML-документов и для HTML-документов может не поддерживаться. Аргумент namespaceURI задает URI пространства имен, а qualifiedName - ограниченное имя атрибута. При работе с XML-документами следует учитывать замечания к методу setAttribute.

Метод setAttributeNode

Синтаксис: элемент.setAttributeNode(newAttr)
Аргументы: newAttr - выражение типа Attr
Результат: объект типа Attr или null
Исключения: WRONG_DOCUMENT_ERR, NO_MODIFICATION_ALLOWED_ERR, INUSE_ATTRIBUTE_ERR

Поддержка : Только для XML-документов.
Соответствует стандарту.

Метод setAttributeNode добавляет к данному элементу новый узел newAttr. Если атрибут с именем newAttr.nodeName уже есть, то он заменяется на новый узел, а указатель на старый узел возвращается в качестве результата. Если такого атрибута нет, то возвращается null. Пример:

var attr = document.createAttribute("temp");
attr.value = "temporary";
document.body.setAttributeNode(attr);
alert(document.body.getAttribute("temp"));

Оператор alert в Gecko выведет на экран строку temporary.

Метод setAttributeNodeNS

Синтаксис: элемент.setAttributeNodeNS(newAttr)
Аргументы: newAttr - выражение типа Attr
Результат: объект типа Attr или null
Исключения: WRONG_DOCUMENT_ERR, NO_MODIFICATION_ALLOWED_ERR, INUSE_ATTRIBUTE_ERR

Поддержка : Не поддерживается.
Не поддерживается.

Метод setAttributeNodeNS добавляет к данному элементу новый узел newAttr. Если атрибут с такими же newAttr.localName и newAttr.namespaceURI уже есть, то он заменяется на новый узел, а указатель на старый узел возвращается в качестве результата. Если такого атрибута нет, то возвращается null. Этот метод предназначен для XML-документов и для HTML-документов может не поддерживаться.

<<<  Назад Вперед  >>>
1  2  3  4

8  Комментарии к статье  8 8  Обсудить в чате