Source: panels/keyboard/installed_keyboards.js

  1. /**
  2.  * The module initializes a ListView displaying the installed keyboards.
  3.  * Implementation details please refer to {@link KeyboardCore}.
  4.  *
  5.  * @module keyboard/installed_keyboards
  6.  */
  7. define(function(require) {
  8.   'use strict';
  10.   var ListView = require('modules/mvvm/list_view');
  12.   /**
  13.    * @alias module:keyboard/installed_keyboards
  14.    * @class KeyboardCore
  15.    * @requires module:modules/mvvm/list_view
  16.    * @param {KeyboardContext} context
  17.                               The kyboard context providing installed keyboards.
  18.    * @param {Function} template
  19.                        The template function used to render an installed
  20.                        keyboard.
  21.    * @returns {KeyboardCore}
  22.    */
  23.   function KeyboardCore(context, template) {
  24.     this._enabled = false;
  25.     this._listView = null;
  26.     this._keyboardContext = context;
  27.     this._keyboardTemplate = template;
  28.   }
  30.   KeyboardCore.prototype = {
  31.     /**
  32.      * The value indicates whether the module is responding. If it is false, the
  33.      * UI stops reflecting the updates from the keyboard context.
  34.      *
  35.      * @access public
  36.      * @memberOf KeyboardCore.prototype
  37.      * @type {Boolean}
  38.      */
  39.     get enabled() {
  40.       return this._enabled;
  41.     },
  43.     set enabled(value) {
  44.       this._enabled = value;
  45.       if (this._listView) {
  46.         this._listView.enabled = this._enabled;
  47.       }
  48.     },
  50.     /**
  51.      * @access private
  52.      * @memberOf KeyboardCore.prototype
  53.      * @param {HTMLElement} listViewRoot
  54.      * @param {ObservableArray} keyboards
  55.      * @param {Function} keyboardTemplate
  56.      */
  57.     _initAllKeyboardListView:
  58.       function k_initListView(listViewRoot, keyboards, keyboardTemplate) {
  59.         listViewRoot.hidden = (keyboards.length === 0);
  60.         this._listView = ListView(listViewRoot, keyboards, keyboardTemplate);
  61.     },
  63.     /**
  64.      * @access public
  65.      * @memberOf KeyboardCore.prototype
  66.      * @param {Array} elements
  67.      *                Elements needed by this module.
  68.      * @param {HTMLElement} elements.listViewRoot
  69.      *                      The root element for the list view displaying the
  70.      *                      installed keyboards.
  71.      */
  72.     init: function k_init(elements) {
  73.       var that = this;
  74.       this._keyboardContext.init(function() {
  75.         that._keyboardContext.keyboards(function(keyboards) {
  76.           that._initAllKeyboardListView(
  77.             elements.listViewRoot, keyboards, that._keyboardTemplate);
  78.           that.enabled = true;
  79.         });
  80.       });
  81.     }
  82.   };
  84.   return function ctor_keyboardCore(context, template) {
  85.     return new KeyboardCore(context, template);
  86.   };
  87. });