JavaScript插件编写指南form验证

在jQuery大量使用的环境下,目前网上的众多jQuery插件也能基本满足要求,但是在项目具体需求下,有时候依旧需要自己造轮子,本文介绍了依赖jQuery库进行原生JavsScript插件的编写。

插件需要满足的条件

一个可复用的插件需要满足以下条件:

  • 插件自身的作用域与用户当前的作用域相互独立,也就是插件内部的私有变量不能影响使用者的环境变量;
  • 插件需具备默认设置参数;
  • 插件除了具备已实现的基本功能外,需提供部分API,使用者可以通过该API修改插件+ 功能的默认参数,从而实现用户自定义插件效果;
  • 插件支持链式调用。

1,基本插件格式

实现私有作用域,最好的办法就是使用闭包。可以把插件当做一个函数,插件内部的变量及函数的私有变量,为了在调用插件后依旧能使用其功能,闭包的作用就是延长函数(插件)内部变量的生命周期,使得插件函数可以重复调用,而不影响用户自身作用域。

故需将插件的所有功能写在一个立即执行函数中:

(function(window, factory, plug) {
    factory(jQuery, plug)
})(this, function(jQuery, plug) {
   ...
}, "dataResult");

2,插件默认参数

插件的主要功能可以总结至几个关键参数,通过这几个关键参数即可修改插件的主要功能,也是第三步API设置的关键参数。

将默认参数放置在全局函数的最前面,参数变量名为options,通过对象字面量进行赋值:

var options = {
key1: para1,
key2: para2,
key3: para3,
...
keyn: paran
}

//插件默认
    var define = {
        initEvent: "input",
        plugName: "dir"
    };
    //数据校验
    var _RULES_ = {
        "regexp": function(data) {
            return new RegExp(data).test(this.val());
        },
        "required": function(data) {
            return this.val();
        },
        "min-length": function(data) {
            return this.val().length > data;
        },
        "confirm": function() {
            var passElement = $(":password")[0];
            if (passElement.value == "" || this.val() == passElement.value) {
                return false;
            } else {
                return true;
            }
        }
    }

3,插件API、参数设置

因为API指向的是使用者,故需要在用户调用插件时将API暴露给用户,因用户API时是通过插件提供的名字进行使用,故将API设置为Object类型,用户就可以通过调用API的key进行使用,

$.fn[plug] = function(options) {
        if (!this.is('form')) { return }
        this.find = this.find('input');
        $.extend(this, define, options);
        this.find.on(this.initEvent, function() {
            var _this = $(this);
                _this.siblings('p').remove();
            $.each(_RULES_, function(key, fn) {
                var $fileName = _this.data(define.plugName + "-" + key);
                var $message = _this.data(define.plugName + "-" + key + "-message");
                
                if ($fileName) {
                    var result = fn.call(_this, $fileName);
                    if (!result) {
                        _this.after("<p>" + $message + "</p>")
                    }
                }
            })
        })
    }

4,html前台配置调用

html部分

            <input type="text" class="form-control" data-dir-min-length="4" data-dir-min-length-message ="小于4位" id="exampleInputEmail1" placeholder="user">

js部分

$('form').dataResult();

5,拓展

js插件部分

$.fn[plug].extendResult = function(options) {
            $.extend(_RULES_, options);
        } //jQuery.prototype.dataResult

js调用部分

$.fn.dataResult.extendResult({
        "max-length":function(data){
            console.log(data)
            return this.val().length <= data;
        }
    })

源码使用

html

<!DOCTYPE html>
<html>

<head>
    <meta name=“keywords” content="K">
    <meta name="description" content="D">
    <title></title>
    <link href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet">
    <script src="https://code.jquery.com/jquery.js"></script>
    <script src="index.js"></script>
</head>

<body>
    <form>
        <div class="form-group">
            <label for="exampleInputEmail1">账号</label>
            <input type="text" class="form-control" data-dir-max-length="6" data-dir-max-length-message ="大于6位" data-dir-min-length="4" data-dir-min-length-message ="小于4位" id="exampleInputEmail1" placeholder="user">
        </div>
        <div class="form-group">
            <label for="exampleInputEmail1">邮箱</label>
            <input type="email" class="form-control" id="exampleInputEmail1" placeholder="Email">
        </div>
        <div class="form-group">
            <label for="exampleInputPassword1">密码</label>
            <input type="password" class="form-control" id="exampleInputPassword1" placeholder="Password">
        </div>
        <div class="form-group">
            <label for="exampleInputPassword1">再次输入密码</label>
            <input type="password" class="form-control" id="exampleInputPassword1" placeholder="Password">
        </div>
    </form>
</body>
<script>
    $('form').dataResult();
    $.fn.dataResult.extendResult({
        "max-length":function(data){
            console.log(data)
            return this.val().length <= data;
        }
    })
</script>

</html>

js 插件部分

(function(window, factory, plug) {
    factory(jQuery, plug)
})(this, function(jQuery, plug) {
    //插件默认
    var define = {
        initEvent: "input",
        plugName: "dir"
    };
    //数据校验
    var _RULES_ = {
        "regexp": function(data) {
            return new RegExp(data).test(this.val());
        },
        "required": function(data) {
            return this.val();
        },
        "min-length": function(data) {
            return this.val().length > data;
        },
        "confirm": function() {
            var passElement = $(":password")[0];
            if (passElement.value == "" || this.val() == passElement.value) {
                return false;
            } else {
                return true;
            }
        }
    }
    $.fn[plug] = function(options) {
        if (!this.is('form')) { return }
        this.find = this.find('input');
        $.extend(this, define, options);
        this.find.on(this.initEvent, function() {
            var _this = $(this);
                _this.siblings('p').remove();
            $.each(_RULES_, function(key, fn) {
                var $fileName = _this.data(define.plugName + "-" + key);
                var $message = _this.data(define.plugName + "-" + key + "-message");
                
                if ($fileName) {
                    var result = fn.call(_this, $fileName);
                    if (!result) {
                        _this.after("<p>" + $message + "</p>")
                    }
                }
            })
        })
    }
    $.fn[plug].extendResult = function(options) {
            $.extend(_RULES_, options);
        } //jQuery.prototype.dataResult
}, "dataResult");
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,254评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,875评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,682评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,896评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,015评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,152评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,208评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,962评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,388评论 1 304
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,700评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,867评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,551评论 4 335
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,186评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,901评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,142评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,689评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,757评论 2 351

推荐阅读更多精彩内容