Widget.js

define([
	'dojo/_base/declare',
	'dijit/registry',
	'dijit/_WidgetBase',
	'dijit/_TemplatedMixin',
	'dx-alias/dom',
	'dx-alias/string',
	'dx-alias/on'
],function(declare, registry, _WidgetBase, _TemplatedMixin, dom, string, on){
	//	summary:
	//		Widget is not very complicated, it's a shortcut for the most common
	//		Dijit creation modules, _WidgetBase, and _TemplatedMixin.
	//		Widget also mixes in some useful methods, like show and hide.
	//
	return declare('dx-alias.Widget', [_WidgetBase, _TemplatedMixin], {
		templateString:'<div></div>', //to be overwritten

		showing: true,

		show: function(){
			if(this.showing) return;
			this.showing = true;
			dom.show(this.domNode);
		},

		hide: function(){
			if(!this.showing) return;
			this.showing = false;
			dom.hide(this.domNode);
		},

		getName: function(){
			return string.last(this.declaredClass, '.');
		},

		getParent: function(){
			// summary:
			//		Returns the parent widget of this widget
			//console.log('getParent', this.domNode)
			if(!this.domNode.parentNode){
				console.warn('NO PARENT', this)
				return null;
			}
			return this._parent || registry.getEnclosingWidget(this.domNode.parentNode) || registry.getEnclosingWidget(this.domNode.parentNode.parentNode);
		},

		addChildren: function(widgets, node){
			//console.log('addChildren', widgets)
			widgets.forEach(function(w){
				//console.log('addChild', w);
				this.addChild(w, node);
			}, this)
		},

		addChild: function(widget, node){
			//console.log('addChild')
			widget._parent = this;
			node = node || this.containerNode || this.domNode;
			node.appendChild(widget.domNode);
			if(this._started && !widget._started) widget.startup();
			return widget;
		},

		removeChild: function(widget){
			if(widget){
				var node = widget.domNode;
				if(node && node.parentNode){
					node.parentNode.removeChild(node); // detach but don't destroy
				}
			}
			return widget;
		},

		connectEvents: function(){
			this._connections.forEach(function(handle){ handle.resume(); }, this);
		},

		disconnectEvents: function(){
			this._connections.forEach(function(handle){ handle.pause(); }, this);
		},

		getObject: function(obj){
			return typeof obj == 'string' ? typeof this[obj] == 'object' ? this[obj] : registry.byId(obj) : obj;
		},

		on: function(obj, event, ctx, method){
			this._connections = this._connections || [];
			var h = on(obj, event, ctx, method);
			this._connections.push(h);
			return h;
		},

		sub: function(/*String*/channel, /*Object|Function*/ctx, /*String|Function*/method, /*String?*/group){
			this._connections = this._connections || [];
			var h = on.sub(channel, ctx, method, group);
			this._connections.push(h);
			return h;
		},

		// add sub() ?

		destroy: function(){
			if(this._connections){
				this._connections.forEach(function(h){
					h.remove();
				});
			}
			this.inherited(arguments);
		}

	});
});