10813693526

Committed 11 Sep 2024 02:24PM UTC coverage: 62.272% (-0.03%) from 62.305%

Build # 10813693526

Build Type

push

github

Committed by

jclo

Commit Message

Fixed regex on $init, $listenDOM, etc. that failed on minified library.

Run Details

115 of 115 branches covered (100.0%)

Branch coverage included in aggregate %.

6 of 6 new or added lines in 1 file covered. (100.0%)

1 existing line in 1 file now uncovered.

2483 of 4057 relevant lines covered (61.2%)

0.62 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

78.23

/src/component/generic.js

/** ************************************************************************
 *
 * Defines the generic component. All the created components extend this
 * component.
 *
 * generic.js is built upon the Prototypal Instantiation pattern. It
 * returns an object by calling its constructor. It doesn't use the new
 * keyword.
 *
 * Private Functions:
 *  . none,
 *
 *
 * Constructor:
 *  . Construct                   constructor,
 *
 *
 * Private Variables
 *  . _tag                        constains the tag string of the component,
 *  . _cList                      contains the list of children objects,
 *  . _mess                       the messenger object,
 *
 * Private Methods:
 *  . _intInit                    checks if it needs to use $init or init method,
 *  . _intEvents                  applies the deprecated events method,
 *  . _intListen                  checks if it needs to use $listenDOM or listen method,
 *  . _intPostRender              checks if it needs to use $postRender or postRender method,
 *  . _intOnChange                checks if it needs to use $onChange or onChange method,
 *  . _intRender                  checks if it needs to use $render or render method,
 *  . _init                       executes the private init when the comp. is created,
 *  . _renderer                   renders the component an its children, return XML,
 *  . _render                     returns data returned by the public method render,
 *
 *
 * Public Variables:
 *  . id                          unique id of the component (read only),
 *  . children                    list of the children components,
 *  . state                       component state properties,
 *  . props                       component properties,
 *  . name                        name of the component,
 *
 *
 * Public Methods:
 *  . $                           returns an object to manipulate the comp. in the DOM,
 *  . $animate                    animates the component,
 *  . $abortAnimation             aborts the running animation,
 *  . $append                     appends a component as the last child,
 *  . $getChild                   returns a component object,
 *  . $removeChild                removes a child,
 *  . $getChildren                returns the list of the children,
 *  . $getIdAndName               returns the component's Id and name,
 *  . $hyperscript                returns an XML string of the hyperscript template,
 *  . $setState                   updates state value(s),
 *  . $listen                     listens a message,
 *  . $emit                       sends a message,
 *
 *
 * Empty Public Methods:
 *  . $init                       executes the public initializations,
 *  . events                      processes the DOM events (to be phased out),
 *  . $listenDOM                  listens for DOM events,
 *  . $postRender                 performs operations after component added to DOM,
 *  . $onChange                   performs operations after component updated in DOM,
 *  . $render                     returns the component XML string,
 *
 *
 *
 * @namespace    -
 * @dependencies none
 * @exports      -
 * @author       -
 * @since        0.0.0
 * @version      -
 * ********************************************************************** */
/* global */
/* eslint-disable one-var, semi-style, no-underscore-dangle */


// -- Vendor Modules
import KZlog from '@mobilabs/kzlog';


// -- Local Modules
import _ from '../lib/_';
import A from './animate';
import AD from './add';
import R from './render';
import H from './hyperscript';
import S from './setstate';
import Util from './util';
import C from './config';


// -- Local Constants
const { level } = C.logger
    , log       = KZlog('RView', level, false)
    ;


// -- Local Variables


// -- Public ---------------------------------------------------------------

/**
 * Defines the Generic Component constructor.
 *
 * @constructor (...args)
 * @public
 * @param {}                -,
 * @returns {}              -,
 * @since 0.0.0
 */
function Construct() {
  /* eslint-disable-next-line prefer-spread, prefer-rest-params */
  this._init.apply(this, arguments);
}


