The ui extension extends ui base with service and convenience functions for
ui frame work as well application
ui extension is currently required by:
uiRad - Radio button ui element
uiKb3x10B - Soft / touch keyboard / keypad
uiEBC - extension for button controlled ui
--- Brief documentation of the methods / functions available
.ff(a,f,s,_) - find and return first element in array a starting
with start index s (if absent, s=0 assumed) that makes function f(element, _auxiliaryVar) return truey; if not found,
return undefined . Argument _ (_auxiliaryVar) is also
passed to the function and can be any value the application needs. If
application has no use for it, it is just left away in the call and
function.
.fx(a,f,s,_)- find and return index of first element in array a
that makes function f(element) return truey; if not found,
return -1. Argument _ (_auxiliaryVar) is also
passed to the function and can be any value the application needs. If
application has no use for it, it is just left away in the call and
function.
.e(iie) - return ui element by idx, id or elt. If by id and not found,
undefined is returned.
.g(iie) - get element value (obj) - runtime e[9] - by idx, id or elt.
.u(iie,p) - update value object by element idx or id with or without
propagation (calling callback). Be aware how the value (object) is
defined creation of the ui element.
.t(iie,ud) - tap on ui element by idx or id or ui element. If element is
found, x and y coordinates of center are passed to ui and processing
happens as if the element would be touched on a touch screen and then
un-touched - with the default or overwritten untouch delay .ud.
Providing proper un-touch delays yields full control over touch-time
sensitive ui elements, such as key board keys, where, for example,
long touch of keys with numbers in uiKbc3x10B module will return
the number character instead of the alpha character.
.cb(iie) and .cb(iie,cb,ca) - getter and setter of callback; getter is
with both cb and ca being undefined by value or absence of value.
--- ext - ui extension properties - variables and methods - mixed into ui base
exports = // ui (generic) ext(ension/utils: vertices(circle,...) find elt/idx in arr,...)
{ mn: "uiExt" // module 'clazz' name - globally unique (used to remove code from cache)
, ud: 100 // default tap duration defined as u-ntouch d-elay / timeout
, cg1: [2,-5,4,-4,5,-2,6,0,5,2,4,4,2,5,0,6,-2,5,-4,4,-5,2,-6,0,-5,-2,-4,-4,-2,-5]
// ....
// ... public methods - documented above
// ... private methods
// ...
}
Attached shot: shows the browser developer / debug view with the browser console log, to which the ui framework is logging to by injected functions.
Espruino is a JavaScript interpreter for low-power Microcontrollers. This site is both a support community for Espruino and a place to share what you are working on.
----- uiExt ------------------------- 20190927
The
ui extension
extends ui base with service and convenience functions forui frame work as well application
ui extension is currently required by:
--- Brief documentation of the methods / functions available
.ff(a,f,s,_)
- find and return first element in arraya
startingwith start index
s
(if absent, s=0 assumed) that makes functionf(element, _auxiliaryVar)
return truey; if not found,return
undefined
. Argument_
(_auxiliaryVar) is alsopassed to the function and can be any value the application needs. If
application has no use for it, it is just left away in the call and
function.
.fx(a,f,s,_)
- find and return index of first element in arraya
that makes function
f(element)
return truey; if not found,return
-1
. Argument_
(_auxiliaryVar) is alsopassed to the function and can be any value the application needs. If
application has no use for it, it is just left away in the call and
function.
.e(iie)
- return ui element by idx, id or elt. If by id and not found,undefined is returned.
.g(iie)
- get element value (obj) - runtime e[9] - by idx, id or elt..u(iie,p)
- update value object by element idx or id with or withoutpropagation (calling callback). Be aware how the value (object) is
defined creation of the ui element.
.t(iie,ud)
- tap on ui element by idx or id or ui element. If element isfound, x and y coordinates of center are passed to ui and processing
happens as if the element would be touched on a touch screen and then
un-touched - with the default or overwritten untouch delay
.ud
.Providing proper un-touch delays yields full control over touch-time
sensitive ui elements, such as key board keys, where, for example,
long touch of keys with numbers in
uiKbc3x10B
module will returnthe number character instead of the alpha character.
.cb(iie)
and.cb(iie,cb,ca)
- getter and setter of callback; getter iswith both cb and ca being undefined by value or absence of value.
--- ext - ui extension properties - variables and methods - mixed into ui base
Attached shot: shows the browser developer / debug view with the browser console log, to which the ui framework is logging to by injected functions.
1 Attachment