320 lines
9.1 KiB
JavaScript
320 lines
9.1 KiB
JavaScript
define("dojo/dom-class", ["./_base/lang", "./_base/array", "./dom"], function(lang, array, dom){
|
|
// module:
|
|
// dojo/dom-class
|
|
// summary:
|
|
// This module defines the core dojo DOM class API.
|
|
|
|
var className = "className";
|
|
|
|
/* Part I of classList-based implementation is preserved here for posterity
|
|
var classList = "classList";
|
|
has.add("dom-classList", function(){
|
|
return classList in document.createElement("p");
|
|
});
|
|
*/
|
|
|
|
// =============================
|
|
// (CSS) Class Functions
|
|
// =============================
|
|
|
|
/*=====
|
|
dojo.hasClass = function(node, classStr){
|
|
// summary:
|
|
// Returns whether or not the specified classes are a portion of the
|
|
// class list currently applied to the node.
|
|
//
|
|
// node: String|DOMNode
|
|
// String ID or DomNode reference to check the class for.
|
|
//
|
|
// classStr: String
|
|
// A string class name to look for.
|
|
//
|
|
// returns: Boolean
|
|
//
|
|
// example:
|
|
// Do something if a node with id="someNode" has class="aSillyClassName" present
|
|
// | if(dojo.hasClass("someNode","aSillyClassName")){ ... }
|
|
};
|
|
=====*/
|
|
|
|
/*=====
|
|
dojo.addClass = function(node, classStr){
|
|
// summary:
|
|
// Adds the specified classes to the end of the class list on the
|
|
// passed node. Will not re-apply duplicate classes.
|
|
//
|
|
// node: String|DOMNode
|
|
// String ID or DomNode reference to add a class string too
|
|
//
|
|
// classStr: String|Array
|
|
// A String class name to add, or several space-separated class names,
|
|
// or an array of class names.
|
|
//
|
|
// example:
|
|
// Add a class to some node:
|
|
// | dojo.addClass("someNode", "anewClass");
|
|
//
|
|
// example:
|
|
// Add two classes at once:
|
|
// | dojo.addClass("someNode", "firstClass secondClass");
|
|
//
|
|
// example:
|
|
// Add two classes at once (using array):
|
|
// | dojo.addClass("someNode", ["firstClass", "secondClass"]);
|
|
//
|
|
// example:
|
|
// Available in `dojo.NodeList` for multiple additions
|
|
// | dojo.query("ul > li").addClass("firstLevel");
|
|
};
|
|
=====*/
|
|
|
|
/*=====
|
|
dojo.removeClass = function(node, classStr){
|
|
// summary:
|
|
// Removes the specified classes from node. No `dojo.hasClass`
|
|
// check is required.
|
|
//
|
|
// node: String|DOMNode
|
|
// String ID or DomNode reference to remove the class from.
|
|
//
|
|
// classStr: String|Array
|
|
// An optional String class name to remove, or several space-separated
|
|
// class names, or an array of class names. If omitted, all class names
|
|
// will be deleted.
|
|
//
|
|
// example:
|
|
// Remove a class from some node:
|
|
// | dojo.removeClass("someNode", "firstClass");
|
|
//
|
|
// example:
|
|
// Remove two classes from some node:
|
|
// | dojo.removeClass("someNode", "firstClass secondClass");
|
|
//
|
|
// example:
|
|
// Remove two classes from some node (using array):
|
|
// | dojo.removeClass("someNode", ["firstClass", "secondClass"]);
|
|
//
|
|
// example:
|
|
// Remove all classes from some node:
|
|
// | dojo.removeClass("someNode");
|
|
//
|
|
// example:
|
|
// Available in `dojo.NodeList()` for multiple removal
|
|
// | dojo.query(".foo").removeClass("foo");
|
|
};
|
|
=====*/
|
|
|
|
/*=====
|
|
dojo.replaceClass = function(node, addClassStr, removeClassStr){
|
|
// summary:
|
|
// Replaces one or more classes on a node if not present.
|
|
// Operates more quickly than calling dojo.removeClass and dojo.addClass
|
|
//
|
|
// node: String|DOMNode
|
|
// String ID or DomNode reference to remove the class from.
|
|
//
|
|
// addClassStr: String|Array
|
|
// A String class name to add, or several space-separated class names,
|
|
// or an array of class names.
|
|
//
|
|
// removeClassStr: String|Array?
|
|
// A String class name to remove, or several space-separated class names,
|
|
// or an array of class names.
|
|
//
|
|
// example:
|
|
// | dojo.replaceClass("someNode", "add1 add2", "remove1 remove2");
|
|
//
|
|
// example:
|
|
// Replace all classes with addMe
|
|
// | dojo.replaceClass("someNode", "addMe");
|
|
//
|
|
// example:
|
|
// Available in `dojo.NodeList()` for multiple toggles
|
|
// | dojo.query(".findMe").replaceClass("addMe", "removeMe");
|
|
};
|
|
=====*/
|
|
|
|
/*=====
|
|
dojo.toggleClass = function(node, classStr, condition){
|
|
// summary:
|
|
// Adds a class to node if not present, or removes if present.
|
|
// Pass a boolean condition if you want to explicitly add or remove.
|
|
// Returns the condition that was specified directly or indirectly.
|
|
//
|
|
// node: String|DOMNode
|
|
// String ID or DomNode reference to toggle a class string
|
|
//
|
|
// classStr: String|Array
|
|
// A String class name to toggle, or several space-separated class names,
|
|
// or an array of class names.
|
|
//
|
|
// condition:
|
|
// If passed, true means to add the class, false means to remove.
|
|
// Otherwise dojo.hasClass(node, classStr) is used to detect the class presence.
|
|
//
|
|
// example:
|
|
// | dojo.toggleClass("someNode", "hovered");
|
|
//
|
|
// example:
|
|
// Forcefully add a class
|
|
// | dojo.toggleClass("someNode", "hovered", true);
|
|
//
|
|
// example:
|
|
// Available in `dojo.NodeList()` for multiple toggles
|
|
// | dojo.query(".toggleMe").toggleClass("toggleMe");
|
|
};
|
|
=====*/
|
|
|
|
var cls, // exports object
|
|
spaces = /\s+/, a1 = [""];
|
|
|
|
function str2array(s){
|
|
if(typeof s == "string" || s instanceof String){
|
|
if(s && !spaces.test(s)){
|
|
a1[0] = s;
|
|
return a1;
|
|
}
|
|
var a = s.split(spaces);
|
|
if(a.length && !a[0]){
|
|
a.shift();
|
|
}
|
|
if(a.length && !a[a.length - 1]){
|
|
a.pop();
|
|
}
|
|
return a;
|
|
}
|
|
// assumed to be an array
|
|
if(!s){
|
|
return [];
|
|
}
|
|
return array.filter(s, function(x){ return x; });
|
|
}
|
|
|
|
/* Part II of classList-based implementation is preserved here for posterity
|
|
if(has("dom-classList")){
|
|
// new classList version
|
|
cls = {
|
|
contains: function containsClass(node, classStr){
|
|
var clslst = classStr && dom.byId(node)[classList];
|
|
return clslst && clslst.contains(classStr); // Boolean
|
|
},
|
|
|
|
add: function addClass(node, classStr){
|
|
node = dom.byId(node);
|
|
classStr = str2array(classStr);
|
|
for(var i = 0, len = classStr.length; i < len; ++i){
|
|
node[classList].add(classStr[i]);
|
|
}
|
|
},
|
|
|
|
remove: function removeClass(node, classStr){
|
|
node = dom.byId(node);
|
|
if(classStr === undefined){
|
|
node[className] = "";
|
|
}else{
|
|
classStr = str2array(classStr);
|
|
for(var i = 0, len = classStr.length; i < len; ++i){
|
|
node[classList].remove(classStr[i]);
|
|
}
|
|
}
|
|
},
|
|
|
|
replace: function replaceClass(node, addClassStr, removeClassStr){
|
|
node = dom.byId(node);
|
|
if(removeClassStr === undefined){
|
|
node[className] = "";
|
|
}else{
|
|
removeClassStr = str2array(removeClassStr);
|
|
for(var i = 0, len = removeClassStr.length; i < len; ++i){
|
|
node[classList].remove(removeClassStr[i]);
|
|
}
|
|
}
|
|
addClassStr = str2array(addClassStr);
|
|
for(i = 0, len = addClassStr.length; i < len; ++i){
|
|
node[classList].add(addClassStr[i]);
|
|
}
|
|
},
|
|
|
|
toggle: function toggleClass(node, classStr, condition){
|
|
node = dom.byId(node);
|
|
if(condition === undefined){
|
|
classStr = str2array(classStr);
|
|
for(var i = 0, len = classStr.length; i < len; ++i){
|
|
node[classList].toggle(classStr[i]);
|
|
}
|
|
}else{
|
|
cls[condition ? "add" : "remove"](node, classStr);
|
|
}
|
|
return condition; // Boolean
|
|
}
|
|
}
|
|
}
|
|
*/
|
|
|
|
// regular DOM version
|
|
var fakeNode = {}; // for effective replacement
|
|
cls = {
|
|
contains: function containsClass(/*DomNode|String*/node, /*String*/classStr){
|
|
return ((" " + dom.byId(node)[className] + " ").indexOf(" " + classStr + " ") >= 0); // Boolean
|
|
},
|
|
|
|
add: function addClass(/*DomNode|String*/node, /*String|Array*/classStr){
|
|
node = dom.byId(node);
|
|
classStr = str2array(classStr);
|
|
var cls = node[className], oldLen;
|
|
cls = cls ? " " + cls + " " : " ";
|
|
oldLen = cls.length;
|
|
for(var i = 0, len = classStr.length, c; i < len; ++i){
|
|
c = classStr[i];
|
|
if(c && cls.indexOf(" " + c + " ") < 0){
|
|
cls += c + " ";
|
|
}
|
|
}
|
|
if(oldLen < cls.length){
|
|
node[className] = cls.substr(1, cls.length - 2);
|
|
}
|
|
},
|
|
|
|
remove: function removeClass(/*DomNode|String*/node, /*String|Array?*/classStr){
|
|
node = dom.byId(node);
|
|
var cls;
|
|
if(classStr !== undefined){
|
|
classStr = str2array(classStr);
|
|
cls = " " + node[className] + " ";
|
|
for(var i = 0, len = classStr.length; i < len; ++i){
|
|
cls = cls.replace(" " + classStr[i] + " ", " ");
|
|
}
|
|
cls = lang.trim(cls);
|
|
}else{
|
|
cls = "";
|
|
}
|
|
if(node[className] != cls){ node[className] = cls; }
|
|
},
|
|
|
|
replace: function replaceClass(/*DomNode|String*/node, /*String|Array*/addClassStr, /*String|Array?*/removeClassStr){
|
|
node = dom.byId(node);
|
|
fakeNode[className] = node[className];
|
|
cls.remove(fakeNode, removeClassStr);
|
|
cls.add(fakeNode, addClassStr);
|
|
if(node[className] !== fakeNode[className]){
|
|
node[className] = fakeNode[className];
|
|
}
|
|
},
|
|
|
|
toggle: function toggleClass(/*DomNode|String*/node, /*String|Array*/classStr, /*Boolean?*/condition){
|
|
node = dom.byId(node);
|
|
if(condition === undefined){
|
|
classStr = str2array(classStr);
|
|
for(var i = 0, len = classStr.length, c; i < len; ++i){
|
|
c = classStr[i];
|
|
cls[cls.contains(node, c) ? "remove" : "add"](node, c);
|
|
}
|
|
}else{
|
|
cls[condition ? "add" : "remove"](node, classStr);
|
|
}
|
|
return condition; // Boolean
|
|
}
|
|
};
|
|
|
|
return cls;
|
|
});
|