• ----- uiExt ------------------------- 20190927

    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.


    1 Attachment

    • uiXDEdebugExample.png
About

Avatar for allObjects @allObjects started