app-command-behavior.html

<!--
@license
Copyright (c) 2017 The expand.js authors. All rights reserved.
This code may only be used under the BSD style license found at https://expandjs.github.io/LICENSE.txt
The complete set of authors may be found at https://expandjs.github.io/AUTHORS.txt
The complete set of contributors may be found at https://expandjs.github.io/CONTRIBUTORS.txt
-->

<!--
A behavior used to add command capabilities on a web component.

@behavior app-command-behavior
@since 1.0.0
@category behaviors
@description A behavior used to add command capabilities on a web component
@keywords expandjs, web app, web components

@homepage https://expandjs.com/components/app-command-behavior
@repository https://github.com/expandjs/app-behaviors
@source https://github.com/expandjs/app-behaviors/blob/master/app-command-behavior.html

@behavior xp-master-slave-behavior /bower_components/xp-elements/xp-master-slave-behavior.html
-->

<link rel="import" href="../polymer/polymer.html">
<link rel="import" href="../expandjs/expandjs.html">
<link rel="import" href="../xp-elements/xp-master-slave-behavior.html">

<script>

    /**
     * @polymerBehavior Polymer.APPCommandBehaviorImp
     */
    Polymer.APPCommandBehaviorImp = {

        // CLASSES
        classes: ['command'],

        /*********************************************************************/

        /**
         * Executes the command.
         *
         * @method execute
         * @param {Object} [options]
         * @param {Function} [callback]
         */
        execute(strategy, options, callback) {

            // Preparing
            if (XP.isFunction(options)) { callback = options; options = {}; }
            if (XP.isVoid(callback)) { callback = function () {}; }

            // Asserting
            XP.assertArgument(XP.isVoid(options) || XP.isObject(options), 1, 'Object');
            XP.assertArgument(XP.isFunction(callback), 2, 'Function');

            // Calling
            return strategy.call(this, options || {}, callback);
        },

        /*********************************************************************/

        /**
         * Must be redefined to set the `execute` strategy.
         *
         * @method _execute
         * @param {Object} options
         * @param {Function} callback
         * @abstract
         */
        _execute(options, callback) {

            // Callback
            callback(new XP.AbstractError('_execute'));
        },

        /*********************************************************************/

        // PROPERTIES
        properties: {

            /**
             * The command's name.
             *
             * @attribute name
             * @type string
             */
            name: {
                type: String,
                value() { return XP.camelCase(this.tagName.slice(this.tagName.indexOf('-') + 1)); }
            },

            /**
             * The application's store.
             *
             * @attribute store
             * @type Element
             * @readonly
             */
            store: {
                master: '.store',
                observer: '__storeChanged',
                readOnly: true
            }
        },

        /*********************************************************************/

        // OBSERVER
        __storeChanged(post) {

            // Setting
            if (post) { post[this.name] = this.execute.bind(post, this._execute); }
        }
    };

    /**
     * @polymerBehavior Polymer.APPCommandBehavior
     */
    Polymer.APPCommandBehavior = [
        Polymer.XPMasterSlaveBehavior,
        Polymer.APPCommandBehaviorImp
    ];
</script>