表单验证是Web开发中必不可少的一个环节,用来限制用户输入数据的规范和一致性。那么如何能够简化这一任务,让开发人员通过简单的属性设置就能达到目的呢?
FineUI在这一点上也是下足了功夫,比Asp.Net原生的CompareValidator、RangeValidator、RequiredFieldValidator等控件好用多了,眼见为实,下面就来详细介绍如何在FineUI进行表单验证。
如何验证表单?
可以通过如下两步来完成表单的验证。- 为每个表单控件设置验证属性。
比如为TextBox设置Required=”true”和ShowRedStar=”true”两个属性,表示此输入为必填项,并且在标签的后面显示一个红色的星号提示。详细内容会在下一节讲解。
- 通过按钮属性设置需要验证的表单。
ValidateForms:需要验证的表单名称列表(逗号分隔),可以指定点击按钮时同时验证多个表单。
ValidateTarget:验证失败时提示对话框弹出位置,可以是Target.Self、Target.Parent、Target.Top。在框架页面中,你可能希望弹出的提示信息能够覆盖整个页面,而不仅仅是IFrame的部分页面。
除此之外,还有一些属性用来控制表单验证的行为,分为三个级别的控制:
- Web.config级别的控制
分别有FormMessageTarget、FormOffsetRight、FormLabelWidth、FormLabelSeparator几个参数来设置,在《FineUI秘密花园(三) — 深入Web.config》已有详细描述。
- PageManager级别的控制
同样是这四个属性,在《FineUI秘密花园(四) — 每个页面需要一个PageManager》一文中也有详细的描述。
- Form、SimpleForm表单级别的控制
可以通过LabelWidth和LabelSeparator两个属性进行控制。
表单控件与验证相关的通用属性
所谓的通用属性指的是DropDownList、DatePicker、NumberBox、TextArea、TextBox等表单控件都有的验证属性,可以分为以下几类:- 是否为必填项
Required(布尔):是否为必填项
RequiredMessage(字符串):为空时提示信息- 正则表达式
Regex(字符串):必须满足的正则表达式
RegexMessage(字符串):不满足正则表达式时提示信息 RegexPattern(枚举):正则表达式常用类型 RegexPattern.NUMBER:数字 RegexPattern.ALPHA:大写和小写字母 RegexPattern.ALPHA_NUMERIC:字母和数字 RegexPattern.ALPHA_UNDERLINE:字母和下划线 RegexPattern.ALPHA_NUMERIC_UNDERLINE:字母数字和下划线 RegexPattern.ALPHA_LOWER_CASE:小写字母 RegexPattern.ALPHA_UPPER_CASE:大写字母 RegexPattern.EMAIL:电子邮箱 RegexPattern.URL:网址 RegexPattern.POSTAL_CODE:邮政编码 RegexPattern.IP_ADDRESS:IP地址 RegexPattern.IDENTITY_CARD:身份证号(不错吧,还有国内的18位身份证号) 其中RegexPattern非常有用,内置了很多我们经常用到的正则表达式。- 长度限制
MaxLength(整数):最大长度
MaxLengthMessage(字符串):超过最大长度时提示信息 MinLength(整数):最小长度 MinLengthMessage(字符串):少于最小长度时提示信息- 比较(包括与控件值比较、与常量比较)
CompareControl(字符串):需要比较的控件ID
CompareValue(字符串):需要比较的值 CompareOperator(枚举):比较操作符 Operator.Equal(默认值) Operator.GreaterThan Operator.GreaterThanEqual Operator.LessThan Operator.LessThanEqual Operator.NotEqual CompareType(枚举):比较的类型 CompareType.Float CompareType.Int CompareType.String(默认值) CompareMessage(字符串):不满足比较条件时提示信息 其中,CompareType有时会起到关键的作用,比如在比较两个数字输入框的值时,如果不设置CompareType,则输入值“3”会大于“10”。表单控件特有的限制属性
有一些控件拥有自己特有的限制属性,下面会列举出来。- 日期选择控件(DatePicker)
MinDate(日期):最小日期限制
MaxDate(日期):最大日期限制- 数字输入框(NumberBox)
MinValue(浮点数):最小值
MaxValue(浮点数):最大值 NoNegative(布尔):不允许负数 NoDecimal(布尔):不允许小数 DecimalPrecision(整数):小数点后的位数(默认为2)客户端验证示例
1. 同时验证多个表单这个非常简单,只需要在ValidateForms中指定要验证表单的ID即可(逗号分隔)。