Difuse/luci
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

luci-base: form.js: add cfgvalue(), formvalue() and getUIElement() helpers

Browse source 
This commit introduces new per-section cfgvalue(), formvalue() and
getUIElement() helper functions which complement the respective per-option
functions.

Their intent is to simplify querying input data or obtaining UI widget
instances from other options within the same section.

Signed-off-by: Jo-Philipp Wich <jo@mein.io>
This commit is contained in:
Jo-Philipp Wich 2020-08-03 15:56:51 +02:00
parent 2d774c4973
commit b8d381b677
1 changed files with 102 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

102
modules/luci-base/htdocs/luci-static/resources/form.js
View file

@ -1054,6 +1054,108 @@ var CBIAbstractSection = CBIAbstractElement.extend(/** @lends LuCI.form.Abstract
return obj;
},
/**
* Query underlying option configuration values.
*
* This function is sensitive to the amount of arguments passed to it;
* if only one argument is specified, the configuration values of all
* options within this section are returned as dictionary.
*
* If both the section ID and an option name are supplied, this function
* returns the configuration value of the specified option only.
*
* @param {string} section_id
* The configuration section ID
*
* @param {string} [option]
* The name of the option to query
*
* @returns {null|string|string[]|Object<string, null|string|string[]>}
* Returns either a dictionary of option names and their corresponding
* configuration values or just a single configuration value, depending
* on the amount of passed arguments.
*/
cfgvalue: function(section_id, option) {
var rv = (arguments.length == 1) ? {} : null;
for (var i = 0, o; (o = this.children[i]) != null; i++)
if (rv)
rv[o.option] = o.cfgvalue(section_id);
else if (o.option == option)
return o.cfgvalue(section_id);
return rv;
},
/**
* Query underlying option widget input values.
*
* This function is sensitive to the amount of arguments passed to it;
* if only one argument is specified, the widget input values of all
* options within this section are returned as dictionary.
*
* If both the section ID and an option name are supplied, this function
* returns the widget input value of the specified option only.
*
* @param {string} section_id
* The configuration section ID
*
* @param {string} [option]
* The name of the option to query
*
* @returns {null|string|string[]|Object<string, null|string|string[]>}
* Returns either a dictionary of option names and their corresponding
* widget input values or just a single widget input value, depending
* on the amount of passed arguments.
*/
formvalue: function(section_id, option) {
var rv = (arguments.length == 1) ? {} : null;
for (var i = 0, o; (o = this.children[i]) != null; i++) {
var func = this.map.root ? this.children[i].formvalue : this.children[i].cfgvalue;
if (rv)
rv[o.option] = func.call(o, section_id);
else if (o.option == option)
return func.call(o, section_id);
}
return rv;
},
/**
* Obtain underlying option LuCI.ui widget instances.
*
* This function is sensitive to the amount of arguments passed to it;
* if only one argument is specified, the LuCI.ui widget instances of all
* options within this section are returned as dictionary.
*
* If both the section ID and an option name are supplied, this function
* returns the LuCI.ui widget instance value of the specified option only.
*
* @param {string} section_id
* The configuration section ID
*
* @param {string} [option]
* The name of the option to query
*
* @returns {null|LuCI.ui.AbstractElement|Object<string, null|LuCI.ui.AbstractElement>}
* Returns either a dictionary of option names and their corresponding
* widget input values or just a single widget input value, depending
* on the amount of passed arguments.
*/
getUIElement: function(section_id, option) {
var rv = (arguments.length == 1) ? {} : null;
for (var i = 0, o; (o = this.children[i]) != null; i++)
if (rv)
rv[o.option] = o.getUIElement(section_id);
else if (o.option == option)
return o.getUIElement(section_id);
return rv;
},
/** @private */
renderUCISection: function(section_id) {
var renderTasks = [];