jquer “$” 扩展(笔记)

/**
 * Created by shanruo on 16-03-10.
 */

(function ( $ ){

    $.extend ({

        /*
         * 根据参数名获取参数 @name String 参数名
         */
        queryString : function ( name ){
            name = name.replace (/[[]/, "\[" ).replace (/[]]/, "\]" );
            var regexS = "[\?&]" + name + "=([^&#]*)";
            var regex = new RegExp (regexS );
            var results = regex.exec (window.location.search );
            if (results == null) {
                return "";
            }
            else {
                return decodeURIComponent (results[1].replace (/+/g, " " ) );
            }
        },

        /*
         * 根据URL地址后退 @URL String 需返回的后退URL地址
         */
        goBack : function ( url ){
            if (url !== "" && typeof url !== "undefined") {
                var parameters = window.location.search;
                url = url + parameters;
                window.location.href = url;
            }
            else {
                window.history.back ();
            }
        },

        // layer 加载层
        loading : function ( msg ){
            if (!msg) {
                msg = '数据加载中...';
            }
            $.layer ({
                time : 0, // 显示多久
                shade : [ 0.3, '#000', true ],
                loading : {
                    type : 2,
                    msg : msg
                }, // loadGif 获取样式值,只能为0-3
                border : [ 10, 0.3, '#000', true ],
                type : 3,
                title : [ '', false ],
                closeBtn : [ 0, false ]
            } );
        },

        // 关闭loding层
        loadClose : function ( ){
            layer.loadClose ();
        },

        clearQuery : function ( obj ){
            // 清除条件
            $ (obj ).find ("input[type='text']" ).val ("" );

            // 日期清除条件
            var dateInputObj = $ (obj ).find ("input[type='hidden']" );
            dateInputObj.each (function ( ){
                var self = $ (this );
                if ($ (self ).attr ("isDate" ) === "true") {
                    var dateInputId = self.attr ("name" ).toString ().substring (3 );
                    $ ("input[name='"+dateInputId+"']").val (self.val () );
                }

            } )

            // 下拉列表选择第一个
            $ (obj ).find ("select" ).each (function ( ){
                $ (this ).find ("option:first" ).attr ("selected", "selected" )
            } );
        },

        /*
         * 回填文本框值 @objId String 回填对象 @queryStringName 回填参数值
         */
        fillInputValue : function ( objId, queryStringName ){
            if (objId === "" || typeof objId === "undefined") { return false; }

            if (queryStringName === "" || typeof queryStringName === "undefined") { return false; }

            var self = $ ("#" + objId );
            var value = $.queryString (queryStringName );
            if (self.is ('select' )) {
                $ (self ).val (value )
            }
            if (self.attr ("type" ) === "text") {
                $ (self ).val (value )
            }
        },

        /*
         * 根据URL跳转到前一页 @URL String 需返回的前一页URL地址 @urlParam json参数数据如：{parame1:"1",parame2:"2"}
         */
        goForward : function ( url, urlParam ){
            if (typeof urlParam === "undefined" || urlParam === null) {
                urlParam = "";
            }

            var pageIndex = $ ("#_MvcPager_Ctrl0_pib" ).val ();
            var positionY = $ (document ).scrollTop ();
            $.extend (urlParam, {
                "py" : positionY,
                "pageIndex" : pageIndex
            } );
            var strPara = $.param (urlParam );
            window.location.href = url + "&" + strPara;
        },

        /*
         * 渲染返回行需要表示的行 @lineObj object 行索引对象
         */
        animateLine : function ( lineObj ){
            var py = $.queryString ("py" );
            py = parseFloat (py );
            var self = lineObj;
            if (typeof lineObj !== Object) {
                self = $ ("#" + lineObj );
            }
            // window.scrollTo(px, py);
            $ ("html,body" ).animate ({
                scrollTop : py
            }, 1 );
            self.css ("background", "#ccc" );
        },

        /*
         * 日期比较函数 @startDate String 起始日期 @endDate String 截止日期 @crossMonthNum int 表示不能跨月数（包含）1表示不能跨1个月，小于等于0或者其他都不做判断. @keyWords String 关键字,重新拼接提示信息，默认"开始日期不能为空！"；例：查询:重新定义为"查询开始日期不能为空！".
         */
        compareDate : function ( startDate, endDate, crossMonthNum, keyWords ){
            var start, // 起始时间
            end, // 截止日期
            yearNum, // 跨年数
            monthNum, // 跨月数
            strMonthNum, // 拼接语句,提示多少月
            crossMonthMsg, // 提示语句
            startYear, // 起始日期年份
            endYear, // 截止日期年份
            startMonth, // 起始日期月份
            endMonth, // 截止日期年份
            ReturnMsg = "", // 返回提示信息
            ReturnMonthMsg = ""; // 返回跨月提示信息

            if (startDate.replace (/(^s*)|(s*$)/g, "" ) === "") {
                crossMonthMsg = "开始日期不能为空！";
                if (keyWords !== "" && typeof keyWords !== "undefined") { return ReturnMsg = keyWords + crossMonthMsg; }
                return crossMonthMsg;
            }
            if (endDate.replace (/(^s*)|(s*$)/g, "" ) === "") {
                crossMonthMsg = "结束日期不能为空！";
                if (keyWords !== "" && typeof keyWords !== "undefined") { return ReturnMsg = keyWords + crossMonthMsg; }
                return crossMonthMsg;
            }

            start = new Date (Date.parse (startDate.replace (/-/g, "/" ) ) );
            end = new Date (Date.parse (endDate.replace (/-/g, "/" ) ) );
            if (end < start) {
                crossMonthMsg = "开始日期不能大于结束日期！";
                if (keyWords !== "" && typeof keyWords !== "undefined") { return ReturnMsg = keyWords + crossMonthMsg; }
                return crossMonthMsg;
            }

            if (typeof crossMonthNum !== "number") {
                crossMonthNum = 0;
            }

            if (crossMonthNum !== "" && typeof keyWords !== "undefined") {
                crossMonthNum = parseInt (crossMonthNum, 10 );
                strMonthNum = crossMonthNum === 1 ? "" : crossMonthNum + "个";
                crossMonthMsg = "查询时间不能跨" + strMonthNum + "月！";
                if (keyWords !== "" && typeof keyWords !== "undefined") {
                    ReturnMonthMsg = keyWords + "时间不能跨" + strMonthNum + "月！";
                }
                else {
                    ReturnMonthMsg = crossMonthMsg;
                }

                if (crossMonthNum < 12 && crossMonthNum > 0) {
                    yearNum = 0;
                    monthNum = crossMonthNum;
                }

                if (crossMonthNum >= 12) {
                    yearNum = Math.round (crossMonthNum / 12 );
                    monthNum = Math.abs (crossMonthNum % 12 );
                }

                startMonth = start.getMonth ();
                endMonth = end.getMonth ();
                startYear = start.getYear ();
                endYear = end.getYear ();
                /*
                 * yearNum 为0表示没有跨年按照跨月处理判断 为1表示跨年，按照跨年处理判断
                 */
                if (yearNum === 0) {
                    if (endYear - startYear === yearNum) {
                        if (endMonth - startMonth > monthNum - 1) { return ReturnMonthMsg; }
                    }
                    else if (endYear - startYear === yearNum + 1) {
                        if ((endMonth + 12) - startMonth > monthNum - 1) { return ReturnMonthMsg; }
                    }
                    else {
                        return ReturnMonthMsg;
                    }
                }
                else if (yearNum >= 1) {
                    if (endYear - startYear === yearNum) {
                        if (endMonth - startMonth > monthNum - 1) { return ReturnMonthMsg; }
                    }
                    else if (endYear === startYear) {
                        return ReturnMsg;
                    }
                    else {
                        return ReturnMonthMsg;
                    }
                }
            }

            return ReturnMsg;
        },


        /*
         * 数组对象转换成Json对象 @obj object form对象
         */
        serializeJson : function ( obj ){
            var self = $ (obj );
            var serializeObj = {};
            var array = self.serializeArray ();
            var str = self.serialize ();
            $ (array ).each (function ( ){
                this.value = filterKeyWord (this.value );
                if (serializeObj[this.name]) {
                    if ($.isArray (serializeObj[this.name] )) {
                        serializeObj[this.name].push (this.value );
                    }
                    else {
                        serializeObj[this.name] = [ serializeObj[this.name], this.value ];
                    }
                }
                else {
                    serializeObj[this.name] = this.value;
                }
            } );

            return serializeObj;
        },

        /*
         * Json对象转换成json字符串 @obj object form对象
         */
        jsonToString : function ( obj ){
            var parameters = $ (obj )[0];
            var arrResult = [];
            for ( var key in parameters) {
                var parValue = parameters[key];

                if (parValue === null || parValue === undefined) {
                    continue;
                }
                parValue = filterKeyWord (parValue ); // 过滤""以免json序列化问题

                arrResult.push ('"' + key + '":"' + parValue + '"' );
            }

            var json = '{' + arrResult.join (',' ) + '}';
            return json;
        },

        /**
         * 文本框框正则验证
         * 
         * @regType AZ:只能为字母， 09AZ：只能数字字母， 0.9:只能数字或小数，09：只能为整数
         * @arrInputValidate 要验证的文本框数组如['validateInput1','validateInput2']
         * @zero 最小值
         * @max 最大值
         */
        formatRegInput : function ( regType, arrInputValidate, zero, max ){
            formatInputCommon (regType, arrInputValidate, zero, max );
        }
    } );

    // 转义""特殊字符
    function filterKeyWord ( strKeyWord ){
        if (strKeyWord.indexOf ("\" ) === -1) { return strKeyWord; }

        var str = strKeyWord.split ("\" );
        var len = str.length;
        var arr = [];
        for (var i = 0; i < len; i++) {
            var keyValue = str[i];
            arr.push (keyValue );
        }

        return arr.join ("\\" );
    }

    /*309      * 验证控件
     */
    function formatInputCommon ( regType, arrInputValidate, zero, max ){
        var reg = "";
        if (regType.toUpperCase () === "AZ") {
            reg = /[^(a-zA-Z)+$]/g;
        }
        else if (regType.toUpperCase () === "09AZ") {
            reg = /[^(0-9a-zA-Z)+$]/g;
        }
        else if (regType === "0.9") {
            reg = /[^(0-9).+$]/g;
        }
        else if (regType === "09") {
            reg = /[^(0-9)+$]/g;
        }
        else {
            return;
        }

        var validateObj = [];
        for (var i = 0; i < arrInputValidate.length; i++) {
            validateObj.push ("input[name='" + arrInputValidate[i] + "']" );
        }

        $ (validateObj.join ("," ) ).on ('keyup', function ( ){
            var value = $ (this ).val ();
            value = value.toUpperCase ().replace (reg, '' );
            if (parseInt (value, 10 ) > max) {
                value = max;
            }
            $ (this ).val (value );
        } );

        $ (validateObj.join ("," ) ).on ('blur', function ( ){
            var value = $ (this ).val ();
            value = value.toUpperCase ().replace (reg, '' );
            if (zero === 0) {
                if (value === "") {
                    value = 0;
                }
            }

            $ (this ).val (value );
        } );
    }
    ;

}) (jQuery )