jquery插件讲解：轮播（SlidesJs）+验证（Validation）

SlidesJs（轮播支持触屏）——官网（http://slidesjs.com）

1.简介

SlidesJs是基于Jquery(1.7.1+)的响应幻灯片插件。支持键盘，触摸，css3转换。

2.代码

<!doctype html>
<head>
  <style>
    /* Prevents slides from flashing */
    #slides {
      display:none;
    }
  </style>

  <script src="http://code.jquery.com/jquery-latest.min.js"></script>
  <script src="jquery.slides.min.js"></script>

  <script>
    $(function(){
      $("#slides").slidesjs({
        width: 940,
        height: 528
      });
    });
  </script>
</head>
<body>
  <div id="slides">
    <img src="http://placehold.it/940x528">
    <img src="http://placehold.it/940x528">
    <img src="http://placehold.it/940x528">
    <img src="http://placehold.it/940x528">
    <img src="http://placehold.it/940x528">
  </div>
</body>

API简介

1.设置轮播的宽高（默认值都为 auto）

$("#slides").slidesjs({
    width: 700,
    height: 393
  });

2.设置从那张开始（默认值为 1）

$("#slides").slidesjs({
    start: 3  //这里注意数值从1开始，不是0；默认值0
  });

3.设置上下切换按钮

可以自定样式：

<a class="slidesjs-previous slidesjs-navigation" href="#" title="Previous">Previous</a>
<a class="slidesjs-next slidesjs-navigation" href="#" title="Next">Next</a>

$("#slides").slidesjs({
    navigation: {
      active: true,　　//显示或隐藏前一张后一张切换按钮；默认值为true,
      effect: "slide"　　//设置切换的方式，slide:平滑，fade:渐显；默认值slide
    }
});

4.设置分页切换

可以自定样式：

<ul class="slidesjs-pagination">
　　<li class="slidesjs-pagination-item"><a href="#" data-slidesjs-item="0" class="active">1</a></li>
　　<li class="slidesjs-pagination-item"><a href="#" data-slidesjs-item="1">2</a></li>
　　<li class="slidesjs-pagination-item"><a href="#" data-slidesjs-item="2">3</a></li>
　　<li class="slidesjs-pagination-item"><a href="#" data-slidesjs-item="3">4</a></li>
</ul>

 $("#slides").slidesjs({
    pagination: {
      active: true,　　//显示或隐藏  分页；默认值true
      effect: "slide"　　//这里可以设置切换方式，跟上下页切换一样，但是跟上下页不冲突；默认值slide
    }
  });

5.自动播放

可以自定样式：

<a class="slidesjs-play slidesjs-navigation slidesjs-playing" href="#" title="Play" style="display: none;">Play</a>
<a class="slidesjs-stop slidesjs-navigation" href="#" title="Stop" style="">Stop</a>

$("#slides").slidesjs({
    play: {
      active: true,　　　　//开始自动播放功能；默认值true
      effect: "slide",　　//切换方式，跟上面两个切换方式不冲突；默认值slide
      interval: 5000,　　　//在每一个幻灯片上花费的时间；默认值5000
      auto: false,　　　　　//开始自动播放；默认值false
      swap: true,　　　　　　//显示或隐藏 自动播放和停止按钮；默认值true
      pauseOnHover: false,　　//鼠标移入是否暂停；默认值false
      restartDelay: 2500　　//重启延迟；默认值2500
    }
  });

6.效果配置

$("#slides").slidesjs({
　　effect: {
      slide: {
        speed: 200　　//切换花费的时间；默认值200
      },
      fade: {
        speed: 300,　　//切换花费的时间；默认值300
        crossfade: true　　//交叉切换，设置为false,会看到背景色；默认值true
      }
    }
  });

7.回调函数

$("#slides").slidesjs({
    callback: {
      loaded: function(number) {
        // 幻灯片载入完成时
      },
      start: function(number) {
        // 切换开始时
      },
      complete: function(number) {
        // 切换结束时
      }
    }
  });

validation（表单验证）——官网（http://jqueryvalidation.org）

以下是针对：jQuery Validation Plugin - v1.15.0 - 2/24/2016 版本

注意：jquery Vaildation Engine 跟以下讲的不是同一款插件

示例：

