[patch][cla] dojo.removeClass w/o class name should remove all classes

[Les]

It should be easy to remove all class names from an element, e.g.:

This code removes the 'someClass' class.

dojo.removeClass("someNode", "someClass");

This code should remove all classes from someNode.

dojo.removeClass("someNode");

I think this would be an improvement for chaining.

[Les]

Example (remove all classes, add class 'myClass'):

dojo.query('a').removeClass().addClass('myClass');

[dante]

how i'd do it.

[dante]

i can't decide if I think this confuses me or is good functionality. It does fill a gap transparently with removeClass, but really

dojo.clearClass = function(node){ dojo.byId(node).className = ""; }

is "less confusing" and can be put in NodeList? too. Hiding in removeClass is less bytes, but adds extra check to code path.

patch is against [18844] in trunk.

[Eugene Lazutkin]

IMHO, it is confusing, and doesn't save much code.

It makes more sense in the context of NodeList. Probably should be an extension, rather than part of the base.

[Les]

removeClass() is available in jQuery. I thought it should be added to dojo, since the NodeList? methods are intended to match the API naming and behavior as the similarly named methods in jQuery.

[James Burke]

Seems fine to me, and as Les mentions we get better compatibility with jquery methods.

[Eugene Lazutkin]

Should be combined with #9577.

[Eugene Lazutkin]

(In [19075]) Adding array support to addClass/removeClass, adding support to remove all classes, adding unit tests and inline docs, thx Les!, !strict. refs #9577, refs #9560.

[Eugene Lazutkin]

(In [19076]) removing trailing spaces, !strict, refs #9560, refs #9577.

[Eugene Lazutkin]

Now I want to update the docs on Dojo Campus but I don't know what is the correct way to do it: this functionality is unreleased yet. Do we mark it somehow? Do we update some special area? How do we handle docs for different versions?

[bill]

Previously we were (in theory) marking new stuff with "New in 1.4" but I think at this point you can just document it.

[Eugene Lazutkin]

All information is added to the release nodes, and the documentation is updated.