2.4 表单数据的验证

简介:

2.4 表单数据的验证


通常情况下,表单的数据是有一定规则的,我们需要依照其规则对输入的数据做验证以及反馈验证结果。Angular 2中对表单验证有非常完善的支持,我们继续上面的例子,在login组件中,我们定义了一个用户名和密码的输入框,现在我们来为它们加上规则。首先我们定义一下规则,用户名和密码都是必须输入的,也就是不能为空。更改login.component.ts中的模板为下面的样子:

<div>

  <input required type="text"

    [(ngModel)]="username"

    #usernameRef="ngModel"

    />

    {{usernameRef.valid}}

  <input required type="password"

    [(ngModel)]="password"

    #passwordRef="ngModel"

    />

    {{passwordRef.valid}}

  <button (click)="onClick()">Login</button>

</div>

注意,我们只是为username和password两个控件加上了required这个属性,表明这两个控件为必填项。通过#usernameRef=”ngModel”我们重新又加入了引用,这次的引用指向了ngModel,这个引用是要在模板中使用的,所以才加入这个引用。如果不需要在模板中使用,可以不要这句。{{表达式}}双花括号表示解析括号中的表达式,并把这个值输出到模板中。

这里我们为了可以显性地看到控件的验证状态,直接在对应控件后输出了验证的状态。初始状态可以看到两个控件的验证状态都是false,试着填写一些字符在两个输入框中,看看状态变化吧,如图2.6所示。

 

图2.6 表单验证状态

我们知道了验证的状态是什么,但是如果我们想知道验证失败的原因怎么办呢?我们只需要将{{usernameRef.valid}}替换成{{usernameRef.errors | json}}即可。|是管道操作符,用于将前面的结果通过管道输出成另一种格式,这里就是把errors对象输出成json格式的意思。看一下结果吧,返回的结果如下,见图2.7。

 

图2.7 管道输出

如果除了不能为空,我们为username再添加一个规则试试看呢,比如字符数不能少于3:

<input type="text"

  [(ngModel)]="username"

  #usernameRef="ngModel"

  required

  minlength="3"

/>

这时打开浏览器,看一下效果,如图 2.8所示。

 

图2.8 多规则验证

现在我们试着把{{表达式}}替换成友好的错误提示,我们想在有错误发生时显示错误的提示信息。那么我们来改造一下template:

<div>

  <input type="text"

    [(ngModel)]="username"

    #usernameRef="ngModel"

    required

    minlength="3"

    />

    {{ usernameRef.errors | json }}

    <div *ngIf="usernameRef.errors?.required">this is required</div>

    <div *ngIf="usernameRef.errors?.minlength">should be at least 3 charactors</div>

  <input required type="password"

    [(ngModel)]="password"

    #passwordRef="ngModel"

    />

    <div *ngIf="passwordRef.errors?.required">this is required</div>

  <button (click)="onClick()">Login</button>

</div>

ngIf也是一个Angular 2的指令,顾名思义,是用于做条件判断的。*ngIf=”

usernameRef.errors?.required”的意思是当usernameRef.errors.required为true时显示div标签。那么,那个?是干嘛的呢?因为errors可能是个null,如果这个时候调用errors的required属性肯定会引发异常,那么?就是标明errors可能为空,在其为空时就不用调用后面的属性了。

如果我们把用户名和密码整个看成一个表单的话,我们应该把它们放在一对<form></form>标签中,类似地加入一个表单的引用formRef:

<div>

  <form #formRef="ngForm">

    <input type="text"

      [(ngModel)]="username"

      #usernameRef="ngModel"

      required

      minlength="3"

      />

      <div *ngIf="usernameRef.errors?.required">this is required</div>

      <div *ngIf="usernameRef.errors?.minlength">should be at least 3 charactors</div>

    <input type="password"

      [(ngModel)]="password"

      #passwordRef="ngModel"

      required

      />

      <div *ngIf="passwordRef.errors?.required">this is required</div>

    <button (click)="onClick()">Login</button>

  </form>

</div>

这时运行后会发现原本好用的代码出错了,这是由于如果在一个大的表单中,ngModel会注册成Form的一个子控件,注册子控件需要一个name,这要求我们显式地指定对应控件的name,因此我们需要为input增加name属性:

