MooTools 1.4 源码分析 - Fx.CSS

本文参考了我佛山人的Mootools1.2的源码分析二十九 -- Fx.CSS

    /*
    ---

    name: Fx.CSS

    description: Contains the CSS animation logic. Used by Fx.Tween, Fx.Morph, Fx.Elements.

    license: MIT-style license.

    requires: [Fx, Element.Style]

    provides: Fx.CSS

    源码分析: 苦苦的苦瓜(http://www.cnblogs.com/hmking)

    ...
    */

    /**
    * @Fx.CSS: 跟CSS有关的动画的基类，这里的动画，主要是从一个开始值到结束值的变化效果
    **/
    Fx.CSS = new Class({

        // 继承自Fx
        Extends: Fx,

        // prepares the base from/to object
        /**
        * @method: prepare
        * @param element - (object) 特效作用的元素对象
        * @param property - (string) CSS属性
        * @param values - (mixed) 包含开始值和结束值的数组或一个单值(结束值)
        * @returns: (object) - 包含from和to两个键值的对象字面量
        * @description: 动画的开始和结束值的前期处理
        * @notes: 此时from和to两个键的值为数组类型
        **/
        prepare: function (element, property, values) {
            // 把变量values数组化，因为values可能传一个单值，也可能是一个数组
            values = Array.from(values);
            // 取特效的起始值和结束值，如果如果只传了一个值，则本值将作为结束值，CSS属性的当前值为特效起始值
            if (values[1] == null) {
                values[1] = values[0];
                values[0] = element.getStyle(property);
            }
            // 将数组中的项使用parse方法解释
            var parsed = values.map(this.parse);
            // 返回from和to两个键值的对象字面量
            return { from: parsed[0], to: parsed[1] };
        },

        //parses a value into an array
        /**
        * @method: parse
        * @param value - (mixed) CSS属性值
        * @returns: (array) - 数组项值为包含value和parser两个键值的对象字面量，存储解释过的CSS属性值和包含针对此属性值的解释器
        * @description: 解析一个CSS属性值为一个数组
        **/
        parse: function (value) {
            // 使用lambad表达式，将value函数化之后再执行，这样的好处是使传的值可以是function，也可以是固定值
            value = Function.from(value)();
            // 数组化，如果是字符串类型，使用空格分隔成数组
            value = (typeof value == 'string') ? value.split(' ') : Array.from(value);
            // 对数组逐项处理
            return value.map(function (val) {
                // 转为字符类型
                val = String(val);
                var found = false;
                Object.each(Fx.CSS.Parsers, function (parser, key) {
                    // 第一项时这里为false继续执行下面，找到合适的解释器后found判断不再为false，避免重复解释
                    if (found) { return; }
                    // 尝试使用解释器解释值
                    var parsed = parser.parse(val);
                    // 如果解释成功，记录解释后的值和使用的解释器(因为还要使用解释器的compute和serve方法)
                    if (parsed || parsed === 0) {
                        found = {
                            value: parsed,
                            parser: parser
                        };
                    }
                });
                // 默认使用字符串值的解释器
                found = found || {
                    value: val,
                    parser: Fx.CSS.Parsers.String
                };
                return found;
            });
        },

        // computes by a from and to prepared objects, using their parsers.
        /**
        * @method: compute
        * @param from - (array) 解释过的CSS属性的起始值的数组
        * @param to - (array) 解释过的CSS属性的结束值的数组
        * @param delta - (mixed) 特效变化所需要的比例因子
        * @returns: (array) 包含计算过的特效当前CSS属性值信息的一个数组
        * @description: 根据初始值，结束值和比例因子求目标值
        **/
        compute: function (from, to, delta) {
            var computed = [];
            // 取数项小的遍历
            (Math.min(from.length, to.length)).times(function (i) {
                // 返回计算过的值和使用的解释器
                computed.push({
                    value: from[i].parser.compute(from[i].value, to[i].value, delta),
                    parser: from[i].parser
                });
            });
            // 为typeOf提供精准类型值
            computed.$family = Function.from('fx:css:value');
            return computed;
        },

        // serves the value as settable
        /**
        * @method: serve
        * @param value - (mixed) CSS属性目标值，此参数可以是一个解释过的CSS属性值数组，也可以为一个CSS属性值
        * @param unit - (string 默认为 false) 计量单位(如: 'px', 'em', 或 '%').
        * @returns: (array) 包含计算过的特效当前CSS属性值信息的一个数组
        * @description: 对计算过的CSS属性值数组对象做最后的包装处理，使其可应用于Element.setStyle方法
        **/
        serve: function (value, unit) {
            // 如果值未经解释，需要先解释(比如单独调用set方法)
            if (typeOf(value) != 'fx:css:value') {
                value = this.parse(value);
            }
            var returned = [];
            value.each(function (bit) {
                // 得到最终的使用值
                returned = returned.concat(bit.parser.serve(bit.value, unit));
            });
            return returned;
        },

        // renders the change to an element
        // 因为类本身是跟CSS有类，所以最终将计算出的数组通过setStyle反映到element的相应CSS属性上
        render: function (element, property, value, unit) {
            element.setStyle(property, this.serve(value, unit));
        },

        // searches inside the page css to find the values for a selector
        // 从当前页面的样式中查找指定选择符的样式设置
        search: function (selector) {
            // 模拟缓存，先从临时对象中找相应键值，提高效率
            if (Fx.CSS.Cache[selector]) { return Fx.CSS.Cache[selector]; }
            var to = {},
                    selectorTest = new RegExp('^' + selector.escapeRegExp() + '$');
            // 遍历当前页面的样式表
            Array.each(document.styleSheets, function (sheet, j) {
                var href = sheet.href;
                // 忽略跨域的外链样式表
                if (href && href.contains('://') && !href.contains(document.domain)) {
                    return;
                }
                // 样式规则集
                var rules = sheet.rules || sheet.cssRules;
                // 遍历每条规则
                Array.each(rules, function (rule, i) {
                    if (!rule.style) { return; }
                    // 选择符(类型选择符的话会转为小写)
                    var selectorText = (rule.selectorText) ? rule.selectorText.replace(/^\w+/, function (m) {
                        return m.toLowerCase();
                    }) : null;
                    // 匹配指定的样式选择符
                    if (!selectorText || !selectorTest.test(selectorText)) { return; }
                    // 样式值分析
                    Object.each(Element.Styles, function (value, style) {
                        // 无值
                        if (!rule.style[style] || Element.ShortStyles[style]) { return; }
                        // 转为字符串
                        value = String(rule.style[style]);
                        // 颜色值处理
                        to[style] = ((/^rgb/).test(value)) ? value.rgbToHex() : value;
                    });
                });
            });
            // 缓存
            return Fx.CSS.Cache[selector] = to;
        }

    });

    Fx.CSS.Cache = {};

    // #region - 解释器 -

    // CSS中几种值类型的解释器，每个解释器必须实现parse/compute/serve三个接口
    Fx.CSS.Parsers = {

        // 对颜色的解释处理
        Color: {

            parse: function (value) {
                // 如果是十六进制的颜色表示，处理成RGB数组
                if (value.match(/^#[0-9a-f]{3,6}$/i)) {
                    return value.hexToRgb(true);
                }
                // 如果是RGB的颜色显示，正则匹配出RGB数组，不匹配返回flase，以便引擎调用其它解释器解释
                return ((value = value.match(/(\d+),\s*(\d+),\s*(\d+)/))) ? [value[1], value[2], value[3]] : false;
            },

            compute: function (from, to, delta) {
                // 对R、G和B分别计算目标值
                return from.map(function (value, i) {
                    // 可以看到仍然使用静态的compute方法
                    return Math.round(Fx.compute(from[i], to[i], delta));
                });
            },

            serve: function (value) {
                // 将R、G、B都转成数值型
                return value.map(Number);
            }

        },

        // 数值类型的解释处理
        Number: {

            // 转为浮点数
            parse: parseFloat,

            // 跟Fx中的算法一样
            compute: Fx.compute,

            serve: function (value, unit) {
                // 加上单位，比如px，pt之类
                return (unit) ? value + unit : value;
            }

        },

        // 对字符类型的解释处理
        String: {

            // 解释器返回false，相当于parse : function(){return false;}
            parse: Function.from(false),

            // compute方法执行时返回第2个参数
            compute: function (zero, one) {
                return one;
            },

            // serve方法执行时返回第1个参数
            serve: function (zero) {
                return zero;
            }

        }

    };

    // #endregion