From 8ca48ef6124ad3d0385c30a89494013bce8ac29c Mon Sep 17 00:00:00 2001 From: Bill Keese Date: Tue, 24 Jul 2012 14:28:38 +0000 Subject: [PATCH] Dijit: use MIDs rather than global variables in summaries and descriptions, so that the hyperlinks work. Refs #13101 !strict --- Calendar.js | 6 ++-- CalendarLite.js | 2 +- ColorPalette.js | 2 +- Dialog.js | 6 ++-- Editor.js | 6 ++-- ProgressBar.js | 2 +- TitlePane.js | 2 +- Tooltip.js | 51 +++++++++++++++------------- TooltipDialog.js | 10 +++--- Tree.js | 12 +++---- WidgetSet.js | 2 +- _DialogMixin.js | 4 +-- _HasDropDown.js | 6 ++-- _OnDijitClickMixin.js | 2 +- _TimePicker.js | 12 +++---- _Widget.js | 10 +++--- _WidgetBase.js | 12 +++---- _base/place.js | 8 ++--- _editor/RichText.js | 18 +++++----- _editor/_Plugin.js | 4 +-- _editor/plugins/AlwaysShowToolbar.js | 5 ++- _editor/plugins/FontChoice.js | 2 +- _editor/plugins/LinkDialog.js | 2 +- _editor/plugins/TabIndent.js | 2 +- _editor/range.js | 4 +-- _tree/dndSource.js | 2 +- a11yclick.js | 2 +- form/Button.js | 2 +- form/ComboBoxMixin.js | 12 +++---- form/ComboButton.js | 2 +- form/CurrencyTextBox.js | 4 +-- form/DataList.js | 2 +- form/DateTextBox.js | 2 +- form/DropDownButton.js | 2 +- form/FilteringSelect.js | 4 +-- form/HorizontalRule.js | 2 +- form/HorizontalRuleLabels.js | 2 +- form/MappedTextBox.js | 10 +++--- form/NumberSpinner.js | 4 +-- form/NumberTextBox.js | 6 ++-- form/RangeBoundTextBox.js | 6 ++-- form/SimpleTextarea.js | 4 +-- form/TimeTextBox.js | 4 +-- form/ValidationTextBox.js | 4 +-- form/VerticalRule.js | 2 +- form/VerticalRuleLabels.js | 2 +- form/_AutoCompleterMixin.js | 8 ++--- form/_ButtonMixin.js | 2 +- form/_CheckBoxMixin.js | 4 +-- form/_ComboBoxMenu.js | 2 +- form/_ComboBoxMenuMixin.js | 4 +-- form/_DateTimeTextBox.js | 4 +-- form/_FormSelectWidget.js | 22 ++++++------ form/_FormWidget.js | 4 +-- form/_FormWidgetMixin.js | 2 +- form/_SearchMixin.js | 9 ++--- form/_Spinner.js | 2 +- form/_TextBoxMixin.js | 6 ++-- layout/AccordionPane.js | 2 +- layout/ContentPane.js | 12 +++---- layout/LayoutContainer.js | 2 +- layout/ScrollingTabController.js | 2 +- layout/SplitContainer.js | 2 +- layout/StackContainer.js | 7 +--- layout/StackController.js | 2 +- layout/TabController.js | 2 +- layout/_ContentPaneResizeMixin.js | 4 +-- popup.js | 4 +-- registry.js | 2 +- tree/ForestStoreModel.js | 2 +- tree/ObjectStoreModel.js | 4 +-- tree/TreeStoreModel.js | 4 +-- tree/_dndContainer.js | 4 +-- tree/_dndSelector.js | 8 ++--- tree/dndSource.js | 6 ++-- tree/model.js | 4 +-- 76 files changed, 208 insertions(+), 206 deletions(-) diff --git a/Calendar.js b/Calendar.js index e9b3de3ac..917f47ed6 100644 --- a/Calendar.js +++ b/Calendar.js @@ -153,8 +153,8 @@ define([ // Provides keyboard navigation of calendar. // description: // Called from _onKeyDown() to handle keypress on a stand alone Calendar, - // and also from `dijit.form._DateTimeTextBox` to pass a keydown event - // from the `dijit.form.DateTextBox` to be handled in this widget + // and also from `dijit/form/_DateTimeTextBox` to pass a keydown event + // from the `dijit/form/DateTextBox` to be handled in this widget // returns: // False if the key was recognized as a navigation key, // to indicate that the event was handled by Calendar and shouldn't be propagated @@ -222,7 +222,7 @@ define([ // summary: // Deprecated. Notification that a date cell was selected. It may be the same as the previous value. // description: - // Formerly used by `dijit.form._DateTimeTextBox` (and thus `dijit.form.DateTextBox`) + // Formerly used by `dijit/form/_DateTimeTextBox` (and thus `dijit/form/DateTextBox`) // to get notification when the user has clicked a date. Now onExecute() (above) is used. // tags: // protected diff --git a/CalendarLite.js b/CalendarLite.js index 1c9c7c9db..7cf7e2d4f 100644 --- a/CalendarLite.js +++ b/CalendarLite.js @@ -29,7 +29,7 @@ define([ // description: // A simple GUI for choosing a date in the context of a monthly calendar. // This widget can't be used in a form because it doesn't serialize the date to an - // `` field. For a form element, use dijit.form.DateTextBox instead. + // `` field. For a form element, use dijit/form/DateTextBox instead. // // Note that the parser takes all dates attributes passed in the // [RFC 3339 format](http://www.faqs.org/rfcs/rfc3339.html), e.g. `2005-06-30T08:05:00-07:00` diff --git a/ColorPalette.js b/ColorPalette.js index ed0dcb423..d7963f0de 100644 --- a/ColorPalette.js +++ b/ColorPalette.js @@ -87,7 +87,7 @@ var ColorPalette = declare("dijit.ColorPalette", [_Widget, _TemplatedMixin, _Pal ColorPalette._Color = declare("dijit._Color", Color, { // summary: // Object associated with each cell in a ColorPalette palette. - // Implements dijit.Dye. + // Implements dijit/Dye. // Template for each cell in normal (non-high-contrast mode). Each cell contains a wrapper // node for showing the border (called dijitPaletteImg for back-compat), and dijitColorPaletteSwatch diff --git a/Dialog.js b/Dialog.js index 9e22237c4..5f4d59674 100644 --- a/Dialog.js +++ b/Dialog.js @@ -88,12 +88,12 @@ define([ // _firstFocusItem: [private readonly] DomNode // The pointer to the first focusable node in the dialog. - // Set by `dijit._DialogMixin._getFocusItems`. + // Set by `dijit/_DialogMixin._getFocusItems()`. _firstFocusItem: null, // _lastFocusItem: [private readonly] DomNode // The pointer to which node has focus prior to our dialog. - // Set by `dijit._DialogMixin._getFocusItems`. + // Set by `dijit/_DialogMixin._getFocusItems()`. _lastFocusItem: null, // doLayout: [protected] Boolean @@ -553,7 +553,7 @@ define([ // If the specified dialog isn't open then does nothing. // // Caller is responsible for either setting display:none on the dialog domNode, - // or calling dijit.popup.hide(), or removing it from the page DOM. + // or calling dijit/popup.hide(), or removing it from the page DOM. if(ds[ds.length-1].dialog == dialog){ // Removing the top (or only) dialog in the stack, return focus diff --git a/Editor.js b/Editor.js index 33cfec223..d7cc81f1c 100644 --- a/Editor.js +++ b/Editor.js @@ -46,7 +46,7 @@ define([ // the options available in the toolbar. Content generation may vary across // browsers, and clipboard operations may have different results, to name // a few limitations. Note: this widget should not be used with the HTML - // <TEXTAREA> tag -- see dijit._editor.RichText for details. + // <TEXTAREA> tag -- see dijit/_editor/RichText for details. // plugins: [const] Object[] // A list of plugin names (as strings) or instances (as objects) @@ -218,7 +218,7 @@ define([ resize: function(size){ // summary: - // Resize the editor to the specified size, see `dijit.layout._LayoutWidget.resize` + // Resize the editor to the specified size, see `dijit/layout/_LayoutWidget.resize()` if(size){ // we've been given a height/width for the entire editor (toolbar + contents), calls layout() // to split the allocated size between the toolbar and the contents @@ -233,7 +233,7 @@ define([ }, layout: function(){ // summary: - // Called from `dijit.layout._LayoutWidget.resize`. This shouldn't be called directly + // Called from `dijit/layout/_LayoutWidget.resize()`. This shouldn't be called directly // tags: // protected diff --git a/ProgressBar.js b/ProgressBar.js index e55427eae..130f3a2ec 100644 --- a/ProgressBar.js +++ b/ProgressBar.js @@ -57,7 +57,7 @@ return declare("dijit.ProgressBar", [_Widget, _TemplatedMixin], { // name: String // this is the field name (for a form) if set. This needs to be set if you want to use - // this widget in a dijit.form.Form widget (such as dijit.Dialog) + // this widget in a dijit/form/Form widget (such as dijit/Dialog) name: '', templateString: template, diff --git a/TitlePane.js b/TitlePane.js index 6fb7ff8f2..b0c63f1f0 100644 --- a/TitlePane.js +++ b/TitlePane.js @@ -28,7 +28,7 @@ return declare("dijit.TitlePane", [ContentPane, _TemplatedMixin, _CssStateMixin] // description: // An accessible container with a title Heading, and a content // section that slides open and closed. TitlePane is an extension to - // `dijit.layout.ContentPane`, providing all the useful content-control aspects from it. + // `dijit/layout/ContentPane`, providing all the useful content-control aspects from it. // // example: // | // load a TitlePane from remote file: diff --git a/Tooltip.js b/Tooltip.js index 1c3604707..83acf4add 100644 --- a/Tooltip.js +++ b/Tooltip.js @@ -258,8 +258,8 @@ define([ dijit.showTooltip = function(innerHTML, aroundNode, position, rtl, textDir){ // summary: // Static method to display tooltip w/specified contents in specified position. - // See description of dijit.Tooltip.defaultPosition for details on position parameter. - // If position is not specified then dijit.Tooltip.defaultPosition is used. + // See description of dijit/Tooltip.defaultPosition for details on position parameter. + // If position is not specified then dijit/Tooltip.defaultPosition is used. // innerHTML: String // Contents of the tooltip // aroundNode: place.__Rectangle @@ -311,7 +311,7 @@ define([ connectId: [], // position: String[] - // See description of `dijit.Tooltip.defaultPosition` for details on position parameter. + // See description of `dijit/Tooltip.defaultPosition` for details on position parameter. position: [], // selector: String? @@ -506,28 +506,31 @@ define([ Tooltip.show = dijit.showTooltip; // export function through module return value Tooltip.hide = dijit.hideTooltip; // export function through module return value - // dijit.Tooltip.defaultPosition: String[] - // This variable controls the position of tooltips, if the position is not specified to - // the Tooltip widget or *TextBox widget itself. It's an array of strings with the values - // possible for `dijit/place::around()`. The recommended values are: - // - // - before-centered: centers tooltip to the left of the anchor node/widget, or to the right - // in the case of RTL scripts like Hebrew and Arabic - // - after-centered: centers tooltip to the right of the anchor node/widget, or to the left - // in the case of RTL scripts like Hebrew and Arabic - // - above-centered: tooltip is centered above anchor node - // - below-centered: tooltip is centered above anchor node - // - // The list is positions is tried, in order, until a position is found where the tooltip fits - // within the viewport. - // - // Be careful setting this parameter. A value of "above-centered" may work fine until the user scrolls - // the screen so that there's no room above the target node. Nodes with drop downs, like - // DropDownButton or FilteringSelect, are especially problematic, in that you need to be sure - // that the drop down and tooltip don't overlap, even when the viewport is scrolled so that there - // is only room below (or above) the target node, but not both. Tooltip.defaultPosition = ["after-centered", "before-centered"]; - + /*===== + lang.mixin(Tooltip, { + // defaultPosition: String[] + // This variable controls the position of tooltips, if the position is not specified to + // the Tooltip widget or *TextBox widget itself. It's an array of strings with the values + // possible for `dijit/place.around()`. The recommended values are: + // + // - before-centered: centers tooltip to the left of the anchor node/widget, or to the right + // in the case of RTL scripts like Hebrew and Arabic + // - after-centered: centers tooltip to the right of the anchor node/widget, or to the left + // in the case of RTL scripts like Hebrew and Arabic + // - above-centered: tooltip is centered above anchor node + // - below-centered: tooltip is centered above anchor node + // + // The list is positions is tried, in order, until a position is found where the tooltip fits + // within the viewport. + // + // Be careful setting this parameter. A value of "above-centered" may work fine until the user scrolls + // the screen so that there's no room above the target node. Nodes with drop downs, like + // DropDownButton or FilteringSelect, are especially problematic, in that you need to be sure + // that the drop down and tooltip don't overlap, even when the viewport is scrolled so that there + // is only room below (or above) the target node, but not both. + }); + =====*/ return Tooltip; }); diff --git a/TooltipDialog.js b/TooltipDialog.js index c78acadba..f92658fdd 100644 --- a/TooltipDialog.js +++ b/TooltipDialog.js @@ -37,21 +37,21 @@ define([ // autofocus: Boolean // A Toggle to modify the default focus behavior of a Dialog, which // is to focus on the first dialog element after opening the dialog. - // False will disable autofocusing. Default: true + // False will disable autofocusing. Default: true. autofocus: true, // baseClass: [protected] String // The root className to use for the various states of this widget baseClass: "dijitTooltipDialog", - // _firstFocusItem: [private] [readonly] DomNode + // _firstFocusItem: [private readonly] DomNode // The pointer to the first focusable node in the dialog. - // Set by `dijit._DialogMixin._getFocusItems`. + // Set by `dijit/_DialogMixin._getFocusItems()`. _firstFocusItem: null, - // _lastFocusItem: [private] [readonly] DomNode + // _lastFocusItem: [private readonly] DomNode // The pointer to which node has focus prior to our dialog. - // Set by `dijit._DialogMixin._getFocusItems`. + // Set by `dijit/_DialogMixin._getFocusItems()`. _lastFocusItem: null, templateString: template, diff --git a/Tree.js b/Tree.js index e9baec1c8..20f865aca 100644 --- a/Tree.js +++ b/Tree.js @@ -556,7 +556,7 @@ var Tree = declare("dijit.Tree", [_Widget, _TemplatedMixin], { query: null, // label: [deprecated] String - // Deprecated. Use dijit.tree.ForestStoreModel directly instead. + // Deprecated. Use dijit/tree/ForestStoreModel directly instead. // Used in conjunction with query parameter. // If a query is specified (rather than a root node id), and a label is also specified, // then a fake root node is created and displayed, with this label. @@ -612,8 +612,8 @@ var Tree = declare("dijit.Tree", [_Widget, _TemplatedMixin], { // dndController: [protected] Function|String // Class to use as as the dnd controller. Specifying this class enables DnD. - // Generally you should specify this as dijit.tree.dndSource. - // Setting of dijit.tree._dndSelector handles selection only (no actual DnD). + // Generally you should specify this as dijit/tree/dndSource. + // Setting of dijit/tree/_dndSelector handles selection only (no actual DnD). dndController: _dndSelector, // parameters to pull off of the tree and pass on to the dndController as its params @@ -622,7 +622,7 @@ var Tree = declare("dijit.Tree", [_Widget, _TemplatedMixin], { //declare the above items so they can be pulled from the tree's markup // onDndDrop: [protected] Function - // Parameter to dndController, see `dijit.tree.dndSource.onDndDrop`. + // Parameter to dndController, see `dijit/tree/dndSource.onDndDrop()`. // Generally this doesn't need to be set. onDndDrop: null, @@ -642,7 +642,7 @@ var Tree = declare("dijit.Tree", [_Widget, _TemplatedMixin], { // target: DomNode // The target TreeNode.rowNode // source: dojo/dnd/Source - // The source container the nodes were dragged from, perhaps another Tree or a plain dojo.dnd.Source + // The source container the nodes were dragged from, perhaps another Tree or a plain dojo/dnd/Source // returns: Object[] // Array of name/value hashes for each new item to be added to the Tree, like: // | [ @@ -656,7 +656,7 @@ var Tree = declare("dijit.Tree", [_Widget, _TemplatedMixin], { =====*/ // onDndCancel: [protected] Function - // Parameter to dndController, see `dijit.tree.dndSource.onDndCancel`. + // Parameter to dndController, see `dijit/tree/dndSource.onDndCancel()`. // Generally this doesn't need to be set. onDndCancel: null, diff --git a/WidgetSet.js b/WidgetSet.js index bdd2579f1..ea2504479 100644 --- a/WidgetSet.js +++ b/WidgetSet.js @@ -235,7 +235,7 @@ define([ }); - // Add in 1.x compatibility methods to dijit.registry. + // Add in 1.x compatibility methods to dijit/registry. // These functions won't show up in the API doc but since they are deprecated anyway, // that's probably for the best. array.forEach(["forEach", "filter", "byClass", "map", "every", "some"], function(func){ diff --git a/_DialogMixin.js b/_DialogMixin.js index 4e3cd2cf7..8d8388c6d 100644 --- a/_DialogMixin.js +++ b/_DialogMixin.js @@ -30,7 +30,7 @@ define([ // description: // Developer shouldn't override or connect to this method; // it's a private communication device between the TooltipDialog - // and the thing that opened it (ex: `dijit.form.DropDownButton`) + // and the thing that opened it (ex: `dijit/form/DropDownButton`) // type: // protected }, @@ -41,7 +41,7 @@ define([ // description: // Developer shouldn't override or connect to this method; // it's a private communication device between the TooltipDialog - // and the thing that opened it (ex: `dijit.form.DropDownButton`) + // and the thing that opened it (ex: `dijit/form/DropDownButton`) // type: // protected }, diff --git a/_HasDropDown.js b/_HasDropDown.js index e50b010fb..89f02cd64 100644 --- a/_HasDropDown.js +++ b/_HasDropDown.js @@ -189,7 +189,7 @@ define([ // toggle the drop down. // // The if(has("touch") is necessary since IE and desktop safari get spurious onclick events - // when there are nested tables (specifically, clicking on a table that holds a dijit.form.Select, + // when there are nested tables (specifically, clicking on a table that holds a dijit/form/Select, // but not on the Select itself, causes an onclick event on the Select) this._onDropDownMouseDown(e); this._onDropDownMouseUp(e); @@ -369,7 +369,7 @@ define([ // Opens the dropdown for this widget. To be called only when this.dropDown // has been created and is ready to display (ie, it's data is loaded). // returns: - // return value of dijit.popup.open() + // return value of dijit/popup.open() // tags: // protected @@ -380,7 +380,7 @@ define([ // Prepare our popup's height and honor maxHeight if it exists. - // TODO: isn't maxHeight dependent on the return value from dijit.popup.open(), + // TODO: isn't maxHeight dependent on the return value from dijit/popup.open(), // ie, dependent on how much space is available (BK) if(!this._preparedNode){ diff --git a/_OnDijitClickMixin.js b/_OnDijitClickMixin.js index be1fc75ac..42b82c249 100644 --- a/_OnDijitClickMixin.js +++ b/_OnDijitClickMixin.js @@ -31,7 +31,7 @@ define([ // A handle that can be passed to `disconnect` in order to disconnect before // the widget is destroyed. // example: - // | var btn = new dijit.form.Button(); + // | var btn = new Button(); // | // when foo.bar() is called, call the listener we're going to // | // provide in the scope of btn // | btn.connect(foo, "bar", function(){ diff --git a/_TimePicker.js b/_TimePicker.js index 83dfa6078..8151601ce 100644 --- a/_TimePicker.js +++ b/_TimePicker.js @@ -42,7 +42,7 @@ define([ // every clickable element in the time picker increases. // Set in local time, without a time zone. // Example: `T00:15:00` creates 15 minute increments - // Must divide dijit._TimePicker.visibleIncrement evenly + // Must divide dijit/_TimePicker.visibleIncrement evenly clickableIncrement: "T00:15:00", // visibleIncrement: String @@ -449,8 +449,8 @@ define([ handleKey: function(/*Event*/ e){ // summary: - // Called from `dijit.form._DateTimeTextBox` to pass a keypress event - // from the `dijit.form.TimeTextBox` to be handled in this widget + // Called from `dijit/form/_DateTimeTextBox` to pass a keypress event + // from the `dijit/form/TimeTextBox` to be handled in this widget // tags: // protected if(e.keyCode == keys.DOWN_ARROW || e.keyCode == keys.UP_ARROW){ @@ -500,15 +500,15 @@ define([ /*===== TimePicker.__Constraints = declare(locale.__FormatOptions, { // clickableIncrement: String - // See `dijit._TimePicker.clickableIncrement` + // See `dijit/_TimePicker.clickableIncrement` clickableIncrement: "T00:15:00", // visibleIncrement: String - // See `dijit._TimePicker.visibleIncrement` + // See `dijit/_TimePicker.visibleIncrement` visibleIncrement: "T01:00:00", // visibleRange: String - // See `dijit._TimePicker.visibleRange` + // See `dijit/_TimePicker.visibleRange` visibleRange: "T05:00:00" }); =====*/ diff --git a/_Widget.js b/_Widget.js index bcaf98a4b..d4c0c6699 100644 --- a/_Widget.js +++ b/_Widget.js @@ -317,8 +317,8 @@ var _Widget = declare("dijit._Widget", [_WidgetBase, _OnDijitClickMixin, _FocusM onShow: function(){ // summary: // Called when this widget becomes the selected pane in a - // `dijit.layout.TabContainer`, `dijit.layout.StackContainer`, - // `dijit.layout.AccordionContainer`, etc. + // `dijit/layout/TabContainer`, `dijit/layout/StackContainer`, + // `dijit/layout/AccordionContainer`, etc. // // Also called to indicate display of a `dijit.Dialog`, `dijit.TooltipDialog`, or `dijit.TitlePane`. // tags: @@ -328,8 +328,8 @@ var _Widget = declare("dijit._Widget", [_WidgetBase, _OnDijitClickMixin, _FocusM onHide: function(){ // summary: // Called when another widget becomes the selected pane in a - // `dijit.layout.TabContainer`, `dijit.layout.StackContainer`, - // `dijit.layout.AccordionContainer`, etc. + // `dijit/layout/TabContainer`, `dijit/layout/StackContainer`, + // `dijit/layout/AccordionContainer`, etc. // // Also called to indicate hide of a `dijit.Dialog`, `dijit.TooltipDialog`, or `dijit.TitlePane`. // tags: @@ -342,7 +342,7 @@ var _Widget = declare("dijit._Widget", [_WidgetBase, _OnDijitClickMixin, _FocusM // up from a DateTextBox), and it is hidden. // This is called from the dijit.popup code, and should not be called directly. // - // Also used as a parameter for children of `dijit.layout.StackContainer` or subclasses. + // Also used as a parameter for children of `dijit/layout/StackContainer` or subclasses. // Callback if a user tries to close the child. Child will be closed if this function returns true. // tags: // extension diff --git a/_WidgetBase.js b/_WidgetBase.js index e6343d196..5f55a6b8a 100644 --- a/_WidgetBase.js +++ b/_WidgetBase.js @@ -932,7 +932,7 @@ return declare("dijit._WidgetBase", [Stateful, Destroyable], { // A handle that can be passed to `disconnect` in order to disconnect before // the widget is destroyed. // example: - // | var btn = new dijit.form.Button(); + // | var btn = new Button(); // | // when foo.bar() is called, call the listener we're going to // | // provide in the scope of btn // | btn.connect(foo, "bar", function(){ @@ -969,7 +969,7 @@ return declare("dijit._WidgetBase", [Stateful, Destroyable], { // method: Function // The callback // example: - // | var btn = new dijit.form.Button(); + // | var btn = new Button(); // | // when /my/topic is published, this button changes its label to // | // be the parameter of the topic. // | btn.subscribe("/my/topic", function(v){ @@ -1031,19 +1031,19 @@ return declare("dijit._WidgetBase", [Stateful, Destroyable], { // to a variable. // example: // | // create a Button with no srcNodeRef, and place it in the body: - // | var button = new dijit.form.Button({ label:"click" }).placeAt(win.body()); + // | var button = new Button({ label:"click" }).placeAt(win.body()); // | // now, 'button' is still the widget reference to the newly created button // | button.on("click", function(e){ console.log('click'); })); // example: // | // create a button out of a node with id="src" and append it to id="wrapper": - // | var button = new dijit.form.Button({},"src").placeAt("wrapper"); + // | var button = new Button({},"src").placeAt("wrapper"); // example: // | // place a new button as the first element of some div - // | var button = new dijit.form.Button({ label:"click" }).placeAt("wrapper","first"); + // | var button = new Button({ label:"click" }).placeAt("wrapper","first"); // example: // | // create a contentpane and add it to a TabContainer // | var tc = dijit.byId("myTabs"); - // | new dijit.layout.ContentPane({ href:"foo.html", title:"Wow!" }).placeAt(tc) + // | new ContentPane({ href:"foo.html", title:"Wow!" }).placeAt(tc) var refWidget = !reference.tagName && registry.byId(reference); if(refWidget && refWidget.addChild && (!position || typeof position === "number")){ diff --git a/_base/place.js b/_base/place.js index 07af387e7..dbfd2a63a 100644 --- a/_base/place.js +++ b/_base/place.js @@ -29,7 +29,7 @@ define([ // summary: // Like dijit.placeOnScreenAroundNode(), except it accepts an arbitrary object // for the "around" argument and finds a proper processor to place a node. - // Deprecated, new code should use dijit.place.around() instead. + // Deprecated, new code should use dijit/place.around() instead. // Convert old style {"BL": "TL", "BR": "TR"} type argument // to style needed by dijit.place code: @@ -56,7 +56,7 @@ define([ // summary: // Position node adjacent or kitty-corner to aroundNode // such that it's fully visible in viewport. - // Deprecated, new code should use dijit.place.around() instead. + // Deprecated, new code should use dijit/place.around() instead. }; =====*/ @@ -67,7 +67,7 @@ define([ // Like dijit.placeOnScreenAroundNode(), except that the "around" // parameter is an arbitrary rectangle on the screen (x, y, width, height) // instead of a dom node. - // Deprecated, new code should use dijit.place.around() instead. + // Deprecated, new code should use dijit/place.around() instead. }; =====*/ @@ -75,7 +75,7 @@ define([ // summary: // Deprecated method, unneeded when using dijit/place directly. // Transforms the passed array of preferred positions into a format suitable for - // passing as the aroundCorners argument to dijit.placeOnScreenAroundElement. + // passing as the aroundCorners argument to dijit/place.placeOnScreenAroundElement. // position: String[] // This variable controls the position of the drop down. // It's an array of strings with the following values: diff --git a/_editor/RichText.js b/_editor/RichText.js index c0f2996c5..206a34e66 100644 --- a/_editor/RichText.js +++ b/_editor/RichText.js @@ -35,11 +35,11 @@ define([ // module: // dijit/_editor/RichText // summary: -// dijit._editor.RichText is the core of dijit.Editor, which provides basic +// dijit/_editor/RichText is the core of dijit/Editor, which provides basic // WYSIWYG editing features. // if you want to allow for rich text saving with back/forward actions, you must add a text area to your page with -// the id==dijit._scopeName + "._editor.RichText.value" (typically "dijit._editor.RichText.value). For example, +// the id==dijit._scopeName + "._editor.RichText.value" (typically "dijit/_editor/RichText.value). For example, // something like this will work: // // @@ -47,11 +47,11 @@ define([ var RichText = declare("dijit._editor.RichText", [_Widget, _CssStateMixin], { // summary: - // dijit._editor.RichText is the core of dijit.Editor, which provides basic + // dijit/_editor/RichText is the core of dijit.Editor, which provides basic // WYSIWYG editing features. // // description: - // dijit._editor.RichText is the core of dijit.Editor, which provides basic + // dijit/_editor/RichText is the core of dijit.Editor, which provides basic // WYSIWYG editing features. It also encapsulates the differences // of different js engines for various browsers. Do not use this widget // with an HTML <TEXTAREA> tag, since the browser unescapes XML escape characters, @@ -667,7 +667,7 @@ var RichText = declare("dijit._editor.RichText", [_Widget, _CssStateMixin], { // summary: // add an external stylesheet for the editing area // uri: - // A dojo.uri.Uri pointing to the url of the external css file + // Url of the external css file var url=uri.toString(); //if uri is relative, then convert it to absolute so that it can be resolved correctly in iframe @@ -676,7 +676,7 @@ var RichText = declare("dijit._editor.RichText", [_Widget, _CssStateMixin], { } if(array.indexOf(this.editingAreaStyleSheets, url) > -1){ -// console.debug("dijit._editor.RichText.addStyleSheet: Style sheet "+url+" is already applied"); +// console.debug("dijit/_editor/RichText.addStyleSheet(): Style sheet "+url+" is already applied"); return; } @@ -695,7 +695,7 @@ var RichText = declare("dijit._editor.RichText", [_Widget, _CssStateMixin], { })); }, - removeStyleSheet: function(/*dojo/base/url*/ uri){ + removeStyleSheet: function(/*dojo/_base/url*/ uri){ // summary: // remove an external stylesheet for the editing area var url=uri.toString(); @@ -705,7 +705,7 @@ var RichText = declare("dijit._editor.RichText", [_Widget, _CssStateMixin], { } var index = array.indexOf(this.editingAreaStyleSheets, url); if(index === -1){ -// console.debug("dijit._editor.RichText.removeStyleSheet: Style sheet "+url+" has not been applied"); +// console.debug("dijit/_editor/RichText.removeStyleSheet(): Style sheet "+url+" has not been applied"); return; } delete this.editingAreaStyleSheets[index]; @@ -1356,7 +1356,7 @@ var RichText = declare("dijit._editor.RichText", [_Widget, _CssStateMixin], { _sCall: function(name, args){ // summary: - // Run the named method of dijit._editor.selection over the + // Run the named method of dijit/_editor/selection over the // current editor instance's window, with the passed args. // tags: // private diff --git a/_editor/_Plugin.js b/_editor/_Plugin.js index 2278a1512..cf6d9580f 100644 --- a/_editor/_Plugin.js +++ b/_editor/_Plugin.js @@ -53,7 +53,7 @@ var _Plugin = declare("dijit._editor._Plugin", null, { useDefaultCommand: true, // buttonClass: Widget Class - // Class of widget (ex: dijit.form.Button or dijit.form.FilteringSelect) + // Class of widget (ex: dijit.form.Button or dijit/form/FilteringSelect) // that is added to the toolbar to control this plugin. // This is used to instantiate the button, unless `button` itself is specified directly. buttonClass: Button, @@ -114,7 +114,7 @@ var _Plugin = declare("dijit._editor._Plugin", null, { connect: function(o, f, tf){ // summary: // Make a connect.connect() that is automatically disconnected when this plugin is destroyed. - // Similar to `dijit._Widget.connect`. + // Similar to `dijit/_Widget.connect()`. // tags: // protected this._connects.push(connect.connect(o, f, this, tf)); diff --git a/_editor/plugins/AlwaysShowToolbar.js b/_editor/plugins/AlwaysShowToolbar.js index b2f28845c..541975712 100644 --- a/_editor/plugins/AlwaysShowToolbar.js +++ b/_editor/plugins/AlwaysShowToolbar.js @@ -23,8 +23,11 @@ return declare("dijit._editor.plugins.AlwaysShowToolbar", _Plugin, { // Specify this in extraPlugins (or plugins) parameter and also set // height to "". // example: + // | // |
+ // | data-dojo-props="extraPlugins: [AlwaysShowToolbar]"> // _handleScroll: Boolean // Enables/disables the handler for scroll events diff --git a/_editor/plugins/FontChoice.js b/_editor/plugins/FontChoice.js index 6e20f63a2..e0e481368 100644 --- a/_editor/plugins/FontChoice.js +++ b/_editor/plugins/FontChoice.js @@ -443,7 +443,7 @@ var FontChoice = declare("dijit._editor.plugins.FontChoice", _Plugin,{ // useDefaultCommand: [protected] Boolean // Override _Plugin.useDefaultCommand... - // processing is handled by this plugin, not by dijit.Editor. + // processing is handled by this plugin, not by dijit/Editor. useDefaultCommand: false, _initButton: function(){ diff --git a/_editor/plugins/LinkDialog.js b/_editor/plugins/LinkDialog.js index aaa824b67..a1be730c3 100644 --- a/_editor/plugins/LinkDialog.js +++ b/_editor/plugins/LinkDialog.js @@ -34,7 +34,7 @@ var LinkDialog = declare("dijit._editor.plugins.LinkDialog", _Plugin, { // (which triggers a TooltipDialog). buttonClass: DropDownButton, - // Override _Plugin.useDefaultCommand... processing is handled by this plugin, not by dijit.Editor. + // Override _Plugin.useDefaultCommand... processing is handled by this plugin, not by dijit/Editor. useDefaultCommand: false, // urlRegExp: [protected] String diff --git a/_editor/plugins/TabIndent.js b/_editor/plugins/TabIndent.js index bcc04e0eb..ebc5f3de5 100644 --- a/_editor/plugins/TabIndent.js +++ b/_editor/plugins/TabIndent.js @@ -17,7 +17,7 @@ define([ // to indent/outdent list items. This overrides the default behavior // of moving focus from/to the toolbar - // Override _Plugin.useDefaultCommand... processing is handled by this plugin, not by dijit.Editor. + // Override _Plugin.useDefaultCommand... processing is handled by this plugin, not by dijit/Editor. useDefaultCommand: false, // Override _Plugin.buttonClass to use a ToggleButton for this plugin rather than a vanilla Button diff --git a/_editor/range.js b/_editor/range.js index 5f729254a..76150ce8a 100644 --- a/_editor/range.js +++ b/_editor/range.js @@ -30,7 +30,7 @@ dijit.range.getIndex = function(/*DomNode*/node, /*DomNode*/parent){ } } //if(i>=pnode.childNodes.length){ - //dojo.debug("Error finding index of a node in dijit.range.getIndex"); + //dojo.debug("Error finding index of a node in dijit/range.getIndex()"); //} ret.unshift(i); retR.unshift(i - pnode.childNodes.length); @@ -52,7 +52,7 @@ dijit.range.getIndex = function(/*DomNode*/node, /*DomNode*/parent){ n = n.nextSibling; } } -// dojo.profile.end("dijit.range.getIndex"); +// dojo.profile.end("dijit/range.getIndex()"); return {o: ret, r:retR}; }; diff --git a/_tree/dndSource.js b/_tree/dndSource.js index a6deacff7..0c03a9f3c 100644 --- a/_tree/dndSource.js +++ b/_tree/dndSource.js @@ -6,7 +6,7 @@ define([ // module: // dijit/_tree/dndSource // summary: - // Deprecated module, use dijit.tree.dndSource instead + // Deprecated module, use dijit/tree/dndSource instead. // TODO: remove this file in 2.0 kernel.deprecated("dijit._tree.dndSource has been moved to dijit.tree.dndSource, use that instead", "", "2.0"); diff --git a/a11yclick.js b/a11yclick.js index 2b55e39b0..54fb0fa56 100644 --- a/a11yclick.js +++ b/a11yclick.js @@ -62,7 +62,7 @@ define([ lastKeyDownNode = e.target; // Prevent viewport scrolling on space key in IE<9. - // (Reproducible on test_Button.html on any of the first dijit.form.Button examples) + // (Reproducible on test_Button.html on any of the first dijit/form/Button examples) e.preventDefault(); } }), diff --git a/form/Button.js b/form/Button.js index 13ffc1a6c..3c23722b1 100644 --- a/form/Button.js +++ b/form/Button.js @@ -33,7 +33,7 @@ return declare("dijit.form.Button", [_FormWidget, _ButtonMixin], { // | // // example: - // | var button1 = new dijit.form.Button({label: "hello world", onClick: foo}); + // | var button1 = new Button({label: "hello world", onClick: foo}); // | dojo.body().appendChild(button1.domNode); // showLabel: Boolean diff --git a/form/ComboBoxMixin.js b/form/ComboBoxMixin.js index e8c5c5b05..80910befc 100644 --- a/form/ComboBoxMixin.js +++ b/form/ComboBoxMixin.js @@ -3,7 +3,7 @@ define([ "dojo/_base/Deferred", "dojo/_base/kernel", // kernel.deprecated "dojo/_base/lang", // lang.mixin - "dojo/store/util/QueryResults", // dojo.store.util.QueryResults + "dojo/store/util/QueryResults", "./_AutoCompleterMixin", "./_ComboBoxMenu", "../_HasDropDown", @@ -33,10 +33,10 @@ define([ baseClass: "dijitTextBox dijitComboBox", /*===== - // store: [const] dojo.store.api.Store || dojo.data.api.Read + // store: [const] dojo/store/api/Store || dojo/data/api/Read // Reference to data provider object used by this ComboBox. // - // Should be dojo.store.api.Store, but dojo.data.api.Read supported + // Should be dojo/store/api/Store, but dojo/data/api/Read supported // for backwards compatibility. store: null, =====*/ @@ -59,14 +59,14 @@ define([ }, _setStoreAttr: function(store){ - // For backwards-compatibility, accept dojo.data store in addition to dojo.store.store. Remove in 2.0. + // For backwards-compatibility, accept dojo.data store in addition to dojo/store/api/Store. Remove in 2.0. if(!store.get){ lang.mixin(store, { _oldAPI: true, get: function(id){ // summary: // Retrieves an object by it's identity. This will trigger a fetchItemByIdentity. - // Like dojo.store.DataStore.get() except returns native item. + // Like dojo/store/DataStore.get() except returns native item. var deferred = new Deferred(); this.fetchItemByIdentity({ identity: id, @@ -81,7 +81,7 @@ define([ }, query: function(query, options){ // summary: - // Queries the store for objects. Like dojo.store.DataStore.query() + // Queries the store for objects. Like dojo/store/DataStore.query() // except returned Deferred contains array of native items. var deferred = new Deferred(function(){ fetchHandle.abort && fetchHandle.abort(); }); deferred.total = new Deferred(); diff --git a/form/ComboButton.js b/form/ComboButton.js index 61c6ba9ba..e5c4f43d6 100644 --- a/form/ComboButton.js +++ b/form/ComboButton.js @@ -23,7 +23,7 @@ return declare("dijit.form.ComboButton", DropDownButton, { // | // // example: - // | var button1 = new dijit.form.ComboButton({label: "hello world", onClick: foo, dropDown: "myMenu"}); + // | var button1 = new ComboButton({label: "hello world", onClick: foo, dropDown: "myMenu"}); // | dojo.body().appendChild(button1.domNode); // diff --git a/form/CurrencyTextBox.js b/form/CurrencyTextBox.js index 7da8c2bcd..eeeba0c12 100644 --- a/form/CurrencyTextBox.js +++ b/form/CurrencyTextBox.js @@ -16,7 +16,7 @@ define([ // displaying the value when the field is not focused (currency symbol, // etc.) // description: - // Follows the pattern of `dijit.form.NumberTextBox.constraints`. + // Follows the pattern of `dijit/form/NumberTextBox.__Constraints`. // In general developers won't need to set this parameter // example: // To ensure that the user types in the cents (for example, 1.00 instead of just 1): @@ -28,7 +28,7 @@ define([ // summary: // A validating currency textbox // description: - // CurrencyTextBox is similar to `dijit.form.NumberTextBox` but has a few + // CurrencyTextBox is similar to `dijit/form/NumberTextBox` but has a few // extra features related to currency: // // 1. After specifying the currency type (american dollars, euros, etc.) it automatically diff --git a/form/DataList.js b/form/DataList.js index 128677c45..e01367ba9 100644 --- a/form/DataList.js +++ b/form/DataList.js @@ -3,7 +3,7 @@ define([ "dojo/dom", // dom.byId "dojo/_base/lang", // lang.trim "dojo/query", // query - "dojo/store/Memory", // dojo.store.Memory + "dojo/store/Memory", "../registry" // registry.add registry.remove ], function(declare, dom, lang, query, MemoryStore, registry){ diff --git a/form/DateTextBox.js b/form/DateTextBox.js index 19751c651..66ef7ce89 100644 --- a/form/DateTextBox.js +++ b/form/DateTextBox.js @@ -13,7 +13,7 @@ define([ // example: // | new DateTextBox({value: new Date(2009, 0, 20)}) // example: - // | + // | baseClass: "dijitTextBox dijitComboBox dijitDateTextBox", popupClass: Calendar, diff --git a/form/DropDownButton.js b/form/DropDownButton.js index c8e69bc1a..bc72abe26 100644 --- a/form/DropDownButton.js +++ b/form/DropDownButton.js @@ -25,7 +25,7 @@ return declare("dijit.form.DropDownButton", [Button, _Container, _HasDropDown], // | // // example: - // | var button1 = new dijit.form.DropDownButton({ label: "hi", dropDown: new dijit.Menu(...) }); + // | var button1 = new DropDownButton({ label: "hi", dropDown: new dijit.Menu(...) }); // | win.body().appendChild(button1); // diff --git a/form/FilteringSelect.js b/form/FilteringSelect.js index 06e93b93d..d9cb798cb 100644 --- a/form/FilteringSelect.js +++ b/form/FilteringSelect.js @@ -193,8 +193,8 @@ define([ // remove this branch for 2.0 q = qs; }else{ - // Query on searchAttr is a regex for benefit of dojo.store.Memory, - // but with a toString() method to help dojo.store.JsonRest. + // Query on searchAttr is a regex for benefit of dojo/store/Memory, + // but with a toString() method to help dojo/store/JsonRest. // Search string like "Co*" converted to regex like /^Co.*$/i. q = filter.patternToRegExp(qs, this.ignoreCase); q.toString = function(){ return qs; }; diff --git a/form/HorizontalRule.js b/form/HorizontalRule.js index 5378865db..2c05090bc 100644 --- a/form/HorizontalRule.js +++ b/form/HorizontalRule.js @@ -10,7 +10,7 @@ define([ return declare("dijit.form.HorizontalRule", [_Widget, _TemplatedMixin], { // summary: - // Hash marks for `dijit.form.HorizontalSlider` + // Hash marks for `dijit/form/HorizontalSlider` templateString: '
', diff --git a/form/HorizontalRuleLabels.js b/form/HorizontalRuleLabels.js index 8e7c4f829..874aa41fc 100644 --- a/form/HorizontalRuleLabels.js +++ b/form/HorizontalRuleLabels.js @@ -10,7 +10,7 @@ define([ return declare("dijit.form.HorizontalRuleLabels", HorizontalRule, { // summary: - // Labels for `dijit.form.HorizontalSlider` + // Labels for `dijit/form/HorizontalSlider` templateString: '
', diff --git a/form/MappedTextBox.js b/form/MappedTextBox.js index 0140f27b5..9850a95c0 100644 --- a/form/MappedTextBox.js +++ b/form/MappedTextBox.js @@ -9,14 +9,14 @@ define([ return declare("dijit.form.MappedTextBox", ValidationTextBox, { // summary: - // A dijit.form.ValidationTextBox subclass which provides a base class for widgets that have + // A dijit/form/ValidationTextBox subclass which provides a base class for widgets that have // a visible formatted display value, and a serializable // value in a hidden input field which is actually sent to the server. // description: // The visible display may // be locale-dependent and interactive. The value sent to the server is stored in a hidden // input field which uses the `name` attribute declared by the original widget. That value sent - // to the server is defined by the dijit.form.MappedTextBox.serialize method and is typically + // to the server is defined by the dijit/form/MappedTextBox.serialize() method and is typically // locale-neutral. // tags: // protected @@ -54,13 +54,13 @@ define([ }, validate: function(){ - // Overrides `dijit.form.TextBox.validate` + // Overrides `dijit/form/TextBox.validate` this.valueNode.value = this.toString(); return this.inherited(arguments); }, buildRendering: function(){ - // Overrides `dijit._TemplatedMixin.buildRendering` + // Overrides `dijit/_TemplatedMixin/buildRendering` this.inherited(arguments); @@ -72,7 +72,7 @@ define([ }, reset: function(){ - // Overrides `dijit.form.ValidationTextBox.reset` to + // Overrides `dijit/form/ValidationTextBox.reset` to // reset the hidden textbox value to '' this.valueNode.value = ''; this.inherited(arguments); diff --git a/form/NumberSpinner.js b/form/NumberSpinner.js index 7912a751a..6b8a2bd1b 100644 --- a/form/NumberSpinner.js +++ b/form/NumberSpinner.js @@ -15,13 +15,13 @@ return declare("dijit.form.NumberSpinner", [_Spinner, NumberTextBox.Mixin], { // Extends NumberTextBox to add up/down arrows and pageup/pagedown for incremental change to the value // // description: - // A `dijit.form.NumberTextBox` extension to provide keyboard accessible value selection + // A `dijit/form/NumberTextBox` extension to provide keyboard accessible value selection // as well as icons for spinning direction. When using the keyboard, the typematic rules // apply, meaning holding the key will gradually increase or decrease the value and // accelerate. // // example: - // | new dijit.form.NumberSpinner({ constraints:{ max:300, min:100 }}, "someInput"); + // | new NumberSpinner({ constraints:{ max:300, min:100 }}, "someInput"); adjust: function(/*Object*/ val, /*Number*/ delta){ // summary: diff --git a/form/NumberTextBox.js b/form/NumberTextBox.js index f20b759a9..5dab4f422 100644 --- a/form/NumberTextBox.js +++ b/form/NumberTextBox.js @@ -102,7 +102,7 @@ define([ var formattedValue = String(value); if(typeof value != "number"){ return formattedValue; } if(isNaN(value)){ return ""; } - // check for exponential notation that dojo.number.format chokes on + // check for exponential notation that dojo/number.format() chokes on if(!("rangeCheck" in this && this.rangeCheck(value, constraints)) && constraints.exponent !== false && /\de[-+]?\d/i.test(formattedValue)){ return formattedValue; } @@ -152,7 +152,7 @@ define([ // When called with the actual value it does corrections so that '' etc. are represented as NaN. // Otherwise it dispatches to the superclass's filter() method. // - // See `dijit.form.TextBox.filter` for more details. + // See `dijit/form/TextBox.filter()` for more details. return (value == null /* or undefined */ || value === '') ? NaN : this.inherited(arguments); // set('value', null||''||undefined) should fire onChange(NaN) }, @@ -213,7 +213,7 @@ define([ }, isValid: function(/*Boolean*/ isFocused){ - // Overrides dijit.form.RangeBoundTextBox.isValid to check that the editing-mode value is valid since + // Overrides dijit/form/RangeBoundTextBox.isValid() to check that the editing-mode value is valid since // it may not be formatted according to the regExp validation rules if(!this.focused || this._isEmpty(this.textbox.value)){ return this.inherited(arguments); diff --git a/form/RangeBoundTextBox.js b/form/RangeBoundTextBox.js index 3446003c6..a68bc4cdd 100644 --- a/form/RangeBoundTextBox.js +++ b/form/RangeBoundTextBox.js @@ -58,20 +58,20 @@ define([ _isValidSubset: function(){ // summary: - // Overrides `dijit.form.ValidationTextBox._isValidSubset`. + // Overrides `dijit/form/ValidationTextBox._isValidSubset()`. // Returns true if the input is syntactically valid, and either within // range or could be made in range by more typing. return this.inherited(arguments) && !this._isDefinitelyOutOfRange(); }, isValid: function(/*Boolean*/ isFocused){ - // Overrides dijit.form.ValidationTextBox.isValid to check that the value is also in range. + // Overrides dijit/form/ValidationTextBox.isValid() to check that the value is also in range. return this.inherited(arguments) && ((this._isEmpty(this.textbox.value) && !this.required) || this.isInRange(isFocused)); // Boolean }, getErrorMessage: function(/*Boolean*/ isFocused){ - // Overrides dijit.form.ValidationTextBox.getErrorMessage to print "out of range" message if appropriate + // Overrides dijit/form/ValidationTextBox.getErrorMessage() to print "out of range" message if appropriate var v = this.get('value'); if(v != null /* and !undefined */ && v !== '' && (typeof v != "number" || !isNaN(v)) && !this.isInRange(isFocused)){ // don't check isInRange w/o a real value return this.rangeMessage; // String diff --git a/form/SimpleTextarea.js b/form/SimpleTextarea.js index c0d759891..b2134479a 100644 --- a/form/SimpleTextarea.js +++ b/form/SimpleTextarea.js @@ -12,14 +12,14 @@ define([ return declare("dijit.form.SimpleTextarea", TextBox, { // summary: // A simple textarea that degrades, and responds to - // minimal LayoutContainer usage, and works with dijit.form.Form. + // minimal LayoutContainer usage, and works with dijit/form/Form. // Doesn't automatically size according to input, like Textarea. // // example: // | // // example: - // | new dijit.form.SimpleTextarea({ rows:20, cols:30 }, "foo"); + // | new SimpleTextarea({ rows:20, cols:30 }, "foo"); baseClass: "dijitTextBox dijitTextArea", diff --git a/form/TimeTextBox.js b/form/TimeTextBox.js index 1387ecff1..ebc32ec68 100644 --- a/form/TimeTextBox.js +++ b/form/TimeTextBox.js @@ -32,13 +32,13 @@ define([ // The value of this widget as a JavaScript Date object. Note that the date portion implies time zone and daylight savings rules. // // Example: - // | new dijit.form.TimeTextBox({value: stamp.fromISOString("T12:59:59", new Date())}) + // | new dijit/form/TimeTextBox({value: stamp.fromISOString("T12:59:59", new Date())}) // // When passed to the parser in markup, must be specified according to locale-independent // `stamp.fromISOString` format. // // Example: - // | + // | value: new Date(""), // value.toString()="NaN" //FIXME: in markup, you have no control over daylight savings diff --git a/form/ValidationTextBox.js b/form/ValidationTextBox.js index 7832a9ad8..279304553 100644 --- a/form/ValidationTextBox.js +++ b/form/ValidationTextBox.js @@ -83,7 +83,7 @@ define([ state: "", // tooltipPosition: String[] - // See description of `dijit.Tooltip.defaultPosition` for details on this parameter. + // See description of `dijit/Tooltip.defaultPosition` for details on this parameter. tooltipPosition: [], _deprecateRegExp: function(attr, value){ @@ -308,7 +308,7 @@ define([ }, reset:function(){ - // Overrides dijit.form.TextBox.reset() by also + // Overrides dijit/form/TextBox.reset() by also // hiding errors about partial matches this._maskValidSubsetError = true; this.inherited(arguments); diff --git a/form/VerticalRule.js b/form/VerticalRule.js index 60b03f570..4f0397ee2 100644 --- a/form/VerticalRule.js +++ b/form/VerticalRule.js @@ -8,7 +8,7 @@ define([ return declare("dijit.form.VerticalRule", HorizontalRule, { // summary: - // Hash marks for the `dijit.form.VerticalSlider` + // Hash marks for the `dijit/form/VerticalSlider` templateString: '
', _positionPrefix: '
', diff --git a/form/_AutoCompleterMixin.js b/form/_AutoCompleterMixin.js index 48f2bfabf..1f8dfe23c 100644 --- a/form/_AutoCompleterMixin.js +++ b/form/_AutoCompleterMixin.js @@ -21,14 +21,14 @@ define([ return declare("dijit.form._AutoCompleterMixin", SearchMixin, { // summary: - // A mixin that implements the base functionality for `dijit.form.ComboBox`/`dijit.form.FilteringSelect` + // A mixin that implements the base functionality for `dijit/form/ComboBox`/`dijit/form/FilteringSelect` // description: - // All widgets that mix in dijit.form._AutoCompleterMixin must extend `dijit.form._FormValueWidget`. + // All widgets that mix in dijit/form/_AutoCompleterMixin must extend `dijit/form/_FormValueWidget`. // tags: // protected // item: Object - // This is the item returned by the dojo.data.store implementation that + // This is the item returned by the dojo/store/api/Store implementation that // provides the data for this ComboBox, it's the currently selected item. item: null, @@ -437,7 +437,7 @@ define([ _getValueField: function(){ // summary: // Helper for postMixInProperties() to set this.value based on data inlined into the markup. - // Returns the attribute name in the item (in dijit.form._ComboBoxDataStore) to use as the value. + // Returns the attribute name in the item (in dijit/form/_ComboBoxDataStore) to use as the value. return this.searchAttr; }, diff --git a/form/_ButtonMixin.js b/form/_ButtonMixin.js index ccedede7d..292303dd2 100644 --- a/form/_ButtonMixin.js +++ b/form/_ButtonMixin.js @@ -22,7 +22,7 @@ return declare("dijit.form._ButtonMixin", null, { // example: // | // example: - // | var button1 = new dijit.form.Button({label: "hello world", onClick: foo}); + // | var button1 = new Button({label: "hello world", onClick: foo}); // | dojo.body().appendChild(button1.domNode); // label: HTML String diff --git a/form/_CheckBoxMixin.js b/form/_CheckBoxMixin.js index b9c4579f3..0f73f935d 100644 --- a/form/_CheckBoxMixin.js +++ b/form/_CheckBoxMixin.js @@ -43,8 +43,8 @@ define([ this.focusNode.setAttribute("aria-readonly", value); }, - // Override dijit.form.Button._setLabelAttr() since we don't even have a containerNode. - // Normally users won't try to set label, except when CheckBox or RadioButton is the child of a dojox.layout.TabContainer + // Override dijit/form/Button._setLabelAttr() since we don't even have a containerNode. + // Normally users won't try to set label, except when CheckBox or RadioButton is the child of a dojox/layout/TabContainer _setLabelAttr: undefined, _getSubmitValue: function(/*String*/ value){ diff --git a/form/_ComboBoxMenu.js b/form/_ComboBoxMenu.js index 458e66b22..73c7d15fb 100644 --- a/form/_ComboBoxMenu.js +++ b/form/_ComboBoxMenu.js @@ -16,7 +16,7 @@ define([ return declare("dijit.form._ComboBoxMenu",[_WidgetBase, _TemplatedMixin, _ListMouseMixin, _ComboBoxMenuMixin], { // summary: - // Focus-less menu for internal use in `dijit.form.ComboBox` + // Focus-less menu for internal use in `dijit/form/ComboBox` // Abstract methods that must be defined externally: // // - onChange: item was explicitly chosen (mousedown somewhere on the menu and mouseup somewhere on the menu) diff --git a/form/_ComboBoxMenuMixin.js b/form/_ComboBoxMenuMixin.js index 2fdc1ea14..eac09c8e1 100644 --- a/form/_ComboBoxMenuMixin.js +++ b/form/_ComboBoxMenuMixin.js @@ -11,7 +11,7 @@ define([ return declare( "dijit.form._ComboBoxMenuMixin", null, { // summary: - // Focus-less menu for internal use in `dijit.form.ComboBox` + // Focus-less menu for internal use in `dijit/form/ComboBox` // tags: // private @@ -75,7 +75,7 @@ return declare( "dijit.form._ComboBoxMenuMixin", null, { _createOption: function(/*Object*/ item, labelFunc){ // summary: // Creates an option to appear on the popup menu subclassed by - // `dijit.form.FilteringSelect`. + // `dijit/form/FilteringSelect`. var menuitem = this._createMenuItem(); var labelObject = labelFunc(item); diff --git a/form/_DateTimeTextBox.js b/form/_DateTimeTextBox.js index 554d820f6..96ca5b2a5 100644 --- a/form/_DateTimeTextBox.js +++ b/form/_DateTimeTextBox.js @@ -34,7 +34,7 @@ define([ // Despite the name, this parameter specifies both constraints on the input // (including starting/ending dates/times allowed) as well as // formatting options like whether the date is displayed in long (ex: December 25, 2005) - // or short (ex: 12/25/2005) format. See `dijit.form._DateTimeTextBox.__Constraints` for details. + // or short (ex: 12/25/2005) format. See `dijit/form/_DateTimeTextBox.__Constraints` for details. constraints: {}, ======*/ @@ -97,7 +97,7 @@ define([ // value: Date // The value of this widget as a JavaScript Date object. Use get("value") / set("value", val) to manipulate. - // When passed to the parser in markup, must be specified according to `dojo.date.stamp.fromISOString` + // When passed to the parser in markup, must be specified according to `dojo/date/stamp.fromISOString()` value: new Date(""), // value.toString()="NaN" _blankValue: null, // used by filter() when the textbox is blank diff --git a/form/_FormSelectWidget.js b/form/_FormSelectWidget.js index 9ee47664c..069e66f00 100644 --- a/form/_FormSelectWidget.js +++ b/form/_FormSelectWidget.js @@ -10,7 +10,7 @@ define([ "dojo/_base/lang", // lang.delegate lang.isArray lang.isObject lang.hitch "dojo/query", // query "dojo/when", - "dojo/store/util/QueryResults", // dojo.store.util.QueryResults + "dojo/store/util/QueryResults", "./_FormValueWidget" ], function(array, Deferred, aspect, sorter, declare, dom, domClass, kernel, lang, query, when, QueryResults, _FormValueWidget){ @@ -51,7 +51,7 @@ var _FormSelectWidget = declare("dijit.form._FormSelectWidget", _FormValueWidget // store: dojo/store/api/Store // A store to use for getting our list of options - rather than reading them // from the `