<div>

  <form #formRef="ngForm">

    <input type="text"

      name="username"

      [(ngModel)]="username"

      #usernameRef="ngModel"

      required

      minlength="3"

      />

      <div *ngIf="usernameRef.errors?.required">this is required</div>

      <div *ngIf="usernameRef.errors?.minlength">should be at least 3 charactors</div>

    <input type="password"

      name="password"

      [(ngModel)]="password"

      #passwordRef="ngModel"

      required

      />

      <div *ngIf="passwordRef.errors?.required">this is required</div>

    <button (click)="onClick()">Login</button>

    <button type="submit">Submit</button>

  </form>

</div>

既然我们增加了一个formRef,我们就看看formRef.value有什么吧。 首先为form增加一个表单提交事件的处理 <form #formRef=”ngForm” (ngSubmit)=”onSubmit(formRef.value)”>。 然后在组件中增加一个onSubmit方法:

onSubmit(formValue) {

console.log(formValue);

}

你会发现formRef.value中包括了表单所有填写项的值。还是在浏览器Console中观察一下,如图 2.9所示。

 

图 2.9 表单引用

有时候,在表单项过多时需要对表单项进行分组,HTML中提供了fieldset标签用来处理。那么我们看看怎么和Angular 2结合吧:

<div>

  <form #formRef="ngForm" (ngSubmit)="onSubmit(formRef.value)">

    <fieldset ngModelGroup="login">

      <input type="text"

        name="username"

        [(ngModel)]="username"

        #usernameRef="ngModel"

        required

        minlength="3"

        />

        <div *ngIf="usernameRef.errors?.required">this is required</div>

        <div *ngIf="usernameRef.errors?.minlength">should be at least 3 charactors</div>

      <input type="password"

        name="password"

        [(ngModel)]="password"

        #passwordRef="ngModel"

        required

        />

        <div *ngIf="passwordRef.errors?.required">this is required</div>

      <button (click)="onClick()">Login</button>

      <button type="submit">Submit</button>

    </fieldset>

  </form>

</div>

<fieldset ngModelGroup=”login”>意味着我们对于fieldset之内的数据都分组到了login对象中,在浏览器Console中可以看到这个对象的输出,如图 2.10所示。

 

图2.10 表单验证

接下来我们改写onSubmit方法用来替代onClick,因为看起来这两个按钮重复了,我们需要去掉onClick。首先去掉template中的<button (click)="onClick()">Login</button>,然后把<button type="submit">标签后的Submit文本替换成Login,最后改写onSubmit方法:

onSubmit(formValue) {

  console.log('auth result is: '

    + this.service.loginWithCredentials(formValue.login.username, formValue.login.password));

}

在浏览器中试验一下吧,所有功能正常工作。

相关文章
|
3月前
|
JavaScript 前端开发 数据安全/隐私保护
提交表单与验证表单案例
提交表单与验证表单案例
16 0
|
6月前
|
存储
表单的解析
表单的解析
|
7天前
|
JavaScript 前端开发 API
表单输入绑定
表单输入绑定
|
4月前
表单常用验证数据类型,验证一切(checkEverything)
表单常用验证数据类型,验证一切(checkEverything)
|
4月前
|
存储 前端开发 Java
①实现基于session的登录流程:发送验证码、登录注册、校验登陆状态
①实现基于session的登录流程:发送验证码、登录注册、校验登陆状态
62 0
|
开发者
【示例中心案例分享】表单中级联组件配置表单数据源
宜搭的级联组件不像下拉选择一样可配置关联其他选项,但是每次手动配置级联选项又很痛苦,我们如何借助宜搭的 OpenApi 去实现这个功能呢?我们的三方开发者 「苏灏」带来了他的案例。
391 1
|
设计模式 JavaScript 数据库
表单防止重复提交的四种方式
表单防止重复提交的四种方式
185 0
|
前端开发 数据处理
前端表单数据那些事
前言:这段时间一直在搞to B方向中后台的项目,表单接触的频率会比较多,就突发奇想聊聊表单数据相关的一些基础分享
261 0
前端表单数据那些事