Rev 1422 | Blame | Compare with Previous | Last modification | View Log | RSS feed
/*Copyright (c) 2004-2006, The Dojo FoundationAll Rights Reserved.Licensed under the Academic Free License version 2.1 or above OR themodified BSD license. For more information on Dojo licensing, see:http://dojotoolkit.org/community/licensing.shtml*/dojo.provide("dojo.widget.Widget");dojo.require("dojo.lang.func");dojo.require("dojo.lang.array");dojo.require("dojo.lang.extras");dojo.require("dojo.lang.declare");dojo.require("dojo.ns");dojo.require("dojo.widget.Manager");dojo.require("dojo.event.*");dojo.require("dojo.a11y");dojo.declare("dojo.widget.Widget", null, function () {this.children = [];this.extraArgs = {};}, {parent:null, isTopLevel:false, disabled:false, isContainer:false, widgetId:"", widgetType:"Widget", ns:"dojo", getNamespacedType:function () {return (this.ns ? this.ns + ":" + this.widgetType : this.widgetType).toLowerCase();}, toString:function () {return "[Widget " + this.getNamespacedType() + ", " + (this.widgetId || "NO ID") + "]";}, repr:function () {return this.toString();}, enable:function () {this.disabled = false;}, disable:function () {this.disabled = true;}, onResized:function () {this.notifyChildrenOfResize();}, notifyChildrenOfResize:function () {for (var i = 0; i < this.children.length; i++) {var child = this.children[i];if (child.onResized) {child.onResized();}}}, create:function (args, fragment, parent, ns) {if (ns) {this.ns = ns;}this.satisfyPropertySets(args, fragment, parent);this.mixInProperties(args, fragment, parent);this.postMixInProperties(args, fragment, parent);dojo.widget.manager.add(this);this.buildRendering(args, fragment, parent);this.initialize(args, fragment, parent);this.postInitialize(args, fragment, parent);this.postCreate(args, fragment, parent);return this;}, destroy:function (finalize) {if (this.parent) {this.parent.removeChild(this);}this.destroyChildren();this.uninitialize();this.destroyRendering(finalize);dojo.widget.manager.removeById(this.widgetId);}, destroyChildren:function () {var widget;var i = 0;while (this.children.length > i) {widget = this.children[i];if (widget instanceof dojo.widget.Widget) {this.removeChild(widget);widget.destroy();continue;}i++;}}, getChildrenOfType:function (type, recurse) {var ret = [];var isFunc = dojo.lang.isFunction(type);if (!isFunc) {type = type.toLowerCase();}for (var x = 0; x < this.children.length; x++) {if (isFunc) {if (this.children[x] instanceof type) {ret.push(this.children[x]);}} else {if (this.children[x].widgetType.toLowerCase() == type) {ret.push(this.children[x]);}}if (recurse) {ret = ret.concat(this.children[x].getChildrenOfType(type, recurse));}}return ret;}, getDescendants:function () {var result = [];var stack = [this];var elem;while ((elem = stack.pop())) {result.push(elem);if (elem.children) {dojo.lang.forEach(elem.children, function (elem) {stack.push(elem);});}}return result;}, isFirstChild:function () {return this === this.parent.children[0];}, isLastChild:function () {return this === this.parent.children[this.parent.children.length - 1];}, satisfyPropertySets:function (args) {return args;}, mixInProperties:function (args, frag) {if ((args["fastMixIn"]) || (frag["fastMixIn"])) {for (var x in args) {this[x] = args[x];}return;}var undef;var lcArgs = dojo.widget.lcArgsCache[this.widgetType];if (lcArgs == null) {lcArgs = {};for (var y in this) {lcArgs[((new String(y)).toLowerCase())] = y;}dojo.widget.lcArgsCache[this.widgetType] = lcArgs;}var visited = {};for (var x in args) {if (!this[x]) {var y = lcArgs[(new String(x)).toLowerCase()];if (y) {args[y] = args[x];x = y;}}if (visited[x]) {continue;}visited[x] = true;if ((typeof this[x]) != (typeof undef)) {if (typeof args[x] != "string") {this[x] = args[x];} else {if (dojo.lang.isString(this[x])) {this[x] = args[x];} else {if (dojo.lang.isNumber(this[x])) {this[x] = new Number(args[x]);} else {if (dojo.lang.isBoolean(this[x])) {this[x] = (args[x].toLowerCase() == "false") ? false : true;} else {if (dojo.lang.isFunction(this[x])) {if (args[x].search(/[^\w\.]+/i) == -1) {this[x] = dojo.evalObjPath(args[x], false);} else {var tn = dojo.lang.nameAnonFunc(new Function(args[x]), this);dojo.event.kwConnect({srcObj:this, srcFunc:x, adviceObj:this, adviceFunc:tn});}} else {if (dojo.lang.isArray(this[x])) {this[x] = args[x].split(";");} else {if (this[x] instanceof Date) {this[x] = new Date(Number(args[x]));} else {if (typeof this[x] == "object") {if (this[x] instanceof dojo.uri.Uri) {this[x] = dojo.uri.dojoUri(args[x]);} else {var pairs = args[x].split(";");for (var y = 0; y < pairs.length; y++) {var si = pairs[y].indexOf(":");if ((si != -1) && (pairs[y].length > si)) {this[x][pairs[y].substr(0, si).replace(/^\s+|\s+$/g, "")] = pairs[y].substr(si + 1);}}}} else {this[x] = args[x];}}}}}}}}} else {this.extraArgs[x.toLowerCase()] = args[x];}}}, postMixInProperties:function (args, frag, parent) {}, initialize:function (args, frag, parent) {return false;}, postInitialize:function (args, frag, parent) {return false;}, postCreate:function (args, frag, parent) {return false;}, uninitialize:function () {return false;}, buildRendering:function (args, frag, parent) {dojo.unimplemented("dojo.widget.Widget.buildRendering, on " + this.toString() + ", ");return false;}, destroyRendering:function () {dojo.unimplemented("dojo.widget.Widget.destroyRendering");return false;}, addedTo:function (parent) {}, addChild:function (child) {dojo.unimplemented("dojo.widget.Widget.addChild");return false;}, removeChild:function (widget) {for (var x = 0; x < this.children.length; x++) {if (this.children[x] === widget) {this.children.splice(x, 1);widget.parent = null;break;}}return widget;}, getPreviousSibling:function () {var idx = this.getParentIndex();if (idx <= 0) {return null;}return this.parent.children[idx - 1];}, getSiblings:function () {return this.parent.children;}, getParentIndex:function () {return dojo.lang.indexOf(this.parent.children, this, true);}, getNextSibling:function () {var idx = this.getParentIndex();if (idx == this.parent.children.length - 1) {return null;}if (idx < 0) {return null;}return this.parent.children[idx + 1];}});dojo.widget.lcArgsCache = {};dojo.widget.tags = {};dojo.widget.tags.addParseTreeHandler = function (type) {dojo.deprecated("addParseTreeHandler", ". ParseTreeHandlers are now reserved for components. Any unfiltered DojoML tag without a ParseTreeHandler is assumed to be a widget", "0.5");};dojo.widget.tags["dojo:propertyset"] = function (fragment, widgetParser, parentComp) {var properties = widgetParser.parseProperties(fragment["dojo:propertyset"]);};dojo.widget.tags["dojo:connect"] = function (fragment, widgetParser, parentComp) {var properties = widgetParser.parseProperties(fragment["dojo:connect"]);};dojo.widget.buildWidgetFromParseTree = function (type, frag, parser, parentComp, insertionIndex, localProps) {dojo.a11y.setAccessibleMode();var stype = type.split(":");stype = (stype.length == 2) ? stype[1] : type;var localProperties = localProps || parser.parseProperties(frag[frag["ns"] + ":" + stype]);var twidget = dojo.widget.manager.getImplementation(stype, null, null, frag["ns"]);if (!twidget) {throw new Error("cannot find \"" + type + "\" widget");} else {if (!twidget.create) {throw new Error("\"" + type + "\" widget object has no \"create\" method and does not appear to implement *Widget");}}localProperties["dojoinsertionindex"] = insertionIndex;var ret = twidget.create(localProperties, frag, parentComp, frag["ns"]);return ret;};dojo.widget.defineWidget = function (widgetClass, renderer, superclasses, init, props) {if (dojo.lang.isString(arguments[3])) {dojo.widget._defineWidget(arguments[0], arguments[3], arguments[1], arguments[4], arguments[2]);} else {var args = [arguments[0]], p = 3;if (dojo.lang.isString(arguments[1])) {args.push(arguments[1], arguments[2]);} else {args.push("", arguments[1]);p = 2;}if (dojo.lang.isFunction(arguments[p])) {args.push(arguments[p], arguments[p + 1]);} else {args.push(null, arguments[p]);}dojo.widget._defineWidget.apply(this, args);}};dojo.widget.defineWidget.renderers = "html|svg|vml";dojo.widget._defineWidget = function (widgetClass, renderer, superclasses, init, props) {var module = widgetClass.split(".");var type = module.pop();var regx = "\\.(" + (renderer ? renderer + "|" : "") + dojo.widget.defineWidget.renderers + ")\\.";var r = widgetClass.search(new RegExp(regx));module = (r < 0 ? module.join(".") : widgetClass.substr(0, r));dojo.widget.manager.registerWidgetPackage(module);var pos = module.indexOf(".");var nsName = (pos > -1) ? module.substring(0, pos) : module;props = (props) || {};props.widgetType = type;if ((!init) && (props["classConstructor"])) {init = props.classConstructor;delete props.classConstructor;}dojo.declare(widgetClass, superclasses, init, props);};