Element.getElementsByClassName()

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

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

Так же, как метод Document.getElementsByClassName() действует на весь документ; это вернет элементы, которые являются потомками корневого элемента, содержащие в себе указанные классы.

Syntax

var elements = element.getElementsByClassName(names);
  • elementsHTMLCollection содержащий найденные элементы
  • names — строка, содержащая в себе имена классов; имена разделяются пробелами
  • element — любой Element в документе (в котором осуществляется выборка)

Examples

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

element.getElementsByClassName('test');

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

element.getElementsByClassName('red test');

Получить все элементы с классом test, которые находятся в элементе с id main:

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

Мы так же можем использовать все методы из Array.prototype на любом  HTMLCollection путем передачи HTMLCollection в метод как значение this. Так мы найдем все <div> элементы, которые имеют класс test:

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

Specifications

Specification Status Comment
DOM
Определение 'Element.getElementsByClassName()' в этой спецификации.
Живой стандарт Initial definition

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Да) (Да) [1] 9 (Да) (Да) [2]
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support ? ? [1] ? ? ?

[1] Prior to Firefox 19, this method was returning a NodeList; it was then changed to reflects the change in the spec.

[2] Safari on iOS 8 and OS X 10.10 returns a NodeList.

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

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