Skip to main content

表单组件的校验触发方式

在微搭低代码平台中,输入框类组件(如文本输入框、数字输入框、密码输入框等)提供了多种校验触发方式,以满足不同的用户交互需求。本文将详细介绍这些校验触发方式及其适用场景。

校验触发方式概述

微搭低代码平台支持以下几种校验触发方式:

  1. 输入时校验(onChange):用户在输入过程中实时触发校验

  2. 失去焦点时校验(onBlur):用户完成输入并将焦点移出输入框时触发校验

  3. 提交时校验(onSubmit):表单提交时触发校验

  4. 其它事件:除了上述三种标准触发方式外,还可以自定义触发方式

如果使用表单容器组件,则在提交时自动触发校验

如何设置校验触发方式

在微搭低代码编辑器中,您可以通过以下步骤设置输入框组件的校验触发方式:

  1. 在编辑器中选中需要设置的输入框组件
  2. 在右侧属性面板中找到"状态/校验"部分
  3. 设置自定义校验规则,这里支持正则的方式
  4. 选择所需的触发方式(输入时、失去焦点时或提交时,这里以失焦触发为例)

各触发方式的适用场景

输入时校验(onChange)

适用场景

  • 需要即时反馈的场景,如密码强度提示
  • 字符数量限制的实时提示
  • 需要引导用户正确输入的场景

优点

  • 提供即时反馈
  • 用户体验更加流畅
  • 可以在用户完成输入前纠正错误

缺点

  • 可能会频繁触发校验,增加系统负担
  • 对于需要完整输入才能判断的校验规则不太适用
  • 可能会在用户输入过程中频繁显示错误提示,造成干扰

失去焦点时校验(onBlur)

适用场景

  • 需要在用户完成当前字段输入后立即验证的场景
  • 输入内容需要完整性校验的场景
  • 既要保证用户体验又要及时反馈的平衡场景

优点

  • 不会打断用户的输入流程
  • 在用户完成输入后立即提供反馈
  • 减少校验触发频率,降低系统负担

缺点

  • 用户可能需要回到之前的字段修改错误

提交时校验(onSubmit)

适用场景

  • 复杂表单场景,多个字段之间存在依赖关系
  • 需要一次性验证所有输入的场景
  • 对用户干扰最小的场景

优点

  • 不会打断用户的输入流程
  • 减少校验触发频率,系统负担最小
  • 适合一次性验证多个相互关联的字段

缺点

  • 用户只能在提交时才能发现错误
  • 可能需要用户回溯查找并修复多个错误

常见问题

Q1: 如何在同一个输入框中设置多种校验触发方式?

A1: 在微搭低代码平台中,您可以通过数组形式设置多种触发方式,例如:['onChange', 'onBlur'],这样校验会同时在输入时和失去焦点时触发。

Q2: 校验触发方式会影响表单提交吗?

A2: 无论您选择何种校验触发方式,在表单提交时都会进行一次全面校验。触发方式主要影响的是用户交互过程中何时进行校验。

Q3: 如何处理依赖于其他字段值的校验?

A3: 对于依赖其他字段值的校验(如"确认密码"需要与"密码"字段比对),建议使用失去焦点或提交时校验,并在校验函数中获取依赖字段的值进行比对。

总结

选择合适的校验触发方式对于提升表单的用户体验至关重要。通过合理配置校验触发时机,可以在用户友好性和数据准确性之间取得平衡。在实际应用中,应根据具体场景和需求,灵活选择和组合不同的校验触发方式。