本文翻译自:http://dojotoolkit.org/documentation/tutorials/1.7/validation/
在这篇教程中,你将学习如何利用dojox/validate某爱去验证表单值的有效性。
* 难度: 初级* Dojo版本: 1.7
开始
dojox/validate是一个包含了很多通用验证逻辑的工具集,比如检查email地址的合法性,邮政编码,电话号码等等。这些工具都是纯API逻辑的,并不包含用户界面。但是可以很容易被用于各种有验证功能的控件。在这个教程中,我们将看看dojox/validate下有哪些可用的工具,以及如何直接使用或者结合dijit使用。
开始用这些工具之前,首先require对应的模块:
require(["dojox/validate"], function(validate) { });
validate.isInRange(test, options); validate.isNumberFormat(test, options); validate.isText(test, options); validate.isValidLuhn(test);
var test = validate.isNumberFormat(someNum, { format: "(###) ###-####" });
var test = validate.isNumberFormat(someNum, { format: ["### ##", "###-##", "## ###"] });
其他的验证方法
很显然上面的4个方法还远远不够,dojox/validate还包含了很多其他的验证规则供你使用,比如:
validate.creditCard validate.isbn validate.web
require(["dojox/validate/web"], function(validate) { validate.isEmailAddress(someAddress); });
如果你的应用使用直接的HTML表单Form,dojox/validate提供了一个称之为check的模块,可以让你去定义一个验证逻辑的配置文件(profile),你可以用这个配置文件来确保表单中的输入值都是有效的。这个配置文件是一个javascript对象,功能相当强大,它提供了filter来过滤表单值,定义了哪些表单域是必须的,定义了表单域的相互依赖(比如一个表单域依赖于另外一个表单域),定义了值的规则,以及需要确认的表单域(例如:密码值通常要输入两遍以确认)。
要使用一个合法性检查器,需要如下的代码:
// Since dojox/validate/check and dojox/validate/web extend dojox/validate, we don't need to explicitly require it require(["dojox/validate/check", "dojox/validate/web"], function(validate) { var profile = { trim: [ "field1", "field2" ], required: [ "field1", "pwd", "pwd2" ], constraints: { field1: myValidationFunction, field2: [validate.isEmailAddress, false, true] }, confirm: { pwd2: "pwd" } } // later on in the app, probably onsubmit on the form: var results = validate.check(document.getElementById, profile); });
isSuccessful(): Returns true if there were no invalid or missing fields, else it returns false. hasMissing(): Returns true if the results contain any missing fields. getMissing(): Returns a list of required fields that have values missing. isMissing(field): Returns true if the field is required and the value is missing. hasInvalid(): Returns true if the results contain fields with invalid data. getInvalid(): Returns a list of fields that have invalid values. isInvalid(field): Returns true if the field has an invalid value.
View Demo
dojox/validate/check的文档并不是非常完整,但是源代码的注释里面有如何构造profile的详细信息。
在基于Dijit的表单里使用dojox/validate
当然,你也可以结合dojox/validate和dijit一起使用,特别是dijit的ValidationTextBox。这里的关键是ValidationTextBox的validator方法。在HTML标记或者程序创建的Dijit里,你所需要的只是指定一个validator:
require(["dijit/form/ValidationTextBox", "dojox/validate/web"])
<input id="email" name="email" data-dojo-type="dijit.form.ValidationTextBox" data-dojo-props="validator:dojox.validate.isEmailAddress, invalidMessage:'This is not a valid email!'" />
<input id="range" name="range" data-dojo-type="dijit.form.ValidationTextBox" data-dojo-props="validator:dojox.validate.isInRange, constraints:{ min:10, max:100 }, invalidMessage:'This is not within the range of 10 to 100!'" />
结语
综上所述,dojox/validate提供了很多常用且强大的验证逻辑,同时这些逻辑也是高度可定制的。无论在纯的HTML表单还是使用了Dijit的表单,你都可以很方便的使用这些验证逻辑,从而提高开发的效率。