alain表单使用方式详解

Angular提供两种不同的架构范式表单:模板驱动和响应式表单,官网也简单实现了动态表单范例。

当使用两种不同范式构建一个用户必填性的表单,在使用上有非常大的不同:

模板驱动

@Component({ template: ` <form nz-form (ngSubmit)="onSubmit()"> <nz-form-item> <nz-form-label nzRequired nzFor="name">Name</nz-form-label> <nz-form-control> <input [(ngModel)]="model.name" required #name="ngModel"> <nz-form-explain [hidden]="name.valid || name.pristine">Name is required</nz-form-explain> </nz-form-control> </nz-form-item> </form>` }) export class DemoComponent { }

响应式

@Component({ template: ` <form nz-form [formGroup]="heroForm" (ngSubmit)="onSubmit()"> <nz-form-item> <nz-form-label nzRequired nzFor="name">Name</nz-form-label> <nz-form-control> <input formControlName="name"> <nz-form-explain [hidden]="name.valid || name.pristine">Name is required</nz-form-explain> </nz-form-control> </nz-form-item> </form>` }) export class DemoComponent { ngOnInit(): void { this.heroForm = new FormGroup({ name: new FormControl('', [Validators.required]) }); } get name() { return this.heroForm.get('name'); } }

上述示例只提供核心代码

诚如模板驱动和响应式表单的名称一样。模板驱动以HTML编程风格为主,并且由 ngModel 创建表单控件对象及数据模型管理,相比较响应式表单使用更少的代码(虽然看起来是这样)。

假如对测试非常在意,那么毋庸置疑响应式表单更适合你,因为二者的另一个重要区别是响应式表单数据模型及有效性信息都是同步行为,你可以更容易的测试他它们。

ng-alain表单构建方式

当然这一切都跟 ng-alain 并没有任何决定性关联,ng-alain 只是从使用的角度进一步优化二者的使用方式来做改变。

示例中不管是以HTML、还是以编程风格为主,总是需要很多额外的代码来做布局。

方式一:简易HTML模板表单

因此,当你是以HTML模板为主的表单开发,则简易HTML模板表单组件:shf-item 可能会更适合你,若将上述的示例使用 shf-item 来改变将会这样:

@Component({ template: ` <form nz-form (ngSubmit)="onSubmit()" shf-wrap> <shf-item label="App Key"> <input [(ngModel)]="model.name" required #name="ngModel"> <nz-form-explain [hidden]="name.valid || name.pristine">Name is required</nz-form-explain> </shf-item> </form>` }) export class DemoComponent { }

以之相对于的响应式表单略同,组件单纯只是进一步优化使用方式。

关于错误反馈

错误反馈包含视觉与信息文本两种,上述示例以信息文本为主(嗯,提示必填性真傻)。

视觉效果在ng-zorro-antd里,是将目标元素以红色边框线来表示(因此对于那些没有边框或没有特殊处理的都无法体现)。

建议:除特殊错误文本以外,可以只考虑以视觉效果来反馈错误。

关于校验

Angular 实现了部分HTML5标准常规属性,例如:required、maxlength 等等;而 ng-zorro-antd 的所有数据录入组件都包含了一些额外的数据限定条件,例如:nz-input-number 有效范围(nzMin、nzMax、nzStep)。当然可以进一步归纳业务校验逻辑,例如异步校验手机号码 mobile (可参考)。

小结

shf-item 是以简化HTML布局开发的组件,自身会维护 ngModel 的状态变化并对目标元素增加 .has-error 样式类名,它始终保持视觉效果的体现。

方式二:动态表单

动态表单 @delon/form 是一个基于 JSON Schema 标准的动态构建表单;它是一个独立的类库,你可以在任何 ng-zorro-antd 项目中使用。

同样以相同的示例,其代码会有趣得多:

@Component({ template: `<sf [schema]="schema" (formSubmit)="submit($event)"></sf>` }) export class DemoComponent { schema: SFSchema = { properties: { name: { type: 'string' } }, required: [ 'name' ] } }

动态表单始终以一个JSON对象来构建表单,哪怕该对象来自远程。

@delon/form 内置仅实现 ng-zorro-antd 数据录入组件部分,你依然可以通过自定义小部件 方法实现一套属于自己业务部件库。

数据结构与UI

一个完整的表单元素我们认为应该包含以下若干元素:

alain表单使用方式详解

JSON Schema 重点在于数据结构校验,而对于UI层面可以通过 <sf [ui]="ui"> 来额外增强 UI 渲染,例如:

schema = { properties: { url: { type: 'string', title: 'Web Site' } } }

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:http://www.heiqu.com/7155629a6a7169ecb6d0106464eaffc5.html