const methods = {


  // -- Private Methods ----------------------------------------------------

  /**
   * Checks if it needs to use $init or the deprecated init method.
   *
   * @method ()
   * @private
   * @param {}              -,
   * @returns {}            -,
   * @since 0.0.0
   */
  _intInit() {
    if (!/^init\(\)\s*\{\}/.test(this.init.toString())) {
      log.warn('init method is deprecated, use $init instead!');
      this.init();
      return;
    }
    this.$init();
  },

  /**
   * Applies the deprecated events method.
   *
   * @method ()
   * @private
   * @param {}              -,
   * @returns {}            -,
   * @since 0.0.0
   */
  _intEvents() {
    if (!/^events\(\)\s*\{\}/.test(this.events.toString())) {
      log.warn('events method is deprecated, use $listenDOM or $postRender instead!');
      this.events();
    }
  },

  /**
   * Checks if it needs to use $listenDOM or the deprecated listen method.
   *
   * @method ()
   * @private
   * @param {}              -,
   * @returns {}            -,
   * @since 0.0.0
   */
  _intListen() {
    if (!/^listen\(\)\s*\{\}/.test(this.listen.toString())) {
      log.warn('listen method is deprecated, use $listenDOM instead!');
      this.listen();
      return;
    }
    this.$listenDOM();
  },

  /**
   * Checks if it needs to use $postRender or the deprecated postRender method.
   *
   * @method ()
   * @private
   * @param {}              -,
   * @returns {}            -,
   * @since 0.0.0
   */
  _intPostRender() {
    if (!/^postRender\(\)\s*\{\}/.test(this.postRender.toString())) {
      log.warn('postRender method is deprecated, use $postRender instead!');
      this.postRender();
      return;
    }
    this.$postRender();
  },

  /**
   * Checks if it needs to use $onChange or the deprecated onChange method.
   *
   * @method ()
   * @private
   * @param {}              -,
   * @returns {}            -,
   * @since 0.0.0
   */
  _intOnChange() {
    if (!/^onChange\(\)\s*\{\}/.test(this.onChange.toString())) {
      log.warn('onChange method is deprecated, use $onChange instead!');
      this.onChange();
      return;
    }
    this.$onChange();
  },

  /**
   * Checks if it needs to use $onChange or the deprecated onChange method.
   *
   * @method (...args)
   * @private
   * @param {...}           the arguments,
   * @returns {XMLString}   returns the rendered data,
   * @since 0.0.0
   */
  _intRender(...args) {
    if (!/^render\(\)\s*\{\}/.test(this.render.toString())) {
      log.warn('render method is deprecated, use $render instead!');
      return this.render(...args);
    }
    return this.$render(...args);
  },

  /**
   * Does the initializations when the component is created.
   *
   * @method (arg1)
   * @private
   * @param {Object}        the options,
   * @returns {Object}      returns this,
   * @since 0.0.0
   */
  _init(...args) {
    // init private:
    this._tag = null;
    this._cList = null;
    this._mess = null;

    // init public:
    // Creates an unique id for this component:
    // this.id = `i${Math.random().toString(36).substr(2, 7)}`;
    this.id = _.makeid(C.idLength);
    this.children = null;

    const [state, props] = args;
    this.state = _.isLiteralObject(state) ? state : {};
    this.props = _.isLiteralObject(props) ? props : {};
    this.name = 'mynameisnobody';

    // Call the public init:
    this._intInit();
    return this;
  },

  /**
   * Renders the component and returns its XMLString.
   * (must not be overwritten)
   *
   * @method ()
   * @public
   * @param {}              -,
   * @returns {XMLString}   returns the component's XMLString,
   * @since 0.0.0
   */
  _renderer() {
    return R.render(this);
  },

  /**
   * Returns data returned by the public method render.
   * (must not be overwritten)
   *
   * @method ([arg1], [arg2])
   * @public
   * @param {Object}        the state properties,
   * @param {Object}        the optional properties,
   * @returns {XMLString}   returns the component's XMLString,
   * @since 0.0.0
   */
  _render(...args) {
    /*
    xml = xml.replace(/<!--(.*?)-->/g, '')    // remove comments
      .replace(/\n\s+</g, '\n<')              // remove leading spaces before a tag,
      .replace(/\n<\/div>/g, '</div>')        // remove unwanted `\n`,
      .replace(/\n<\/ul>/g, '</ul>')          // -
      .replace(/\n<\/li>/g, '</li>')          // -
      .replace(/\n<\/a>/g, '</a>')            // -
    ;
    */
    const xml = this._intRender(...args);
    if (_.isString(xml)) {
      return xml.trim();
    }
    return xml;
  },


  // -- Defined Public Methods ---------------------------------------------

  /**
   * Returns an object to manipulate the component in the DOM.
   * (must not be overwritten - see implementation in $.js)
   *
   * Nota: $ is filled when the View.Component is created
   * (see main.js constructor).
   *
   * @method (arg1)
   * @public
   * @param {String}        the node selector (id or class),
   * @returns {Object}      returns the $ object,
   * @since 0.0.0
   */
  $: null,

  /**
   * Animates the component.
   * (must not be overwritten)
   *
   * @method (...args)
   * @public
   * @param {...args}       properties [, duration ] [, easing ] [, callback ],
   * @returns {Object}      returns this,
   * @since 0.0.0
   */
  $animate(...args) {
    [this._anim_timer, this._anim_callback] = A.animate(this, ...args);
    return this;
  },

  /**
   * Aborts the running animation.
   * (must not be overwritten)
   *
   * @method ()
   * @public
   * @param {}              -,
   * @returns {Object}      returns this,
   * @since 0.0.0
   */
  $abortAnimation() {
    A.abortAnimation(this._anim_timer, this._anim_callback);
    return this;
  },

  /**
   * Appends a component as the last child to the selected component.
   * (must not be overwritten)
   *
   * @method (...args)
   * @public
   * @param {...args}       tag, component, [state], [props]
   * @returns {Object}      returns this,
   * @since 0.0.0
   */
  $append(...args) {
    AD.append(this, ...args);
    return this;
  },

  /**
   * Returns a component object.
   * (must not be overwritten)
   *
   * Nota:
   * the algorithm tests 'ident' in this order: tag, id, name. It
   * explores by parsing entirely the first child branch before parsing the
   * second child branch. I stops as soon as there is a match.
   *
   * So, if a child in the second child branch as the same tag or name as a
   * child in the first child branch, the algorithm returns the child in the
   * first branch only. The matching child on the second branch won't never be
   * retrieved.
   *
   * So, avoid duplicating tag or name.
   *
   * @method (arg1)
   * @public
   * @param {String}        the component identity (could be tag, id or name),
   * @returns {Object}      returns the component object or null,
   * @since 0.0.0
   */
  $getChild(ident) {
    return Util.getChild(this, ident);
  },

  /**
   * Remove a component's child.
   * (must not be overwritten)
   *
   * @method (arg1)
   * @public
   * @param {String}        the component identity (could be tag, id or name),
   * @returns {Boolean}     returns true or false,
   * @since 0.0.0
   */
  $removeChild(ident) {
    return Util.removeChild(this, ident);
  },

  /**
   * Returns the list of children.
   * (must not be overwritten)
   *
   * @method ()
   * @public
   * @param {}              -,
   * @returns {Array}       returns the children list or null,
   * @since 0.0.0
   */
  $getChildren() {
    return Util.getChildren(this);
  },

  /**
   * Returns the component's Id and name.
   * (must not be overwritten)
   *
   * @method ()
   * @public
   * @param {}              -,
   * @returns {Object}      returns the component's id and name,
   * @since 0.0.0
   */
  $getIdAndName() {
    return { id: this.id, name: this.name };
  },

  /**
   * Returns an XMLString representation of the hyperscript template.
   * (must not be overwritten)
   *
   * @method (...args)
   * @public
   * @param {...}           arguments like { tag, attributes, value },
   * @returns {Object}      returns an object containing the node, its attributes
   * @since 0.0.0           and the children,
   */
  $hyperscript(...args) {
    return H.format(...args);
  },

  /**
   * Updates state value(s).
   * (must not be overwritten)
   *
   * @method (arg1)
   * @public
   * @param {Object}        the state object,
   * @returns {Object}      returns this,
   * @since 0.0.0
   */
  $setState(params) {
    if (_.isLiteralObject(params)) {
      S.setState(this, params);
    }
    return this;
  },

  /**
   * Listens for a message from another component.
   * (must not be overwritten)
   *
   * @method (arg1, arg2)
   * @public
   * @param {String}        the event to listen,
   * @param {Function}      the listener to attach to this event,
   * @returns {Object}      returns this,
   * @since 0.0.0
   */
  $listen(event, listener) {
    if (this._mess) {
      this._mess.subscribe(event, listener);
      return this;
    }
    /* eslint-disable-next-line no-console */
    console.log('$listen: the plugin Messenger is not installed!');
    return this;
  },

  /**
   * sends for a message to another component.
   * (must not be overwritten)
   *
   * @method (arg1, arg2)
   * @public
   * @param {String}        the event to listen,
   * @param {Object}        the payload to send,
   * @returns {Object}      returns this,
   * @since 0.0.0
   */
  $emit(event, payload) {
    if (this._mess) {
      this._mess.publish(event, payload);
      return this;
    }
    /* eslint-disable-next-line no-console */
    console.log('$emit: the plugin Messenger is not installed!');
    return this;
  },


  // -- Empty Public Methods -----------------------------------------------

  /**
   * Does the initializations when the component is created.
   * (could be overwritten)
   *
   * Nota:
   * 'props.options' are initialized when the component is instantiated. Be
   * careful not to overwrite it.
   *
   * @method ()
   * @public
   * @param {}              -,
   * @returns {Object}      returns this,
   * @since 0.0.0
   */
  init() {},
  $init() {
    return this;
  },

  /**
   * Processes the DOM events.
   * (could be overwritten)
   *
   * @method ()
   * @public
   * @param {}              -,
   * @returns {Object}      returns this,
   * @since 0.0.0
   */
  events() {},

  /**
   * Listens for DOM events.
   * (could be overwritten)
   *
   * Nota:
   * This method is called after the component
   * has been attached to the DOM. It must be used
   * to listen to the DOM events generated by the component.
   *
   * @method ()
   * @public
   * @param {}              -,
   * @returns {Object}      returns this,
   * @since 0.0.0
   */
  listen() {},
  $listenDOM() {
    return this;
  },

  /**
   * Performs operations after the component is added to the DOM.
   * (could be overwritten)
   *
   * Nota:
   * This method is called after the component
   * has been attached to the DOM. It must be used
   * to perform a post-rendering process.
   *
   * @method ()
   * @public
   * @param {}              -,
   * @returns {Object}      returns this,
   * @since 0.0.0
   */
  postRender() {},
  $postRender() {
    return this;
  },

  /**
   * Performs operations after the component in the DOM has been updated.
   * (could be overwritten)
   *
   * Nota:
   * This method is called after the component, already
   * in the DOM, is updated through a $setState. It must be used
   * to perform a post-rendering process after each update.
   *
   * @method ()
   * @public
   * @param {}              -,
   * @returns {Object}      returns this,
   * @since 0.0.0
   */
  onChange() {},
  $onChange() {
    return this;
  },

  /**
   * Returns an XMLString.
   * (could be overwritten)
   *
   * @method ()
   * @public
   * @param {}              -,
   * @returns {String}      returns XMLString,
   * @since 0.0.0
   */
  render() {},
  $render() {
    return '<div></div>';
  },
};