<form action="" id="demo">
        <label for="username">用户名</label><input type="text" name="username" id="username"><br/>
        <label for="password">密码</label><input type="text" name="password" id="password"><br/>
        <label for="password_confirm">确认密码</label><input type="text" name="password_confirm"><br/>
        <label for="email">email</label><input type="text" name="email"><br/>
        <input type="submit" value="提交">
    </form>
    <script>
        $(function(){
            $('#demo').validate({
                rules: {　　　　　　　　　　　　　　　　　　　　//规则
                    username: {　　　　　　　　　　　　　　　　//这边的username，取得是form里面  name的值
                        required: true,　　　　　　　　　　　//必填项
                        minlength: 2,　　　　　　　　　　　　//最小长度
                        remote: "http://taojiaqu.com"　　 //url验证配对，只能返回true或false
                    },
                    password: {
                        required: true,
                        minlength: 5
                    },
                    password_confirm: {
                        required: true,
                        minlength: 5,
                        equalTo: "#password"
                    },
                    email: {
                        required: true,
                        email: true,
                        remote: "http://taojiaqu.com"
                    }
                },
                messages: {　　　　　　　　　　　　　　　　//错误显示，跟上面的一一对应，没有设置的话，会显示默认的
                    username: {
                        required: '请输入用户名',
                        minlength: '用户名最小为2',
                        remote: "该用户名被使用了"
                    },
                    password: {
                        required: '请输入密码',
                        minlength: '密码最小长度为5'
                    },
                    password_confirm: {
                        required: '请确认密码',
                        minlength: '密码最小长度为5',
                        equalTo: "两次密码不一致"
                    },
                    email: {
                        required: '请输入邮箱',
                        email: '您输入的邮箱不对',
                        remote: '该邮箱已被实用'
                    }
                },
                errorElement: "b",　　//设置错误标签 b
                errorPlacement: function(error, element) {
　　　　　　　　　　　　//错误操作，error错误信息，element错误input对象
                    element.after(error);
                },
                submitHandler: function() {
　　　　　　　　　　　　//点击提交表单回调函数，如果还有验证不通过择提示错误信息，不执行该函数
                },
                success: function(label,element) {
　　　　　　　　　　　　//验证通过的函数
　　　　　　　　　　　　//element：input对象
　　　　　　　　　　　　//labal：提示信息的对象
                },
                highlight: function(element, errorClass, validClass) {
　　　　　　　　　　　　//上一个验证不通过的话，执行该函数
　　　　　　　　　　　　//element：input对象
　　　　　　　　　　　　//errorClass：错误class类名
　　　　　　　　　　　　//validClass: 确认class类名
                },
                unhighlight:function(element, errorClass, validClass){ 
　　　　　　　　　　　　//上一个验证通过的话，执行该函数   
                }
            })
        })
    </script>

API

1.1方法

validate() – Validates 核心方法

$('#demo').validate({
    rules: {
        //。。。
    },
    messages: {
        //。。。
    }
})

valid() – 验证表单是否通过，返回true或false

$('#taojiaqu').validate()
alert($('#taojiaqu').valid());

rules() – 读取、添加和删除一个元素的规则

$( "#myinput" ).rules();　　//返回一个规则对象
$( "#myinput" ).rules( "add", {
  required: true,
  minlength: 2,
  messages: {
    required: "Required input",
    minlength: jQuery.validator.format("Please, at least {0} characters are necessary")
  }
});

$( "#myinput" ).rules( "remove" );//移除全部

$( "#myinput" ).rules( "remove", "min max" );

//移除min max

1.2公共方法

Validator.form() – 验证表单

Validator.element() – 验证指定的 input

validator.element( "#myselect" );

Validator.resetForm() – 重置表单

Validator.showErrors() – 显示错误信息

Validator.numberOfInvalids() – 返回错误的字段数

1.3静态方法

jQuery.validator.addMethod( name, method [, message ] ) – 添加自定义验证方法

//返回true或false
jQuery.validator.addMethod("domain", function(value, element) {
  return this.optional(element) || /^http:\/\/taojiaqu.com/.test(value);
}, "错误信息");

jQuery.validator.format( template, argument, argumentN… ) – 格式化字符串

var format=jQuery.validator.format("{0}--{1}--{2}");
console.log(format("a","b","c"));　　//a--b--c

jQuery.validator.setDefaults() – 修改默认设置

jQuery.validator.setDefaults({
  debug: true　　　　//所有的都设置debug模式
});

jQuery.validator.addClassRules() – 统一添加某个类的校验规则

//添加class为name的校验规则：必填，最小长度为2
jQuery.validator.addClassRules("name", {
  required: true,
  minlength: 2
});

2.选择器

:blank – 选择value值为空的input

:filled – 选择value有值的input

:unchecked – 选择未被选中的 checkbox

3.验证规则

required – 必填，默认true

remote – 远程请求验证，请求地址返回true或false

minlength – 最小长度，中文字算1个字符

maxlength – 最大长度

rangelength – 给定长度范围，例：[2,5]

min – 最小值，数值型

max – 最大值

range – 给定最大最小取值范围，例：[2,100]

