推荐使用：React验证库React Custom Validation

2024-06-18 05:51:27作者：尤峻淳Whitney

react-custom-validation

**打造卓越用户体验的表单验证库** React Custom Validation是一个专为提升用户交互体验设计的客户端验证库。它不走捷径，要求你动手编写验证逻辑，作为回报，则赋予应用极高的灵活性和自定义能力。通过简单的配置到复杂动态字段管理，这个库让你轻松实现高效表单验证。从基础的邮箱、密码匹配，到动态增减字段的高级场景，它都能胜任。借助详细的示例和高度模块化的规则定义，无论是新手还是专家，都能迅速上手，创建既健壮又具有良好提示机制的表单。立即尝试，探索如何利用它的自动有效性重算、智能显示隐藏验证提示、异步及条件验证等功能，解锁React应用中表单验证的新境界。

在构建交互式的Web应用中，有效的表单验证是用户体验的关键部分。React Custom Validation是一个客户端验证库，它专注于提供卓越的用户体验。它不承诺简单的魔法解决方案，而是要求开发者编写一些代码以获取更高的灵活性和定制性。通过这种方式，你可以创建出符合你需求且具有出色用户互动性的验证表单。

立即尝试

你可以在此处查看在线示例，或按照以下步骤本地运行：

将仓库克隆到本地：git clone git@github.com:vacuumlabs/react-custom-validation.git
进入examples目录：cd react-custom-validation/examples
安装依赖：npm install
运行示例：npm run example
打开浏览器访问localhost:3000预览

示例1和2展示的是简单情况下的使用方法，建议审查这些例子的代码以便更好地理解和使用此库。示例3则更复杂，演示了如何处理动态添加和删除字段等更复杂的验证场景。

使用示例

让我们通过一个简单的注册表单来了解其工作原理，这个表单包括三个验证字段：电子邮件、密码和确认密码。没有验证的代码可能如下所示：

class RegistrationForm extends React.Component {
  render() {
    let {
      fields: {email, password, rePassword}
      changeEmail,
      ...
    } = this.props

    return (
      <form>
        {/* 邮件输入框 */}
        {/* 密码输入框 */}
        {/* 确认密码输入框 */}
      </form>
    )
  }
}

要为这个React组件添加验证，你需要定义一个函数来从组件的props中计算验证配置：

function validationConfig(props) {
  let {fields: {email, password, rePassword}} = props

  return {
    fields: ['email', 'password', 'rePassword'],
    validations: { ... }
  }
}

@validated(validationConfig)
class RegistrationForm extends React.Component {
  ...
}

然后，使用提供的$field助手函数来处理用户的输入事件，并通知验证库：

@validated(validationConfig)
class RegistrationForm extends React.Component {
  render() {
    let {
      fields: {email, password, rePassword},
      $field, 
      changeEmail, 
      ...
    } = this.props

    return (
      <form>
        <input
          type="text"
          id="email"
          {...$field('email', (e) => changeEmail(e.target.value))}
          value={email}
        />
        {/* 类似代码处理密码和确认密码输入框 */}
      </form>
    )
  }
}

最后，使用$validation属性获取验证状态并决定何时显示错误信息：

render() {
  let {
    ...
    $validation: {
      email: { isValid, error, show },
      ...
    }
  } = this.props

  return (
    <div>
      {show ? `Invalid email (${error.reason})` : 'Valid email!'}
      <!-- 其他元素 -->
    </div>
  )
}