JavaScript/Jquery:Validform 验证表单的相关属性解释
当我们写提交表单的时候往往需要验证表单是否填写了内容,是否正确,这个插件可以很方便的完成我们需要的验证!
使用方法:
1、先引用js
<script type=
"text/javascript"
src=
"/js/jquery-1.6.2.min.js"
></script>
<script type=
"text/javascript"
src=
"/js/Validform_v5.1_min.js"
></script>
2、给需要验证的表单元素绑定附加属性
<
form
class
=
"demoform"
>
<
input
type
=
"text"
value
=
""
name
=
"name"
datatype
=
"s5-16"
errormsg
=
"昵称至少5个字符,最多16个字符!"
/>
</
form
>
3、初始化,就这么简单
<
script
type
=
"text/javascript"
>
$(function(){
$("#demoform").Validform();
})
</
script
>
凡要验证格式的元素均需绑定datatype属性,datatype可选值内置有10类,用来指定不同的验证格式。
如果还不能满足您的验证需求,可以传入自定义datatype,自定义datatype是一个非常强大的功能,通过它可以满足你的任何需求。
可以绑定的附加属性有:datatype、nullmsg、sucmsg、errormsg、ignore、recheck、tip、altercss、ajaxurl 和 plugin
<!--ajax实时验证用户名-->
<
input
type
=
"text"
value
=
""
name
=
"name"
datatype
=
"e"
ajaxurl
=
"valid.php?myparam1=value1&myparam2=value2"
sucmsg
=
"用户名验证通过!"
nullmsg
=
"请输入用户名!"
errormsg
=
"请用邮箱或手机号码注册!"
/>
<!--密码-->
<
input
type
=
"password"
value
=
""
name
=
"userpassword"
datatype
=
"*6-15"
errormsg
=
"密码范围在6~15位之间!"
/>
<!--确认密码-->
<
input
type
=
"password"
value
=
""
name
=
"userpassword2"
datatype
=
"*"
recheck
=
"userpassword"
errormsg
=
"您两次输入的账号密码不一致!"
/>
<!--默认提示文字-->
<
textarea
tip
=
"请在这里输入您的意见。"
errormsg
=
"很感谢您花费宝贵时间给我们提供反馈,请填写有效内容!"
datatype
=
"s"
altercss
=
"gray"
class
=
"gray"
name
=
"msg"
value
=
""
>请在这里输入您的意见。</
textarea
>
<!--使用swfupload插件-->
<
input
type
=
"text"
plugin
=
"swfupload"
class
=
"inputxt"
disabled
=
"disabled"
value
=
""
>
<
input
type
=
"hidden"
value
=
""
pluginhidden
=
"swfupload"
>
<!--使用passwordStrength插件-->
<
input
type
=
"password"
errormsg
=
"密码至少6个字符,最多18个字符!"
datatype
=
"*6-18"
plugin
=
"passwordStrength"
class
=
"inputxt"
name
=
"password"
value
=
""
>
<
div
class
=
"passwordStrength"
style
=
"display:none;"
><
b
>密码强度:</
b
> <
span
>弱</
span
><
span
>中</
span
><
span
class
=
"last"
>强</
span
></
div
>
<!--使用DatePicker插件-->
<
input
type
=
"text"
plugin
=
"datepicker"
class
=
"inputxt"
name
=
"birthday"
value
=
""
>
一些参数说明:
datatype
内置基本的datatype类型有: * | *6-16 | n | n6-16 | s | s6-18 | p | m | e | url
*:检测是否有输入,可以输入任何字符,不留空即可通过验证;
*6-16:检测是否为6到16位任意字符;
n:数字类型;
n6-16:6到16位数字;
s:字符串类型;
s6-18:6到18位字符串;
p:验证是否为邮政编码;
m:手机号码格式;
e:email格式;
url:验证字符串是否为网址。
自定义datatype的名称,可以由字母、数字、下划线、中划线和*号组成。
形如"*6-16"的datatype,Validform会自动扩展,可以指定任意的数值范围。如内置基本类型有"*6-16",那么你绑定datatype="*4-12"就表示4到12位任意字符。如果你自定义了一个datatype="zh2-4",表示2到4位中文字符,那么datatype="zh2-6"就表示2到6位中文字符。
5.2版本之后,datatype支持规则累加或单选。用","分隔表示规则累加;用"|"分隔表示规则多选一,即只要符合其中一个规则就可以通过验证,绑定的规则会依次验证,只要验证通过,后面的规则就会忽略不再比较。如绑定datatype="m|e",表示既可以填写手机号码,也能填写邮箱地址,如果知道填入的是手机号码,那么就不会再检测他是不是邮箱地址;datatype="zh,s2-4",表示要符合自定义类型"zh",也要符合规则"s2-4"。
-
nullmsg
当表单元素值为空时的提示信息,不绑定,默认提示"请填入信息!"。
如:nullmsg="请填写用户名!"
5.3版开始,对于没有绑定nullmsg的对象,会自动查找class为Validform_label下的文字作为提示文字:
如这样的html结构:
<span class="Validform_label">*用户名:</span><input type="text" val="" datatype="s" />
当这个文本框里没有输入时的出错信息就会是:"请输入用户名!"
这里Validform_label跟input之间的位置关系,不一定是要同级关系,同级里没有找到的话,它还会在同级的子级、父级的同级、父级的同级的子级里查找。 -
sucmsg 5.3+
当表单元素通过验证时的提示信息,不绑定,默认提示"通过信息验证!"。
如:sucmsg="用户名还未被使用,可以注册!"
5.3版开始,也可以在实时验证返回的json数据里返回成功的提示文字,请查看附加属性ajaxurl的介绍。 -
errormsg
输入内容不能通过验证时的提示信息,默认提示"请输入正确信息!"。
如:errormsg="用户名必须是2到4位中文字符!"
5.3版开始,Validform可以根据你绑定的datatype智能的输出相应出错信息,具体介绍请查看tipmsg -
ignore
绑定了ignore="ignore"的表单元素,在有输入时,会验证所填数据是否符合datatype所指定数据类型,
没有填写内容时则会忽略对它的验证; -
recheck
表单里面经常需要检查两次密码输入是否一致,recheck就是用来指定需要比较的另外一个表单元素。
如:recheck="password1",那么它就会拿当前元素的值跟该表单下,name为"password1"的元素比较。 -
tip
表单里经常有些文本框需要默认就显示一个灰色的提示文字,当获得焦点时提示文字消失,失去焦点时提示文字显示。tip属性就是用来实现这个效果。它通常和altercss搭配使用。
如<input type="text" value="默认提示文字" class="gray intxt" tip="默认提示文字" altercss="gray" /> -
altercss
它需要和tip属性配合使用,altercss指定的样式名,会在文本框获得焦点时被删除,没有输入内容而失去焦点时重新加上。 -
ajaxurl
指定ajax实时验证的后台文件的地址。
后台页面如valid.php文件中可以用 $_POST["param"] 接收到值,Ajax中会POST过来变量param和name。param是文本框的值,name是文本框的name属性。