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

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

立即尝试

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

1. 将仓库克隆到本地：git clone [e-mail]:vacuumlabs/react-custom-validation.git
2. 进入examples目录：cd react-custom-validation/examples
3. 安装依赖：npm install
4. 运行示例：npm run example
5. 打开浏览器访问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>
  )
}

设计理念

React Custom Validation的理念是将数据验证与何时显示验证结果这两个独立的过程分离开来。这样可以确保即使在用户未触碰某些字段或者输入过程中也能提供合理的反馈。例如，在用户修改输入时隐藏错误提示，但当他们移开焦点后立即显示。

功能特性

• 自动计算输入值变更后的有效性
• 显示/隐藏验证结果的智能建议
  • 用户输入时隐藏
  • 未触碰过的字段保持隐藏
  • 输入完成后立即显示
• 定义和使用自定义验证规则
• 多个字段的联合验证
• 异步验证
• 延迟执行（debouncing）/ 指定间隔执行（throttling）
• 条件验证
• 灵活性和可扩展性：易于与其他验证策略结合使用

该库专为React设计，也可以很好地与Redux配合使用，并能轻松集成React-Intl或其他国际化解决方案。

结论

React Custom Validation提供了一套强大的工具，帮助你在React应用中实现复杂的表单验证逻辑，同时保证了优秀的用户体验。其设计理念和广泛的功能使其成为管理用户输入验证的理想选择。立即尝试，让你的表单验证变得优雅而高效！