step – 设置步骤

email – 必须是一个邮箱email格式

url – 必须是一个地址url

date – 必须输入正确格式的日期

dateISO – 必须输入正确格式的日期(ISO)，例如：2009-06-23，1998/01/22 只验证格式，不验证有效性

number – 必须输入合法的数字(负数，小数)

digits – 必须输入整数

equalTo：'#abc' – 输入值必须和#abc相同

以下验证规则需加载——additional-methods.min.js

accept – 验证上传的文件MINE类型，例：accept："image" ;多种类型逗号（，）隔开

creditcard – 验证信用卡卡号

extension – 验证上传的文件的后缀，例：extension："dll|exe" ;;多种类型逗号（|）隔开

phoneUS – 验证是否为美国号码

require_from_group – 设置类目中有N个是必填项

mobile_phone: {
    require_from_group: [1, ".phone-group"]　　//这边的1表示  三项中只需要填写一项就可以，后面是class名
},
home_phone: {
    require_from_group: [1, ".phone-group"]
},
work_phone: {
    require_from_group: [1, ".phone-group"]
}

4.validate()方法的配置项

debug — 开启关闭debug模式，阻止提交

$(".selector").validate({
  debug: true
});

submitHandler — 通过验证后运行的函数，可以加上表单的提交方法

$(".selector").validate({
  submitHandler: function(form) {
    $(form).ajaxSubmit();
  }
});



$(".selector").validate({
  submitHandler: function(form) {
    form.submit();
  }
});

invalidHandler — 验证没通过，提交时触发的方法

$(".selector").validate({
  invalidHandler: function(event, validator) {
       //event :自定义事件对象
        //validator:当前验证的实例
  }
});

ignore — 对某些元素不进行验证

$("#myform").validate({
  ignore: ".ignore"
});

rules — 定义校验规则，有个隐藏的参数 depends:在满足什么条件下才验证次规则

$(".selector").validate({
  rules: {
    name: "required",
    email: {
      required: true,
      email: true
    }
  }
});



$(".selector").validate({
  rules: {
    name: ｛
　　　　depends：function(element){reruen true;}    //返回true的话才校验,name是否必填
　　｝,
    email: {
      email: true,
　　　　min:{
　　　　　　param:15,　　//单独值的话 用param 代替
　　　　　　depends：function(element){reruen true;}
　　　　}

    }
  }
});

messages — 定义提示信息

$(".selector").validate({
  rules: {
    name: "required",
    email: {
      required: true,
      email: true
    }
  },
  messages: {
    name: "请输入您的名字",
    email: {
      required: "请输入的的邮箱",
      email: "请输入正确的邮箱地址"
    }
  }
});

groups — 对一组元素的验证，用一个错误提示，用errorPlacement 控制出错信息的位置

$("#myform").validate({
  groups: {
    username: "fname lname"
  },
  errorPlacement: function(error, element) {
    if (element.attr("name") == "fname" || element.attr("name") == "lname" ) {
      error.insertAfter("#lastname");
    } else {
      error.insertAfter(element);
    }
  }
});

onsubmit —是否在提交时验证

onfocusout —是否在获取焦点时验证

onkeyup — 是否在敲击键盘时验证

onclick — 是否在鼠标点击数验证

focusInvlid — 提交表单，未通过验证的表单是否获得焦点（默认第一个）

focusCleanup — 提交表单，未通过验证的表单是否移除错误信息

errorClass — 指定错误提示的class类名

validClass — 指定验证通过的class类名

errorElement — 使用什么标记错误标签

$(".selector").validate({
  errorElement: "em"
});
//<em>错误信息</em>

wrapper — 使用什么标签把上面的errorElement 包起来

errorLableContainer — 把错误信息统一放在一个容器里面

errorContainer — 显示或隐藏验证信息，可以自动实现有错误信息出现时把容器属性变为显示，无错误时隐藏

showErrors — 可以显示总的多少个未通过验证

errorPlacement：function(error,element) — 自定义错误信息的位置,error:错误信息、element：验证的元素

success — 要验证的元素通过验证后的回调

highlight — 可以为未通过的元素加效果

unhighlight — 可以为通过的元素加效果

后面举例的方法，都是function方法 , 具体带的参数上面的示例都有注释。

posted @ 2016-07-12 10:12 羯瑞阅读(4277) 评论(3) 编辑收藏举报

刷新页面返回顶部

羯瑞

所谓成功，就是不停地经历失败，并且始终保持热情...

jquery插件讲解：轮播（SlidesJs）+验证（Validation）

SlidesJs（轮播支持触屏）——官网（http://slidesjs.com）

API简介

validation（表单验证）——官网（http://jqueryvalidation.org）

API

公告