// -- Export
export default { Construct, methods };

/* eslint-enable one-var, semi-style, no-underscore-dangle */

1	/ **********************************************************************	1✔
2	*	1✔
3	* Defines the generic component. All the created components extend this	1✔
4	* component.	1✔
5	*	1✔
6	* generic.js is built upon the Prototypal Instantiation pattern. It	1✔
7	* returns an object by calling its constructor. It doesn't use the new	1✔
8	* keyword.	3✔
9	*	1✔
10	* Private Functions:	1✔
11	* . none,	1✔
12	*	1✔
13	*	1✔
14	* Constructor:	1✔
15	* . Construct constructor,	1✔
16	*	3✔
17	*	3✔
18	* Private Variables	1✔
19	* . _tag constains the tag string of the component,	1✔
20	* . _cList contains the list of children objects,	1✔
21	* . _mess the messenger object,	1✔
22	*	3✔
23	* Private Methods:	1✔
24	* . _intInit checks if it needs to use $init or init method,	1✔
25	* . _intEvents applies the deprecated events method,	1✔
26	* . _intListen checks if it needs to use $listenDOM or listen method,	1✔
27	* . _intPostRender checks if it needs to use $postRender or postRender method,	1✔
28	* . _intOnChange checks if it needs to use $onChange or onChange method,	1✔
29	* . _intRender checks if it needs to use $render or render method,	1✔
30	* . _init executes the private init when the comp. is created,	1✔
31	* . _renderer renders the component an its children, return XML,	1✔
32	* . _render returns data returned by the public method render,	1✔
33	*	1✔
34	*	1✔
35	* Public Variables:	1✔
36	* . id unique id of the component (read only),	1✔
37	* . children list of the children components,	1✔
38	* . state component state properties,	1✔
39	* . props component properties,	1✔
40	* . name name of the component,	1✔
41	*	1✔
42	*	1✔
43	* Public Methods:	1✔
44	* . $ returns an object to manipulate the comp. in the DOM,	1✔
45	* . $animate animates the component,	1✔
46	* . $abortAnimation aborts the running animation,	1✔
47	* . $append appends a component as the last child,	1✔
48	* . $getChild returns a component object,	1✔
49	* . $removeChild removes a child,	1✔
50	* . $getChildren returns the list of the children,	1✔
51	* . $getIdAndName returns the component's Id and name,	1✔
52	* . $hyperscript returns an XML string of the hyperscript template,	1✔
53	* . $setState updates state value(s),	1✔
54	* . $listen listens a message,	1✔
55	* . $emit sends a message,	1✔
56	*	1✔
57	*	1✔
58	* Empty Public Methods:	1✔
59	* . $init executes the public initializations,	1✔
60	* . events processes the DOM events (to be phased out),	1✔
61	* . $listenDOM listens for DOM events,	1✔
62	* . $postRender performs operations after component added to DOM,	1✔
63	* . $onChange performs operations after component updated in DOM,	1✔
64	* . $render returns the component XML string,	1✔
65	*	1✔
66	*	1✔
67	*	1✔
68	* @namespace -	1✔
69	* @dependencies none	1✔
70	* @exports -	1✔
71	* @author -	1✔
72	* @since 0.0.0	1✔
73	* @version -	1✔
74	* ********************************************************************** */	1✔
75	/* global */	1✔
76	/* eslint-disable one-var, semi-style, no-underscore-dangle */	1✔
77		1✔
78		1✔
79	// -- Vendor Modules	1✔
80	import KZlog from '@mobilabs/kzlog';	1✔
81		1✔
82		1✔
83	// -- Local Modules	1✔
84	import _ from '../lib/_';	1✔
85	import A from './animate';	1✔
86	import AD from './add';	1✔
87	import R from './render';	1✔
88	import H from './hyperscript';	1✔
89	import S from './setstate';	1✔
90	import Util from './util';	1✔
91	import C from './config';	1✔
92		1✔
93		1✔
94	// -- Local Constants	1✔
95	const { level } = C.logger	1✔
96	, log = KZlog('RView', level, false)	1✔
97	;	1✔
98		1✔
99		1✔
100	// -- Local Variables	1✔
101		1✔
102		1✔
103	// -- Public ---------------------------------------------------------------	1✔
104		1✔
105	/**	1✔
106	* Defines the Generic Component constructor.	1✔
107	*	1✔
108	* @constructor (...args)	1✔
109	* @public	1✔
110	* @param {} -,	1✔
111	* @returns {} -,	1✔
112	* @since 0.0.0	1✔
113	*/	1✔
114	function Construct() {	1✔
115	/* eslint-disable-next-line prefer-spread, prefer-rest-params */	1✔
116	this._init.apply(this, arguments);	1✔
117	}	1✔
118		1✔
119		1✔
120	const methods = {	1✔
121		1✔
122		1✔
123	// -- Private Methods ----------------------------------------------------	1✔
124		1✔
125	/**	1✔
126	* Checks if it needs to use $init or the deprecated init method.	1✔
127	*	1✔
128	* @method ()	1✔
129	* @private	1✔
130	* @param {} -,	1✔
131	* @returns {} -,	1✔
132	* @since 0.0.0	1✔
133	*/	1✔
134	_intInit() {	1✔
135	if (!/^init\(\)\s*\{\}/.test(this.init.toString())) {	1✔
136	log.warn('init method is deprecated, use $init instead!');	1✔
137	this.init();	×
138	return;	×
139	}	×
140	this.$init();	×
141	},	×
142		×
UNCOV 143	/**	×
144	* Applies the deprecated events method.	1✔
145	*	1✔
146	* @method ()	1✔
147	* @private	1✔
148	* @param {} -,	1✔
149	* @returns {} -,	1✔
150	* @since 0.0.0	1✔
151	*/	1✔
152	_intEvents() {	1✔
153	if (!/^events\(\)\s*\{\}/.test(this.events.toString())) {	1✔
154	log.warn('events method is deprecated, use $listenDOM or $postRender instead!');	1✔
155	this.events();	×
156	}	×
157	},	×
158		×
159	/**	×
160	* Checks if it needs to use $listenDOM or the deprecated listen method.	×
161	*	×
162	* @method ()	×
163	* @private	×
164	* @param {} -,	1✔
165	* @returns {} -,	1✔
166	* @since 0.0.0	1✔
167	*/	1✔
168	_intListen() {	1✔
169	if (!/^listen\(\)\s*\{\}/.test(this.listen.toString())) {	1✔
170	log.warn('listen method is deprecated, use $listenDOM instead!');	1✔
171	this.listen();	×
172	return;	×
173	}	×
174	this.$listenDOM();	×
175	},	×
176		×
177	/**	×
178	* Checks if it needs to use $postRender or the deprecated postRender method.	1✔
179	*	1✔
180	* @method ()	1✔
181	* @private	1✔
182	* @param {} -,	1✔
183	* @returns {} -,	1✔
184	* @since 0.0.0	1✔
185	*/	1✔
186	_intPostRender() {	1✔
187	if (!/^postRender\(\)\s*\{\}/.test(this.postRender.toString())) {	1✔
188	log.warn('postRender method is deprecated, use $postRender instead!');	×
189	this.postRender();	×
190	return;	×
191	}	×
192	this.$postRender();	×
193	},	×
194		×
195	/**	×
196	* Checks if it needs to use $onChange or the deprecated onChange method.	1✔
197	*	1✔
198	* @method ()	1✔
199	* @private	1✔
200	* @param {} -,	1✔
201	* @returns {} -,	1✔
202	* @since 0.0.0	1✔
203	*/	1✔
204	_intOnChange() {	1✔
205	if (!/^onChange\(\)\s*\{\}/.test(this.onChange.toString())) {	1✔
206	log.warn('onChange method is deprecated, use $onChange instead!');	×
207	this.onChange();	×
208	return;	×
209	}	×
210	this.$onChange();	×
211	},	×
212		×
213	/**	×
214	* Checks if it needs to use $onChange or the deprecated onChange method.	1✔
215	*	1✔
216	* @method (...args)	1✔
217	* @private	1✔
218	* @param {...} the arguments,	1✔
219	* @returns {XMLString} returns the rendered data,	1✔
220	* @since 0.0.0	1✔
221	*/	1✔
222	_intRender(...args) {	1✔
223	if (!/^render\(\)\s*\{\}/.test(this.render.toString())) {	1✔
224	log.warn('render method is deprecated, use $render instead!');	×
225	return this.render(...args);	×
226	}	×
227	return this.$render(...args);	×
228	},	×
229		×
230	/**	×
231	* Does the initializations when the component is created.	1✔
232	*	1✔
233	* @method (arg1)	1✔
234	* @private	1✔
235	* @param {Object} the options,	1✔
236	* @returns {Object} returns this,	1✔
237	* @since 0.0.0	1✔
238	*/	1✔
239	_init(...args) {	1✔
240	// init private:	1✔
241	this._tag = null;	1✔
242	this._cList = null;	×
243	this._mess = null;	×
244		×
245	// init public:	×
246	// Creates an unique id for this component:	×
247	// this.id = `i${Math.random().toString(36).substr(2, 7)}`;	×
248	this.id = _.makeid(C.idLength);	×
249	this.children = null;	1✔
250		1✔
251	const [state, props] = args;	1✔
252	this.state = _.isLiteralObject(state) ? state : {};	1✔
253	this.props = _.isLiteralObject(props) ? props : {};	1✔
254	this.name = 'mynameisnobody';	1✔
255		1✔
256	// Call the public init:	1✔
257	this._intInit();	×
258	return this;	×
259	},	×
260		×
261	/**	×
262	* Renders the component and returns its XMLString.	×
263	* (must not be overwritten)	×
264	*	×
265	* @method ()	×
266	* @public	×
267	* @param {} -,	×
268	* @returns {XMLString} returns the component's XMLString,	×
269	* @since 0.0.0	×
270	*/	×
271	_renderer() {	×
272	return R.render(this);	×
273	},	×
274		×
275	/**	×
276	* Returns data returned by the public method render.	×
277	* (must not be overwritten)	×
278	*	×
279	* @method ([arg1], [arg2])	×
280	* @public	×
281	* @param {Object} the state properties,	×
282	* @param {Object} the optional properties,	1✔
283	* @returns {XMLString} returns the component's XMLString,	1✔
284	* @since 0.0.0	1✔
285	*/	1✔
286	_render(...args) {	1✔
287	/*	1✔
288	xml = xml.replace(/<!--(.*?)-->/g, '') // remove comments	1✔
289	.replace(/\n\s+</g, '\n<') // remove leading spaces before a tag,	1✔
290	.replace(/\n<\/div>/g, '</div>') // remove unwanted `\n`,	1✔
291	.replace(/\n<\/ul>/g, '</ul>') // -	1✔
292	.replace(/\n<\/li>/g, '</li>') // -	1✔
293	.replace(/\n<\/a>/g, '</a>') // -	1✔
294	;	1✔
295	*/	1✔
296	const xml = this._intRender(...args);	1✔
297	if (_.isString(xml)) {	1✔
298	return xml.trim();	1✔
299	}	1✔
300	return xml;	×
301	},	×
302		×
303		×
304	// -- Defined Public Methods ---------------------------------------------	×
305		×
306	/**	×
307	* Returns an object to manipulate the component in the DOM.	×
308	* (must not be overwritten - see implementation in $.js)	×
309	*	×
310	* Nota: $ is filled when the View.Component is created	×
311	* (see main.js constructor).	×
312	*	×
313	* @method (arg1)	×
314	* @public	×
315	* @param {String} the node selector (id or class),	×
316	* @returns {Object} returns the $ object,	×
317	* @since 0.0.0	×
318	*/	×
319	$: null,	×
320		×
321	/**	×
322	* Animates the component.	1✔
323	* (must not be overwritten)	1✔
324	*	1✔
325	* @method (...args)	1✔
326	* @public	1✔
327	* @param {...args} properties [, duration ] [, easing ] [, callback ],	1✔
328	* @returns {Object} returns this,	1✔
329	* @since 0.0.0	1✔
330	*/	1✔
331	$animate(...args) {	1✔
332	[this._anim_timer, this._anim_callback] = A.animate(this, ...args);	1✔
333	return this;	1✔
334	},	1✔
335		1✔
336	/**	1✔
337	* Aborts the running animation.	1✔
338	* (must not be overwritten)	1✔
339	*	1✔
340	* @method ()	1✔
341	* @public	1✔
342	* @param {} -,	1✔
343	* @returns {Object} returns this,	1✔
344	* @since 0.0.0	1✔
345	*/	1✔
346	$abortAnimation() {	1✔
347	A.abortAnimation(this._anim_timer, this._anim_callback);	1✔
348	return this;	1✔
349	},	1✔
350		1✔
351	/**	1✔
352	* Appends a component as the last child to the selected component.	1✔
353	* (must not be overwritten)	1✔
354	*	×
355	* @method (...args)	×
356	* @public	×
357	* @param {...args} tag, component, [state], [props]	1✔
358	* @returns {Object} returns this,	1✔
359	* @since 0.0.0	1✔
360	*/	1✔
361	$append(...args) {	1✔
362	AD.append(this, ...args);	1✔
363	return this;	1✔
364	},	1✔
365		1✔
366	/**	1✔
367	* Returns a component object.	1✔
368	* (must not be overwritten)	1✔
369	*	×
370	* Nota:	×
371	* the algorithm tests 'ident' in this order: tag, id, name. It	×
372	* explores by parsing entirely the first child branch before parsing the	1✔
373	* second child branch. I stops as soon as there is a match.	1✔
374	*	1✔
375	* So, if a child in the second child branch as the same tag or name as a	1✔
376	* child in the first child branch, the algorithm returns the child in the	1✔
377	* first branch only. The matching child on the second branch won't never be	1✔
378	* retrieved.	1✔
379	*	1✔
380	* So, avoid duplicating tag or name.	1✔
381	*	1✔
382	* @method (arg1)	1✔
383	* @public	1✔
384	* @param {String} the component identity (could be tag, id or name),	1✔
385	* @returns {Object} returns the component object or null,	1✔
386	* @since 0.0.0	1✔
387	*/	1✔
388	$getChild(ident) {	1✔
389	return Util.getChild(this, ident);	1✔
390	},	1✔
391		1✔
392	/**	1✔
393	* Remove a component's child.	1✔
394	* (must not be overwritten)	1✔
395	*	1✔
396	* @method (arg1)	1✔
397	* @public	1✔
398	* @param {String} the component identity (could be tag, id or name),	1✔
399	* @returns {Boolean} returns true or false,	1✔
400	* @since 0.0.0	1✔
401	*/	1✔
402	$removeChild(ident) {	1✔
403	return Util.removeChild(this, ident);	1✔
404	},	1✔
405		1✔
406	/**	1✔
407	* Returns the list of children.	1✔
408	* (must not be overwritten)	1✔
409	*	1✔
410	* @method ()	1✔
411	* @public	1✔
412	* @param {} -,	1✔
413	* @returns {Array} returns the children list or null,	1✔
414	* @since 0.0.0	1✔
415	*/	1✔
416	$getChildren() {	1✔
417	return Util.getChildren(this);	1✔
418	},	1✔
419		1✔
420	/**	1✔
421	* Returns the component's Id and name.	1✔
422	* (must not be overwritten)	1✔
423	*	1✔
424	* @method ()	1✔
425	* @public	1✔
426	* @param {} -,	1✔
427	* @returns {Object} returns the component's id and name,	1✔
428	* @since 0.0.0	1✔
429	*/	1✔
430	$getIdAndName() {	1✔
431	return { id: this.id, name: this.name };	1✔
432	},	1✔
433		1✔
434	/**	1✔
435	* Returns an XMLString representation of the hyperscript template.	1✔
436	* (must not be overwritten)	1✔
437	*	1✔
438	* @method (...args)	1✔
439	* @public	1✔
440	* @param {...} arguments like { tag, attributes, value },	1✔
441	* @returns {Object} returns an object containing the node, its attributes	1✔
442	* @since 0.0.0 and the children,	1✔
443	*/	1✔
444	$hyperscript(...args) {	1✔
445	return H.format(...args);	1✔
446	},	1✔
447		1✔
448	/**	1✔
449	* Updates state value(s).	1✔
450	* (must not be overwritten)	×
451	*	×
452	* @method (arg1)	×
453	* @public	1✔
454	* @param {Object} the state object,	1✔
455	* @returns {Object} returns this,	1✔
456	* @since 0.0.0	1✔
457	*/	1✔
458	$setState(params) {	1✔
459	if (_.isLiteralObject(params)) {	1✔
460	S.setState(this, params);	1✔
461	}	1✔
462	return this;	1✔
463	},	1✔
464		1✔
465	/**	1✔
466	* Listens for a message from another component.	1✔
467	* (must not be overwritten)	1✔
468	*	1✔
469	* @method (arg1, arg2)	1✔
470	* @public	×
471	* @param {String} the event to listen,	1✔
472	* @param {Function} the listener to attach to this event,	1✔
473	* @returns {Object} returns this,	1✔
474	* @since 0.0.0	1✔
475	*/	1✔
476	$listen(event, listener) {	1✔
477	if (this._mess) {	1✔
478	this._mess.subscribe(event, listener);	1✔
479	return this;	×
480	}	×
481	/* eslint-disable-next-line no-console */	×
482	console.log('$listen: the plugin Messenger is not installed!');	1✔
483	return this;	1✔
484	},	1✔
485		1✔
486	/**	1✔
487	* sends for a message to another component.	1✔
488	* (must not be overwritten)	1✔
489	*	1✔
490	* @method (arg1, arg2)	1✔
491	* @public	1✔
492	* @param {String} the event to listen,	1✔
493	* @param {Object} the payload to send,	1✔
494	* @returns {Object} returns this,	1✔
495	* @since 0.0.0	×
496	*/	×
497	$emit(event, payload) {	×
498	if (this._mess) {	×
499	this._mess.publish(event, payload);	×
500	return this;	×
501	}	×
502	/* eslint-disable-next-line no-console */	×
503	console.log('$emit: the plugin Messenger is not installed!');	1✔
504	return this;	1✔
505	},	1✔
506		1✔
507		1✔
508	// -- Empty Public Methods -----------------------------------------------	1✔
509		1✔
510	/**	1✔
511	* Does the initializations when the component is created.	1✔
512	* (could be overwritten)	1✔
513	*	1✔
514	* Nota:	1✔
515	* 'props.options' are initialized when the component is instantiated. Be	1✔
516	* careful not to overwrite it.	×
517	*	×
518	* @method ()	×
519	* @public	×
520	* @param {} -,	×
521	* @returns {Object} returns this,	×
522	* @since 0.0.0	×
523	*/	×
524	init() {},	×
525	$init() {	×
526	return this;	×
527	},	×
528		×
529	/**	×
530	* Processes the DOM events.	1✔
531	* (could be overwritten)	1✔
532	*	1✔
533	* @method ()	1✔
534	* @public	1✔
535	* @param {} -,	1✔
536	* @returns {Object} returns this,	1✔
537	* @since 0.0.0	1✔
538	*/	1✔
539	events() {},	1✔
540		1✔
541	/**	1✔
542	* Listens for DOM events.	1✔
543	* (could be overwritten)	1✔
544	*	1✔
545	* Nota:	1✔
546	* This method is called after the component	1✔
547	* has been attached to the DOM. It must be used	1✔
548	* to listen to the DOM events generated by the component.	1✔
549	*	1✔
550	* @method ()	1✔
551	* @public	1✔
552	* @param {} -,	1✔
553	* @returns {Object} returns this,	1✔
554	* @since 0.0.0	1✔
555	*/	1✔
556	listen() {},	1✔
557	$listenDOM() {	1✔
558	return this;	1✔
559	},	1✔
560		1✔
561	/**	1✔
562	* Performs operations after the component is added to the DOM.	1✔
563	* (could be overwritten)	1✔
564	*	1✔
565	* Nota:	1✔
566	* This method is called after the component	1✔
567	* has been attached to the DOM. It must be used	1✔
568	* to perform a post-rendering process.	1✔
569	*	1✔
570	* @method ()	1✔
571	* @public	1✔
572	* @param {} -,	1✔
573	* @returns {Object} returns this,	1✔
574	* @since 0.0.0	1✔
575	*/	1✔
576	postRender() {},	1✔
577	$postRender() {	1✔
578	return this;	1✔
579	},	1✔
580		1✔
581	/**	1✔
582	* Performs operations after the component in the DOM has been updated.	1✔
583	* (could be overwritten)	1✔
584	*	1✔
585	* Nota:	1✔
586	* This method is called after the component, already	1✔
587	* in the DOM, is updated through a $setState. It must be used	1✔
588	* to perform a post-rendering process after each update.	1✔
589	*	1✔
590	* @method ()	1✔
591	* @public	1✔
592	* @param {} -,	1✔
593	* @returns {Object} returns this,	1✔
594	* @since 0.0.0	1✔
595	*/	1✔
596	onChange() {},	1✔
597	$onChange() {	1✔
598	return this;	1✔
599	},	×
600		×
601	/**	×
602	* Returns an XMLString.	1✔
603	* (could be overwritten)	1✔
604	*	1✔
605	* @method ()	1✔
606	* @public	1✔
607	* @param {} -,	1✔
608	* @returns {String} returns XMLString,	1✔
609	* @since 0.0.0	1✔
610	*/	1✔
611	render() {},	1✔
612	$render() {	1✔
613	return '<div></div>';	1✔
614	},	1✔
615	};	1✔
616		1✔
617		1✔
618	// -- Export	1✔
619	export default { Construct, methods };	1✔
620		1✔
621	/* eslint-enable one-var, semi-style, no-underscore-dangle */	1✔

jclo / rview / 10813693526

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous