mirror of
https://git.tt-rss.org/git/tt-rss.git
synced 2025-12-14 13:25:54 +00:00
update dojo to 1.7.3
This commit is contained in:
Andrew Dolgov
595
lib/dijit/form/_FormSelectWidget.js.uncompressed.js
Normal file
595
lib/dijit/form/_FormSelectWidget.js.uncompressed.js
Normal file
@@ -0,0 +1,595 @@
|
||||
define("dijit/form/_FormSelectWidget", [
|
||||
"dojo/_base/array", // array.filter array.forEach array.map array.some
|
||||
"dojo/aspect", // aspect.after
|
||||
"dojo/data/util/sorter", // util.sorter.createSortFunction
|
||||
"dojo/_base/declare", // declare
|
||||
"dojo/dom", // dom.setSelectable
|
||||
"dojo/dom-class", // domClass.toggle
|
||||
"dojo/_base/kernel", // _scopeName
|
||||
"dojo/_base/lang", // lang.delegate lang.isArray lang.isObject lang.hitch
|
||||
"dojo/query", // query
|
||||
"./_FormValueWidget"
|
||||
], function(array, aspect, sorter, declare, dom, domClass, kernel, lang, query, _FormValueWidget){
|
||||
|
||||
/*=====
|
||||
var _FormValueWidget = dijit.form._FormValueWidget;
|
||||
=====*/
|
||||
|
||||
// module:
|
||||
// dijit/form/_FormSelectWidget
|
||||
// summary:
|
||||
// Extends _FormValueWidget in order to provide "select-specific"
|
||||
// values - i.e., those values that are unique to <select> elements.
|
||||
|
||||
|
||||
/*=====
|
||||
dijit.form.__SelectOption = function(){
|
||||
// value: String
|
||||
// The value of the option. Setting to empty (or missing) will
|
||||
// place a separator at that location
|
||||
// label: String
|
||||
// The label for our option. It can contain html tags.
|
||||
// selected: Boolean
|
||||
// Whether or not we are a selected option
|
||||
// disabled: Boolean
|
||||
// Whether or not this specific option is disabled
|
||||
this.value = value;
|
||||
this.label = label;
|
||||
this.selected = selected;
|
||||
this.disabled = disabled;
|
||||
}
|
||||
=====*/
|
||||
|
||||
return declare("dijit.form._FormSelectWidget", _FormValueWidget, {
|
||||
// summary:
|
||||
// Extends _FormValueWidget in order to provide "select-specific"
|
||||
// values - i.e., those values that are unique to <select> elements.
|
||||
// This also provides the mechanism for reading the elements from
|
||||
// a store, if desired.
|
||||
|
||||
// multiple: [const] Boolean
|
||||
// Whether or not we are multi-valued
|
||||
multiple: false,
|
||||
|
||||
// options: dijit.form.__SelectOption[]
|
||||
// The set of options for our select item. Roughly corresponds to
|
||||
// the html <option> tag.
|
||||
options: null,
|
||||
|
||||
// store: dojo.data.api.Identity
|
||||
// A store which, at the very least implements dojo.data.api.Identity
|
||||
// to use for getting our list of options - rather than reading them
|
||||
// from the <option> html tags.
|
||||
store: null,
|
||||
|
||||
// query: object
|
||||
// A query to use when fetching items from our store
|
||||
query: null,
|
||||
|
||||
// queryOptions: object
|
||||
// Query options to use when fetching from the store
|
||||
queryOptions: null,
|
||||
|
||||
// onFetch: Function
|
||||
// A callback to do with an onFetch - but before any items are actually
|
||||
// iterated over (i.e. to filter even further what you want to add)
|
||||
onFetch: null,
|
||||
|
||||
// sortByLabel: Boolean
|
||||
// Flag to sort the options returned from a store by the label of
|
||||
// the store.
|
||||
sortByLabel: true,
|
||||
|
||||
|
||||
// loadChildrenOnOpen: Boolean
|
||||
// By default loadChildren is called when the items are fetched from the
|
||||
// store. This property allows delaying loadChildren (and the creation
|
||||
// of the options/menuitems) until the user clicks the button to open the
|
||||
// dropdown.
|
||||
loadChildrenOnOpen: false,
|
||||
|
||||
getOptions: function(/*anything*/ valueOrIdx){
|
||||
// summary:
|
||||
// Returns a given option (or options).
|
||||
// valueOrIdx:
|
||||
// If passed in as a string, that string is used to look up the option
|
||||
// in the array of options - based on the value property.
|
||||
// (See dijit.form.__SelectOption).
|
||||
//
|
||||
// If passed in a number, then the option with the given index (0-based)
|
||||
// within this select will be returned.
|
||||
//
|
||||
// If passed in a dijit.form.__SelectOption, the same option will be
|
||||
// returned if and only if it exists within this select.
|
||||
//
|
||||
// If passed an array, then an array will be returned with each element
|
||||
// in the array being looked up.
|
||||
//
|
||||
// If not passed a value, then all options will be returned
|
||||
//
|
||||
// returns:
|
||||
// The option corresponding with the given value or index. null
|
||||
// is returned if any of the following are true:
|
||||
// - A string value is passed in which doesn't exist
|
||||
// - An index is passed in which is outside the bounds of the array of options
|
||||
// - A dijit.form.__SelectOption is passed in which is not a part of the select
|
||||
|
||||
// NOTE: the compare for passing in a dijit.form.__SelectOption checks
|
||||
// if the value property matches - NOT if the exact option exists
|
||||
// NOTE: if passing in an array, null elements will be placed in the returned
|
||||
// array when a value is not found.
|
||||
var lookupValue = valueOrIdx, opts = this.options || [], l = opts.length;
|
||||
|
||||
if(lookupValue === undefined){
|
||||
return opts; // dijit.form.__SelectOption[]
|
||||
}
|
||||
if(lang.isArray(lookupValue)){
|
||||
return array.map(lookupValue, "return this.getOptions(item);", this); // dijit.form.__SelectOption[]
|
||||
}
|
||||
if(lang.isObject(valueOrIdx)){
|
||||
// We were passed an option - so see if it's in our array (directly),
|
||||
// and if it's not, try and find it by value.
|
||||
if(!array.some(this.options, function(o, idx){
|
||||
if(o === lookupValue ||
|
||||
(o.value && o.value === lookupValue.value)){
|
||||
lookupValue = idx;
|
||||
return true;
|
||||
}
|
||||
return false;
|
||||
})){
|
||||
lookupValue = -1;
|
||||
}
|
||||
}
|
||||
if(typeof lookupValue == "string"){
|
||||
for(var i=0; i<l; i++){
|
||||
if(opts[i].value === lookupValue){
|
||||
lookupValue = i;
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
if(typeof lookupValue == "number" && lookupValue >= 0 && lookupValue < l){
|
||||
return this.options[lookupValue]; // dijit.form.__SelectOption
|
||||
}
|
||||
return null; // null
|
||||
},
|
||||
|
||||
addOption: function(/*dijit.form.__SelectOption|dijit.form.__SelectOption[]*/ option){
|
||||
// summary:
|
||||
// Adds an option or options to the end of the select. If value
|
||||
// of the option is empty or missing, a separator is created instead.
|
||||
// Passing in an array of options will yield slightly better performance
|
||||
// since the children are only loaded once.
|
||||
if(!lang.isArray(option)){ option = [option]; }
|
||||
array.forEach(option, function(i){
|
||||
if(i && lang.isObject(i)){
|
||||
this.options.push(i);
|
||||
}
|
||||
}, this);
|
||||
this._loadChildren();
|
||||
},
|
||||
|
||||
removeOption: function(/*String|dijit.form.__SelectOption|Number|Array*/ valueOrIdx){
|
||||
// summary:
|
||||
// Removes the given option or options. You can remove by string
|
||||
// (in which case the value is removed), number (in which case the
|
||||
// index in the options array is removed), or select option (in
|
||||
// which case, the select option with a matching value is removed).
|
||||
// You can also pass in an array of those values for a slightly
|
||||
// better performance since the children are only loaded once.
|
||||
if(!lang.isArray(valueOrIdx)){ valueOrIdx = [valueOrIdx]; }
|
||||
var oldOpts = this.getOptions(valueOrIdx);
|
||||
array.forEach(oldOpts, function(i){
|
||||
// We can get null back in our array - if our option was not found. In
|
||||
// that case, we don't want to blow up...
|
||||
if(i){
|
||||
this.options = array.filter(this.options, function(node){
|
||||
return (node.value !== i.value || node.label !== i.label);
|
||||
});
|
||||
this._removeOptionItem(i);
|
||||
}
|
||||
}, this);
|
||||
this._loadChildren();
|
||||
},
|
||||
|
||||
updateOption: function(/*dijit.form.__SelectOption|dijit.form.__SelectOption[]*/ newOption){
|
||||
// summary:
|
||||
// Updates the values of the given option. The option to update
|
||||
// is matched based on the value of the entered option. Passing
|
||||
// in an array of new options will yield better performance since
|
||||
// the children will only be loaded once.
|
||||
if(!lang.isArray(newOption)){ newOption = [newOption]; }
|
||||
array.forEach(newOption, function(i){
|
||||
var oldOpt = this.getOptions(i), k;
|
||||
if(oldOpt){
|
||||
for(k in i){ oldOpt[k] = i[k]; }
|
||||
}
|
||||
}, this);
|
||||
this._loadChildren();
|
||||
},
|
||||
|
||||
setStore: function(/*dojo.data.api.Identity*/ store,
|
||||
/*anything?*/ selectedValue,
|
||||
/*Object?*/ fetchArgs){
|
||||
// summary:
|
||||
// Sets the store you would like to use with this select widget.
|
||||
// The selected value is the value of the new store to set. This
|
||||
// function returns the original store, in case you want to reuse
|
||||
// it or something.
|
||||
// store: dojo.data.api.Identity
|
||||
// The store you would like to use - it MUST implement dojo.data.api.Identity,
|
||||
// and MAY implement dojo.data.api.Notification.
|
||||
// selectedValue: anything?
|
||||
// The value that this widget should set itself to *after* the store
|
||||
// has been loaded
|
||||
// fetchArgs: Object?
|
||||
// The arguments that will be passed to the store's fetch() function
|
||||
var oStore = this.store;
|
||||
fetchArgs = fetchArgs || {};
|
||||
if(oStore !== store){
|
||||
// Our store has changed, so update our notifications
|
||||
var h;
|
||||
while(h = this._notifyConnections.pop()){ h.remove(); }
|
||||
|
||||
if(store && store.getFeatures()["dojo.data.api.Notification"]){
|
||||
this._notifyConnections = [
|
||||
aspect.after(store, "onNew", lang.hitch(this, "_onNewItem"), true),
|
||||
aspect.after(store, "onDelete", lang.hitch(this, "_onDeleteItem"), true),
|
||||
aspect.after(store, "onSet", lang.hitch(this, "_onSetItem"), true)
|
||||
];
|
||||
}
|
||||
this._set("store", store);
|
||||
}
|
||||
|
||||
// Turn off change notifications while we make all these changes
|
||||
this._onChangeActive = false;
|
||||
|
||||
// Remove existing options (if there are any)
|
||||
if(this.options && this.options.length){
|
||||
this.removeOption(this.options);
|
||||
}
|
||||
|
||||
// Add our new options
|
||||
if(store){
|
||||
this._loadingStore = true;
|
||||
store.fetch(lang.delegate(fetchArgs, {
|
||||
onComplete: function(items, opts){
|
||||
if(this.sortByLabel && !fetchArgs.sort && items.length){
|
||||
items.sort(sorter.createSortFunction([{
|
||||
attribute: store.getLabelAttributes(items[0])[0]
|
||||
}], store));
|
||||
}
|
||||
|
||||
if(fetchArgs.onFetch){
|
||||
items = fetchArgs.onFetch.call(this, items, opts);
|
||||
}
|
||||
// TODO: Add these guys as a batch, instead of separately
|
||||
array.forEach(items, function(i){
|
||||
this._addOptionForItem(i);
|
||||
}, this);
|
||||
|
||||
// Set our value (which might be undefined), and then tweak
|
||||
// it to send a change event with the real value
|
||||
this._loadingStore = false;
|
||||
this.set("value", "_pendingValue" in this ? this._pendingValue : selectedValue);
|
||||
delete this._pendingValue;
|
||||
|
||||
if(!this.loadChildrenOnOpen){
|
||||
this._loadChildren();
|
||||
}else{
|
||||
this._pseudoLoadChildren(items);
|
||||
}
|
||||
this._fetchedWith = opts;
|
||||
this._lastValueReported = this.multiple ? [] : null;
|
||||
this._onChangeActive = true;
|
||||
this.onSetStore();
|
||||
this._handleOnChange(this.value);
|
||||
},
|
||||
scope: this
|
||||
}));
|
||||
}else{
|
||||
delete this._fetchedWith;
|
||||
}
|
||||
return oStore; // dojo.data.api.Identity
|
||||
},
|
||||
|
||||
// TODO: implement set() and watch() for store and query, although not sure how to handle
|
||||
// setting them individually rather than together (as in setStore() above)
|
||||
|
||||
_setValueAttr: function(/*anything*/ newValue, /*Boolean?*/ priorityChange){
|
||||
// summary:
|
||||
// set the value of the widget.
|
||||
// If a string is passed, then we set our value from looking it up.
|
||||
if(this._loadingStore){
|
||||
// Our store is loading - so save our value, and we'll set it when
|
||||
// we're done
|
||||
this._pendingValue = newValue;
|
||||
return;
|
||||
}
|
||||
var opts = this.getOptions() || [];
|
||||
if(!lang.isArray(newValue)){
|
||||
newValue = [newValue];
|
||||
}
|
||||
array.forEach(newValue, function(i, idx){
|
||||
if(!lang.isObject(i)){
|
||||
i = i + "";
|
||||
}
|
||||
if(typeof i === "string"){
|
||||
newValue[idx] = array.filter(opts, function(node){
|
||||
return node.value === i;
|
||||
})[0] || {value: "", label: ""};
|
||||
}
|
||||
}, this);
|
||||
|
||||
// Make sure some sane default is set
|
||||
newValue = array.filter(newValue, function(i){ return i && i.value; });
|
||||
if(!this.multiple && (!newValue[0] || !newValue[0].value) && opts.length){
|
||||
newValue[0] = opts[0];
|
||||
}
|
||||
array.forEach(opts, function(i){
|
||||
i.selected = array.some(newValue, function(v){ return v.value === i.value; });
|
||||
});
|
||||
var val = array.map(newValue, function(i){ return i.value; }),
|
||||
disp = array.map(newValue, function(i){ return i.label; });
|
||||
|
||||
this._set("value", this.multiple ? val : val[0]);
|
||||
this._setDisplay(this.multiple ? disp : disp[0]);
|
||||
this._updateSelection();
|
||||
this._handleOnChange(this.value, priorityChange);
|
||||
},
|
||||
|
||||
_getDisplayedValueAttr: function(){
|
||||
// summary:
|
||||
// returns the displayed value of the widget
|
||||
var val = this.get("value");
|
||||
if(!lang.isArray(val)){
|
||||
val = [val];
|
||||
}
|
||||
var ret = array.map(this.getOptions(val), function(v){
|
||||
if(v && "label" in v){
|
||||
return v.label;
|
||||
}else if(v){
|
||||
return v.value;
|
||||
}
|
||||
return null;
|
||||
}, this);
|
||||
return this.multiple ? ret : ret[0];
|
||||
},
|
||||
|
||||
_loadChildren: function(){
|
||||
// summary:
|
||||
// Loads the children represented by this widget's options.
|
||||
// reset the menu to make it populatable on the next click
|
||||
if(this._loadingStore){ return; }
|
||||
array.forEach(this._getChildren(), function(child){
|
||||
child.destroyRecursive();
|
||||
});
|
||||
// Add each menu item
|
||||
array.forEach(this.options, this._addOptionItem, this);
|
||||
|
||||
// Update states
|
||||
this._updateSelection();
|
||||
},
|
||||
|
||||
_updateSelection: function(){
|
||||
// summary:
|
||||
// Sets the "selected" class on the item for styling purposes
|
||||
this._set("value", this._getValueFromOpts());
|
||||
var val = this.value;
|
||||
if(!lang.isArray(val)){
|
||||
val = [val];
|
||||
}
|
||||
if(val && val[0]){
|
||||
array.forEach(this._getChildren(), function(child){
|
||||
var isSelected = array.some(val, function(v){
|
||||
return child.option && (v === child.option.value);
|
||||
});
|
||||
domClass.toggle(child.domNode, this.baseClass + "SelectedOption", isSelected);
|
||||
child.domNode.setAttribute("aria-selected", isSelected);
|
||||
}, this);
|
||||
}
|
||||
},
|
||||
|
||||
_getValueFromOpts: function(){
|
||||
// summary:
|
||||
// Returns the value of the widget by reading the options for
|
||||
// the selected flag
|
||||
var opts = this.getOptions() || [];
|
||||
if(!this.multiple && opts.length){
|
||||
// Mirror what a select does - choose the first one
|
||||
var opt = array.filter(opts, function(i){
|
||||
return i.selected;
|
||||
})[0];
|
||||
if(opt && opt.value){
|
||||
return opt.value
|
||||
}else{
|
||||
opts[0].selected = true;
|
||||
return opts[0].value;
|
||||
}
|
||||
}else if(this.multiple){
|
||||
// Set value to be the sum of all selected
|
||||
return array.map(array.filter(opts, function(i){
|
||||
return i.selected;
|
||||
}), function(i){
|
||||
return i.value;
|
||||
}) || [];
|
||||
}
|
||||
return "";
|
||||
},
|
||||
|
||||
// Internal functions to call when we have store notifications come in
|
||||
_onNewItem: function(/*item*/ item, /*Object?*/ parentInfo){
|
||||
if(!parentInfo || !parentInfo.parent){
|
||||
// Only add it if we are top-level
|
||||
this._addOptionForItem(item);
|
||||
}
|
||||
},
|
||||
_onDeleteItem: function(/*item*/ item){
|
||||
var store = this.store;
|
||||
this.removeOption(store.getIdentity(item));
|
||||
},
|
||||
_onSetItem: function(/*item*/ item){
|
||||
this.updateOption(this._getOptionObjForItem(item));
|
||||
},
|
||||
|
||||
_getOptionObjForItem: function(item){
|
||||
// summary:
|
||||
// Returns an option object based off the given item. The "value"
|
||||
// of the option item will be the identity of the item, the "label"
|
||||
// of the option will be the label of the item. If the item contains
|
||||
// children, the children value of the item will be set
|
||||
var store = this.store, label = store.getLabel(item),
|
||||
value = (label ? store.getIdentity(item) : null);
|
||||
return {value: value, label: label, item:item}; // dijit.form.__SelectOption
|
||||
},
|
||||
|
||||
_addOptionForItem: function(/*item*/ item){
|
||||
// summary:
|
||||
// Creates (and adds) the option for the given item
|
||||
var store = this.store;
|
||||
if(!store.isItemLoaded(item)){
|
||||
// We are not loaded - so let's load it and add later
|
||||
store.loadItem({item: item, onItem: function(i){
|
||||
this._addOptionForItem(i);
|
||||
},
|
||||
scope: this});
|
||||
return;
|
||||
}
|
||||
var newOpt = this._getOptionObjForItem(item);
|
||||
this.addOption(newOpt);
|
||||
},
|
||||
|
||||
constructor: function(/*Object*/ keywordArgs){
|
||||
// summary:
|
||||
// Saves off our value, if we have an initial one set so we
|
||||
// can use it if we have a store as well (see startup())
|
||||
this._oValue = (keywordArgs || {}).value || null;
|
||||
this._notifyConnections = [];
|
||||
},
|
||||
|
||||
buildRendering: function(){
|
||||
this.inherited(arguments);
|
||||
dom.setSelectable(this.focusNode, false);
|
||||
},
|
||||
|
||||
_fillContent: function(){
|
||||
// summary:
|
||||
// Loads our options and sets up our dropdown correctly. We
|
||||
// don't want any content, so we don't call any inherit chain
|
||||
// function.
|
||||
var opts = this.options;
|
||||
if(!opts){
|
||||
opts = this.options = this.srcNodeRef ? query("> *",
|
||||
this.srcNodeRef).map(function(node){
|
||||
if(node.getAttribute("type") === "separator"){
|
||||
return { value: "", label: "", selected: false, disabled: false };
|
||||
}
|
||||
return {
|
||||
value: (node.getAttribute("data-" + kernel._scopeName + "-value") || node.getAttribute("value")),
|
||||
label: String(node.innerHTML),
|
||||
// FIXME: disabled and selected are not valid on complex markup children (which is why we're
|
||||
// looking for data-dojo-value above. perhaps we should data-dojo-props="" this whole thing?)
|
||||
// decide before 1.6
|
||||
selected: node.getAttribute("selected") || false,
|
||||
disabled: node.getAttribute("disabled") || false
|
||||
};
|
||||
}, this) : [];
|
||||
}
|
||||
if(!this.value){
|
||||
this._set("value", this._getValueFromOpts());
|
||||
}else if(this.multiple && typeof this.value == "string"){
|
||||
this._set("value", this.value.split(","));
|
||||
}
|
||||
},
|
||||
|
||||
postCreate: function(){
|
||||
// summary:
|
||||
// sets up our event handling that we need for functioning
|
||||
// as a select
|
||||
this.inherited(arguments);
|
||||
|
||||
// Make our event connections for updating state
|
||||
this.connect(this, "onChange", "_updateSelection");
|
||||
this.connect(this, "startup", "_loadChildren");
|
||||
|
||||
this._setValueAttr(this.value, null);
|
||||
},
|
||||
|
||||
startup: function(){
|
||||
// summary:
|
||||
// Connects in our store, if we have one defined
|
||||
this.inherited(arguments);
|
||||
var store = this.store, fetchArgs = {};
|
||||
array.forEach(["query", "queryOptions", "onFetch"], function(i){
|
||||
if(this[i]){
|
||||
fetchArgs[i] = this[i];
|
||||
}
|
||||
delete this[i];
|
||||
}, this);
|
||||
if(store && store.getFeatures()["dojo.data.api.Identity"]){
|
||||
// Temporarily set our store to null so that it will get set
|
||||
// and connected appropriately
|
||||
this.store = null;
|
||||
this.setStore(store, this._oValue, fetchArgs);
|
||||
}
|
||||
},
|
||||
|
||||
destroy: function(){
|
||||
// summary:
|
||||
// Clean up our connections
|
||||
var h;
|
||||
while(h = this._notifyConnections.pop()){ h.remove(); }
|
||||
this.inherited(arguments);
|
||||
},
|
||||
|
||||
_addOptionItem: function(/*dijit.form.__SelectOption*/ /*===== option =====*/){
|
||||
// summary:
|
||||
// User-overridable function which, for the given option, adds an
|
||||
// item to the select. If the option doesn't have a value, then a
|
||||
// separator is added in that place. Make sure to store the option
|
||||
// in the created option widget.
|
||||
},
|
||||
|
||||
_removeOptionItem: function(/*dijit.form.__SelectOption*/ /*===== option =====*/){
|
||||
// summary:
|
||||
// User-overridable function which, for the given option, removes
|
||||
// its item from the select.
|
||||
},
|
||||
|
||||
_setDisplay: function(/*String or String[]*/ /*===== newDisplay =====*/){
|
||||
// summary:
|
||||
// Overridable function which will set the display for the
|
||||
// widget. newDisplay is either a string (in the case of
|
||||
// single selects) or array of strings (in the case of multi-selects)
|
||||
},
|
||||
|
||||
_getChildren: function(){
|
||||
// summary:
|
||||
// Overridable function to return the children that this widget contains.
|
||||
return [];
|
||||
},
|
||||
|
||||
_getSelectedOptionsAttr: function(){
|
||||
// summary:
|
||||
// hooks into this.attr to provide a mechanism for getting the
|
||||
// option items for the current value of the widget.
|
||||
return this.getOptions(this.get("value"));
|
||||
},
|
||||
|
||||
_pseudoLoadChildren: function(/*item[]*/ /*===== items =====*/){
|
||||
// summary:
|
||||
// a function that will "fake" loading children, if needed, and
|
||||
// if we have set to not load children until the widget opens.
|
||||
// items:
|
||||
// An array of items that will be loaded, when needed
|
||||
},
|
||||
|
||||
onSetStore: function(){
|
||||
// summary:
|
||||
// a function that can be connected to in order to receive a
|
||||
// notification that the store has finished loading and all options
|
||||
// from that store are available
|
||||
}
|
||||
});
|
||||
|
||||
});
|
||||
Reference in New Issue
Block a user