add extjs 6.0.1 sources

[extjs.git] / extjs / packages / core / src / app / bind / Multi.js

/**\r
 * This class is created to manage a multi-bind against a `ViewModel`.\r
 */\r
Ext.define('Ext.app.bind.Multi', {\r
    extend: 'Ext.app.bind.BaseBinding',\r
\r
    isMultiBinding: true,\r
\r
    missing: 1,\r
\r
    // Multi binds have to be deep. We construct a single object/array and we only\r
    // ever fire by notifying with that value which will never change. As such, we\r
    // need to notify any child bindings so they can check if their individual\r
    // bindings have changed.\r
    deep: true,\r
\r
    /**\r
     * @cfg {Boolean} trackStatics\r
     * This option tracks for static branches of the root object which can be pruned using\r
     * {@link #pruneStaticKeys}. This can be useful to only get the dynamic parts of a multi bind:\r
     *\r
     *      {\r
     *          a: 1,\r
     *          b: '{someBind}',\r
     *          c: ['a', 'b', 'c'],\r
     *          d: ['a', 'b', '{someBind}'],\r
     *          e: {\r
     *              y: 1,\r
     *              z: 2\r
     *          },\r
     *          f: {\r
     *              y: 1,\r
     *              z: '{someBind}'\r
     *          }\r
     *      }\r
     *\r
     *      // Will produce\r
     *      {\r
     *          b: value,\r
     *          d: ['a', 'b', value],\r
     *          f: {\r
     *              y: 1,\r
     *              z: value\r
     *          }\r
     *      }\r
     * @private\r
     * @since 5.1.0\r
     */\r
\r
    constructor: function (descriptor, owner, callback, scope, options) {\r
        var me = this,\r
            trackStatics = options && options.trackStatics;\r
\r
        me.callParent([ owner, callback, scope, options ]);\r
\r
        me.bindings = [];\r
        me.literal = descriptor.$literal;\r
\r
        if (descriptor.constructor === Object) {\r
            if (trackStatics) {\r
                me.staticKeys = [];\r
            }\r
            me.addObject(descriptor, me.lastValue = {}, me.staticKeys);\r
        } else {\r
            me.addArray(descriptor, me.lastValue = []);\r
        }\r
\r
        // We started at missing == 1 so that no immediate callbacks would hit 0 before\r
        // adding all bindings... so now we decrement by 1 to balance things and see if\r
        // we are at 0.\r
        if (! --me.missing && !me.scheduled) {\r
            me.schedule();\r
        }\r
    },\r
\r
    destroy: function () {\r
        var me = this;\r
\r
        me.bindings = Ext.destroy(me.bindings);\r
\r
        me.callParent();\r
    },\r
\r
    add: function (descriptor, data, property) {\r
        var me = this,\r
            owner = me.owner,\r
            bindings = me.bindings,\r
            method = me.literal ? (descriptor.reference ? 'bindEntity' : 'bindExpression')\r
                                : 'bind',\r
            binding, depth;\r
\r
        ++me.missing;\r
\r
        binding = owner[method](descriptor,\r
            function (value) {\r
                data[property] = value;\r
\r
                if (binding.calls === 1) {\r
                    --me.missing;\r
                }\r
\r
                if (!me.missing && !me.scheduled) {\r
                    me.schedule();\r
                }\r
            },\r
            //TODO - split bind options between us and the sub-binds (pass null for now)\r
            me, null);\r
\r
        depth = binding.depth;\r
        if (!bindings.length || depth < me.depth) {\r
            me.depth = depth;\r
        }\r
\r
        bindings.push(binding);\r
        return !this.isBindingStatic(binding);\r
    },\r
\r
    addArray: function (multiBindDescr, array) {\r
        var me = this,\r
            n = multiBindDescr.length,\r
            hasDynamic = false,\r
            dynamic, b, i;\r
\r
        for (i = 0; i < n; ++i) {\r
            b = multiBindDescr[i];\r
\r
            if (b && (b.reference || Ext.isString(b))) {\r
                dynamic = me.add(b, array, i);\r
            } else if (Ext.isArray(b)) {\r
                dynamic = me.addArray(b, array[i] = []);\r
            } else if (b && b.constructor === Object) {\r
                dynamic = me.addObject(b, array[i] = {});\r
            } else {\r
                array[i] = b;\r
                dynamic = false;\r
            }\r
            hasDynamic = hasDynamic || dynamic;\r
        }\r
        return hasDynamic;\r
    },\r
\r
    addObject: function (multiBindDescr, object, staticKeys) {\r
        var me = this,\r
            hasDynamic = false,\r
            dynamic, b, name;\r
\r
        for (name in multiBindDescr) {\r
            b = multiBindDescr[name];\r
\r
            if (b && (b.reference || Ext.isString(b))) {\r
                dynamic = me.add(b, object, name);\r
            } else if (Ext.isArray(b)) {\r
                dynamic = me.addArray(b, object[name] = []);\r
            } else if (b && b.constructor === Object) {\r
                dynamic = me.addObject(b, object[name] = {});\r
            } else {\r
                object[name] = b;\r
                dynamic = false;\r
            }\r
            if (staticKeys && !dynamic) {\r
                staticKeys.push(name);\r
            }\r
            hasDynamic = hasDynamic || dynamic;\r
        }\r
        return hasDynamic;\r
    },\r
\r
    getFullName: function () {\r
        var me = this,\r
            fullName = me.fullName,\r
            bindings = me.bindings,\r
            length = bindings.length,\r
            i;\r
\r
        if (!fullName) {\r
            fullName = '@[';\r
            for (i = 0; i < length; ++i) {\r
                if (i) {\r
                    fullName += ',';\r
                }\r
                fullName += bindings[i].getFullName();\r
            }\r
            fullName += ']';\r
\r
            me.fullName = fullName;\r
        }\r
\r
        return fullName;\r
    },\r
\r
    getRawValue: function () {\r
        return this.lastValue;\r
    },\r
\r
    isDescendantOf: function () {\r
        return false;\r
    },\r
\r
    isLoading: function () {\r
        for (var bindings = this.bindings, n = bindings.length; n-- > 0; ) {\r
            if (bindings[n].isLoading()) {\r
                return true;\r
            }\r
        }\r
\r
        return false;\r
    },\r
\r
    isBindingStatic: function(binding) {\r
        return binding.isTemplateBinding && binding.isStatic;\r
    },\r
\r
    isStatic: function() {\r
        var bindings = this.bindings,\r
            len = bindings.length,\r
            i, binding;\r
\r
        for (i = 0; i < len; ++i) {\r
            binding = bindings[i];\r
            if (!this.isBindingStatic(binding)) {\r
                return false;\r
            }\r
        }\r
        return true;\r
    },\r
\r
    pruneStaticKeys: function() {\r
        var value = Ext.apply({}, this.lastValue),\r
            keys = this.staticKeys,\r
            len = keys.length,\r
            i;\r
\r
        for (i = 0; i < len; ++i) {\r
            delete value[keys[i]];\r
        }\r
        return value;\r
    },\r
\r
    react: function () {\r
        this.notify(this.lastValue);\r
    },\r
\r
    refresh: function () {\r
        // @TODO\r
    },\r
    \r
    privates: {\r
        sort: function () {\r
            this.scheduler.sortItems(this.bindings);\r
\r
            // Schedulable#sort === emptyFn\r
            //me.callParent();\r
        }\r
    }\r
});\r