# HTML DOM getElementsByClassName() Method

Document Object

## Example

Get all elements with the specified class name:

var x = document.getElementsByClassName("example");
Try it yourself »

More "Try it Yourself" examples below.

## Definition and Usage

The getElementsByClassName() method returns a collection of all elements in the document with the specified class name, as a NodeList object.

The NodeList object represents a collection of nodes. The nodes can be accessed by index numbers. The index starts at 0.

Tip: You can use the length property of the NodeList object to determine the number of elements with a specified class name, then you can loop through all elements and extract the info you want.

## Browser Support

The numbers in the table specifies the first browser version that fully supports the method.

Method |  |  |  |  |
--- | --- | --- | --- | --- | ---
getElementsByClassName() | 4.0 | 9.0 | 3.0 | 3.1 | 9.5

## Syntax

document.getElementsByClassName(classname)

## Parameter Values

Parameter | Type | Description
--- | --- | ---
classname | String | Required. The class name of the elements you want to get. To search for multiple class names, separate them with spaces, like "test demo".

## Technical Details

DOM Version: | Core Level 1 Document Object
Return Value: | A NodeList object, representing a collection of elements with the specified class name. The elements in the returned collection are sorted as they appear in the source code.

## More Examples

## Example

Get all elements with both the "example" and "color" classes:

var x = document.getElementsByClassName("example color");
Try it yourself »

## Example

Find out how many elements with class="example" there are in the document (using the length property of the NodeList object):

var x = document.getElementsByClassName("example").length;
Try it yourself »

## Example

Change the background color of all elements with class="example":

var x = document.getElementsByClassName("example");
var i;
for (i = 0; i < x.length; i++) {
x[i].style.backgroundColor = "red";
}
Try it yourself »

## Related Pages

CSS Tutorial: CSS Selectors

CSS Reference: CSS .class Selector

HTML DOM Reference: element.getElementsByClassName()

HTML DOM Reference: className Property

HTML DOM Reference: HTML DOM classList Property

HTML DOM Reference: HTML DOM Style Object

Document Object

### WEB HOSTING

UK Reseller Hosting

### WEB BUILDING

FREE Website BUILDER Free HTML5 Templates

### W3SCHOOLS EXAMS

HTML, CSS, JavaScript, PHP, jQuery, XML, and ASP Certifications

### SHARE THIS PAGE

### Color Picker

### HTML/CSS

HTML Tutorial HTML5 Tutorial CSS Tutorial CSS3 Tutorial Bootstrap Tutorial

### JavaScript

JavaScript Tutorial jQuery Tutorial jQuery Mobile Tutorial AngularJS Tutorial AJAX Tutorial JSON Tutorial

### Graphics

Canvas Tutorial SVG Tutorial Google Maps Tutorial

### Server Side

SQL Tutorial PHP Tutorial ASP Tutorial ASP.NET Tutorial VBScript Tutorial AppML Tutorial

### Web

Web Building Web Statistics Web Certification

### XML

XML Tutorial DTD Tutorial Schema Tutorial XML DOM Tutorial XPath Tutorial XSLT Tutorial XQuery Tutorial XSL-FO Tutorial RSS Tutorial WSDL Tutorial

### HTML/CSS

HTML Tag Reference HTML Event Reference HTML Color Reference CSS 1,2,3 Reference Bootstrap Reference

### JavaScript

JavaScript Reference HTML DOM Reference jQuery Reference jQuery Mobile Reference Google Maps Reference

### Server Side

PHP Reference SQL Reference ASP Reference VBScript Reference Razor Reference ASP.NET Reference

### XML

XML DOM Reference XSLT Reference XSL-FO Reference XPath Reference XQuery Reference Schema Reference RSS Reference SVG Reference

### HTML Charsets

HTML Character Sets HTML ASCII HTML ANSI HTML Windows-1252 HTML ISO-8859-1 HTML Symbols HTML UTF-8

### HTML/CSS

HTML Examples CSS Examples

### Browser Scripting

JavaScript Examples HTML DOM Examples jQuery Examples jQuery Mobile Examples AngularJS Examples AJAX Examples

### Server Scripting

PHP Examples ASP Examples VBScript Examples Razor Examples .NET Examples

### XML Languages

XML Examples DTD Examples XML DOM Examples XSL Examples XSLT Examples XPath Examples XQuery Examples Schema Examples RSS Examples SVG Examples