antdv-<a-form>的使用

 是 Ant Design Vue 中用于创建表单的组件,提供了一种结构化的方式来收集用户输入。它支持多种布局、验证、数据绑定等功能,非常适合用于处理用户输入和提交数据。

一、基本使用

 通常与  结合使用,后者用于定义表单中的每个输入项。

二、常见属性

1. model : (Object)

  • 用于指定表单的绑定数据对象。表单项的值会自动与这个对象进行双向绑定。

①数据绑定:

  • model 属性指定了一个对象,表单中的每个输入项(如  等)都会根据 name 属性与这个对象的属性进行绑定。
  • 当用户在表单中输入数据时model 对象中的相应属性会自动更新。同样,当 model 对象中的属性值发生变化时,表单中的输入项也会自动更新。

②验证:

  • model 属性表单验证规则结合使用,可以方便地对用户输入进行验证。通过在  中设置 name 属性并在  中定义相应的验证规则,可以实现自动的验证逻辑

③表单提交:

  • 在表单提交时,可以直接访问 model 对象中的数据,从而获取用户输入的所有信息。

    
    
    
    
    
    
  

2. layout : (String)

  • 用于指定表单的布局方式。可以取值为:
    • "horizontal":水平布局,标签和输入框在同一行。
    • "vertical":垂直布局,标签在输入框上方。
    • "inline":行内布局,适用于简单的表单。

3. size : (String)

  • 用于设置表单的尺寸,可以取值为 "small""default" 或 "large",影响表单控件的大小。

4. rules : (Object)

  • 用于定义表单验证规则。可以在  单独定义,也可以在  中统一定义

    
    

5. ref : (String)

  • 用于创建对表单的引用,以便在 JavaScript 中访问表单的方法,例如验证、重置等。
  • 组件实例的引用:通过 ref 获取的 Vue 组件的实例,可以直接调用组件的方法和访问其状态。
  • DOM 元素的引用:通过 ref 获取的原生 HTML 元素,可以直接操作这些元素(例如聚焦、改变样式等)。

三、常见事件

 组件支持多种事件,以下是几个常用的事件:

1. @finish

  • @finish 事件在表单验证通过时触发并将表单数据作为参数传递给处理函数
  • 当这个事件被触发时,Ant Design Vue 将表单中所有字段的值(即模型数据)作为参数传递给指定的处理函数。

2. @submit

  • 当表单提交时触发,通常用于处理自定义提交逻辑。

3. @reset

  • 当表单重置时触发。

四、结合使用

每个表单项通常由  包裹,主要属性包括:(写在上的)

1. label : (String)

  • 表单项的标签文本。

2. name : (String)

  • 表单项的名称,通常与 model 中的字段名对应,便于进行验证和数据绑定。

3. rules : (Array)

  • 定义该表单项的验证规则,可以是一个数组,包含多个规则对象。
示例代码:

    
      
    
    
      搜索
    

说明:

  • :v-model="searchObj":将表单与 searchObj 进行双向绑定,表单中的输入会自动更新 searchObj 对象。
  • layout="inline":使用行内布局,适合简单的表单。
  •  中的 label 属性用于显示表单项的标签,name 属性用于标识该表单项,便于后续的验证和数据处理。
  • :输入框的值与 searchObj.borrower 进行绑定,当用户输入内容时,searchObj.borrower 会自动更新。
  • :按钮的点击事件会调用 onSearch 方法,通常用于处理搜索逻辑。

你可能感兴趣的:(Ant-Design-Vue,前端,javascript)