QuickBoxes for Dojo

By  on  
Dojo Toolkit

Adding to my mental portfolio is important to me. First came MooTools, then jQuery, and now Dojo. I speak often with Peter Higgins of Dojo fame and decided it was time to step into his world. I chose a simple but useful plugin, QuickBoxes, to port over from MooTools. The following is the result.

The Dojo JavaScript

//safety closure
;(function(d, $){
	//plugin begins
    d.QuickBoxes = function(args, node){
		//scoping
		node = d.byId(node);
		//settings
		var active = 0;
		args.elements = $(args.elements);
		//for every checkbox
		args.elements.forEach(function(el) {
			//connect the MouseDown event
			d.connect(el,'onmousedown',function(ev){
				d.stopEvent(ev);
				active = 1;
				el.checked = !el.checked;
			});
			//connect the MouseEnter event
			d.connect(el,'onmouseenter',function(e){
				if(active == 1) {
					el.checked = ('toggle' == args.mode ? !el.checked : 'check' == args.mode);
				}
			});
			//connect the Click event
			d.connect(el,'onclick',function(e){
				el.checked = !el.checked;
				active = 0;
			});
			//fix the labels
			var label = $('label[for=' + el.getAttribute('id') + ']');
			if(label.length) {
				d.connect(label[0],'onclick',function(e){
					el.checked = !el.checked;
				});
			}
		});
		//add the mouseup event to the Window
		d.connect(d.body(),'mouseup',function(){ active = 0; });
	};	
	//usage
	d.addOnLoad(function(){
		var togglers = new d.QuickBoxes({ elements: '.toggle', mode: 'toggle' });
		var checked = new d.QuickBoxes({ elements: '.checked', mode: 'check' });
		var unchecked = new d.QuickBoxes({ elements: '.unchecked', mode: 'uncheck' });
	});
})(dojo, dojo.query);

If you take a look at the Dojo version and the MooTools version, they're very much the same. Like I've preached with Moo and jQuery, the frameworks all do the same thing but with a different syntax.

A special thanks to Peter Higgins for his help -- in all honestly, I was pretty lost at a few points of this simple plugin. It was good to dabble in Dojo and I look forward to more experimentation.

Recent Features

  • By
    Vibration API

    Many of the new APIs provided to us by browser vendors are more targeted toward the mobile user than the desktop user.  One of those simple APIs the Vibration API.  The Vibration API allows developers to direct the device, using JavaScript, to vibrate in...

  • By
    Write Better JavaScript with Promises

    You've probably heard the talk around the water cooler about how promises are the future. All of the cool kids are using them, but you don't see what makes them so special. Can't you just use a callback? What's the big deal? In this article, we'll...

Incredible Demos

  • By
    Xbox Live Gamer API

    My sharpshooter status aside, I've always been surprised upset that Microsoft has never provided an API for the vast amount of information about users, the games they play, and statistics within the games. Namely, I'd like to publicly shame every n00b I've baptized with my...

  • By
    Custom Scrollbars in WebKit

    Before each of the browser vendors we like was providing unique CSS controls, Internet Explorer was setting the tone.  One such example is IE's early implementation of CSS filters. Internet Explorer was also the first browser that allowed developers to, for better or worse, customize...

Discussion

  1. Why are you using dojo instead of the d argument passed to the “safety closure” function?

    In the same way, dojo.query is not used inside the function? Plugin convention?

  2. Darkimmortal

    Can’t see this being useful – the concept is completely unintuitive.

  3. Why you do not use dojo widget system, its more powerfull?

  4. This would be better if you triggered the event when the mouse crosses the tag.

  5. @Pierre: I built that off of a plugin template — good point.

    @Darkimmortal: Fair enough.

    @Ignar: I wanted to use “pure” Dojo code for this first one.

    @Matt: Do you mean LABEL?

  6. darn HTML filter.

  7. Nice and useful – works similarly to my Dojo powered GreaseMonkey script called EasyCheckboxes – http://userscripts.org/scripts/show/48011

  8. I agree it should be using ‘d’ in all places. In this case can also drop the || create(“div”) part for this progressive case. $ is used twice in the above, so the closure is fine otherwise.

    I agree it should react to dragging over the label. dojo.setSelectable can help there, should be pretty easy.

    @ignar – dijit is probably “too much” for such a simple action (though would benefit from some of the framework design patterns, this is just a simple “plugin” using only Base Dojo, so the overhead is minimal)

    Regards

  9. I’ve updated the script by changing references to “dojo” to “d”.

  10. Hmmmm…I should really rewrite this.

  11. Hi… i need… if is possible… dont show the “mondays” days.
    I will make a form with all days of year, with a checkbox and send to database. And the days in database will be checkbox disabled.
    I need check if the date is (are) in database and i dont understanded with that code
    /** QUERY THE DATABASE FOR AN ENTRY FOR THIS DAY !! IF MATCHES FOUND, PRINT THEM !! **/

    Thank you for all… is a amazing script

Wrap your code in <pre class="{language}"></pre> tags, link to a GitHub gist, JSFiddle fiddle, or CodePen pen to embed!