em
Função getElementsByClassName – Versão 2008

Função getElementsByClassName – Versão 2008

Robert Nyman, no ano de 2005, publicou em seu blog um artigo entitulado “The Ultimate getElementsByClassName“, uma função desenvolvida em JavaScript, que sem a utilização de qualquer Framework nos pernite obter todos os elementos de uma classe passados por parâmetro.

The Ultimate getElementsByClassName – Versão 2005

function getElementsByClassName(oElm, strTagName, strClassName){
    var arrElements = (strTagName == "*" && oElm.all)? oElm.all : oElm.getElementsByTagName(strTagName);
    var arrReturnElements = new Array();
    strClassName = strClassName.replace(/\-/g, "\\-");
    var oRegExp = new RegExp("(^|\\s)" + strClassName + "(\\s|$)");
    var oElement;
    for(var i=0; i < arrElements.length; i++){
        oElement = arrElements[i];
        if(oRegExp.test(oElement.className)){
            arrReturnElements.push(oElement);
        }
    }
    return (arrReturnElements)
}

Mas agora, Robert Nyman a melhorou adicionando novas funções.

The Ultimate getElementsByClassName – Versão 2008

/*
	Developed by Robert Nyman, http://www.robertnyman.com
	Code/licensing: http://code.google.com/p/getelementsbyclassname/
*/
var getElementsByClassName = function (className, tag, elm){
	if (document.getElementsByClassName) {
		getElementsByClassName = function (className, tag, elm) {
			elm = elm || document;
			var elements = elm.getElementsByClassName(className),
				nodeName = (tag)? new RegExp("\\b" + tag + "\\b", "i") : null,
				returnElements = [],
				current;
			for(var i=0, il=elements.length; i < il; i+=1){
				current = elements[i];
				if(!nodeName || nodeName.test(current.nodeName)) {
					returnElements.push(current);
				}
			}
			return returnElements;
		};
	}
	else if (document.evaluate) {
		getElementsByClassName = function (className, tag, elm) {
			tag = tag || "*";
			elm = elm || document;
			var classes = className.split(" "),
				classesToCheck = "",
				xhtmlNamespace = "http://www.w3.org/1999/xhtml",
				namespaceResolver = (document.documentElement.namespaceURI === xhtmlNamespace)? xhtmlNamespace : null,
				returnElements = [],
				elements,
				node;
			for(var j=0, jl=classes.length; j < jl; j+=1){
				classesToCheck += "[contains(concat(‘ ‘, @class, ‘ ‘), ‘ " + classes[j] + " ‘)]";
			}
			try	{
				elements = document.evaluate(".//" + tag + classesToCheck, elm, namespaceResolver, 0, null);
			}
			catch (e) {
				elements = document.evaluate(".//" + tag + classesToCheck, elm, null, 0, null);
			}
			while ((node = elements.iterateNext())) {
				returnElements.push(node);
			}
			return returnElements;
		};
	}
	else {
		getElementsByClassName = function (className, tag, elm) {
			tag = tag || "*";
			elm = elm || document;
			var classes = className.split(" "),
				classesToCheck = [],
				elements = (tag === "*" && elm.all)? elm.all : elm.getElementsByTagName(tag),
				current,
				returnElements = [],
				match;
			for(var k=0, kl=classes.length; k < kl; k+=1){
				classesToCheck.push(new RegExp("(^|\\s)" + classes[k] + "(\\s|$)"));
			}
			for(var l=0, ll=elements.length; l < ll; l+=1){
				current = elements[l];
				match = false;
				for(var m=0, ml=classesToCheck.length; m < ml; m+=1){
					match = classesToCheck[m].test(current.className);
					if (!match) {
						break;
					}
				}
				if (match) {
					returnElements.push(current);
				}
			}
			return returnElements;
		};
	}
	return getElementsByClassName(className, tag, elm);
};

Novas funcionalidades:

  • Utiliza getElementsByClassName nativo se está disponível.
  • Utiliza XPath nativo se está disponível.
  • Suporta múltiplos class em uma mesma chamada.
  • Devolve um array com o qual pode trabalhar.

Como utilizar:

A função pode receber 3 parâmetros:

  • class: A classe que está buscando – Obrigatório.
  • tag: A tag que contém a classe – Opcional.
  • tag: Elemento pai por onde quer começar a buscar – Opcional.
getElementsByClassName(class, tag, elm);
// Exemplos
getElementsByClassName("roxo"); // Todos os elementos com o class="roxo"
getElementsByClassName("roxo azul grande"); //Todos los elements com o class="roxo", class="azul",…
getElementsByClassName("roxo", "p"); //Todos os P’s com o class="rojo"
getElementsByClassName("roxo", "p", document.getElementById("content")); // Todos os P’s com o class="roxo" no elemento content e filhos.

Comentários

  1. Firefox 3 Implementa document.getElementsByClassName de forma nativa :D

    http://developer.mozilla.org/en/DOM/document.getElementsByClassName

    por Bruno Tavares Responder

Deixe uma resposta

O seu endereço de email não será publicado Campos obrigatórios são marcados *

Você pode usar estas tags e atributos de HTML: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>