Связь и интернет Архив Программирование
   
Сделать стартовойСделать закладку            
   ПОИСК  
   
Главная / 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
МетодМодельОписание
getAttributeDOM 1Возвращает значение заданного атрибута.
getAttributeNSDOM 2Возвращает значение заданного атрибута с учетом пространства имен.
getAttributeNodeDOM 1Возвращает заданный узел Attr.
getAttributeNodeNSDOM 2Возвращает заданный узел Attr с учетом пространства имен.
getElementsByTagNameDOM 1Возвращает список потомков, имеющих заданный тег.
getElementsByTagNameNSDOM 2Возвращает список потомков, имеющих заданный тег, с учетом пространства имен.
hasAttributeDOM 2Проверяет наличие заданного атрибута.
hasAttributeNSDOM 2Проверяет наличие заданного атрибута с учетом пространства имен.
removeAttributeDOM 1Удаляет заданный атрибут.
removeAttributeNSDOM 2Удаляет заданный атрибут с учетом пространства имен.
removeAttributeNodeDOM 1Удаляет заданный узел Attr.
setAttributeDOM 1Добавляет новый атрибут.
setAttributeNS DOM 2Добавляет новый атрибут с учетом пространства имен.
setAttributeNodeDOM 1Добавляет новый узел Attr.
setAttributeNodeNSDOM 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  Обсудить в чате

 
  
  
    Copyright ©  RIN 2003 - 2004      * Обратная связь