Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

Document.getElementsByClassName()

Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.

Возвращает HTMLCollection дочерних элементов соответствующих указанному имени класса. В случае вызова на объекте 'document', поиск происходит по всему документу, включая корневой элемент. Вы так же можете вызывать getElementsByClassName()  на любом элементе, результатом работы будет массив дочерних элементов с подходящим именем класса, относительно указанного элемента.

 

Синтаксис

 

var elements = document.getElementsByClassName(names); // или:
var elements = rootElement.getElementsByClassName(names);
  • В "elements" будет текущая  HTMLCollection найденных елементов.
  • "names" строка - имя класса, который требуется найти; имена классов разделяют пробелом.
  • getElementsByClassName может быть вызвана для любого элемента, не только для "document". Документ, с которого осуществлен вызов, будет выступать в качестве корня (root) для поиска.

Примеры

Получить все элементы класса 'test'

document.getElementsByClassName('test');

Получить все элементы у которых есть класс 'red' и класс 'test'

document.getElementsByClassName('red test');

Получить все элементы с классом 'test', будущие дочерними для элемента с ID 'main'.

document.getElementById('main').getElementsByClassName('test');

Мы так же можем использовать методы из Array.prototype на любой HTMLCollection передавая коллекцию в качестве this'a метода. В примере найдем все элементы 'div', принадлежащие классу 'test':

var testElements = document.getElementsByClassName('test');
var testDivs = Array.prototype.filter.call(testElements, function(testElement){
    return testElement.nodeName === 'DIV';
});

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

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Да) 3.0 9.0 (Да) (Да)
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support ? ? ? ? ?

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

Метки документа и участники

 Внесли вклад в эту страницу: m.onyshchuk, goodwin64, loki2d, lazyexpert
 Обновлялась последний раз: m.onyshchuk,