We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

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

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

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

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,