tui-grid/src/js/base/view.js

TOAST UI Grid : Powerful data grid control supported by TOAST UI

/**
 * @fileoverview Base class for Views
 * @author NHN. FE Development Lab <dl_javascript@nhn.com>
 */

'use strict';

var _ = require('underscore');
var Backbone = require('backbone');

/**
 * Base class for Views
 * @module base/view
 * @ignore
 */
var View = Backbone.View.extend(/** @lends module:base/view.prototype */{
    initialize: function() {
        this._children = [];
    },

    /**
     * Add children views
     * @param {(Object|Array)} views - View instance of Array of view instances
     * @private
     */
    _addChildren: function(views) {
        if (!_.isArray(views)) {
            views = [views];
        }
        [].push.apply(this._children, _.compact(views));
    },

    /**
     * Render children and returns thier elements as array.
     * @returns {array.<HTMLElement>} An array of element of children
     */
    _renderChildren: function() {
        var elements = _.map(this._children, function(view) {
            return view.render().el;
        });

        return elements;
    },

    /**
     * Trigger 'appended' event on child view.
     * @private
     */
    _triggerChildrenAppended: function() {
        _.each(this._children, function(view) {
            view.trigger('appended');
        });
    },

    /**
     * 자식 View를 제거한 뒤 자신도 제거한다.
     */
    destroy: function() {
        this.stopListening();
        this._destroyChildren();
        this.remove();
    },

    /**
     * 등록되어있는 자식 View 들을 제거한다.
     */
    _destroyChildren: function() {
        if (this._children) {
            while (this._children.length > 0) {
                this._children.pop().destroy();
            }
        }
    }
});

module.exports = View;