
当在formik的field组件中使用type="number"时,原生的html min和max属性可能无法提供健壮的客户端校验。本教程将演示如何在formik应用中,利用强大的yup schema验证库,为数字输入框有效地实现范围校验,从而确保数据完整性并提升用户体验。
在使用Formik构建表单时,我们经常会遇到需要对数字输入框进行范围限制的场景,例如要求用户输入的年龄介于18到65岁之间,或者百分比值在0到100之间。虽然HTML <input type="number" min="X" max="Y"> 元素提供了原生的min和max属性来限制输入范围,但这些属性主要在浏览器层面提供视觉提示和基础的验证,其行为可能因浏览器而异,并且容易被用户绕过。为了在Formik应用中实现更一致、健壮且用户友好的客户端验证,我们应该利用Formik强大的验证生态系统,特别是结合像Yup这样的验证库。
HTML的min和max属性在<input type="number">上确实能提供一些初步的限制:
然而,这些限制存在局限性:
因此,为了实现可靠的客户端验证,推荐使用Formik的validationSchema或Field组件的validate prop。
Yup是一个流行的JavaScript schema验证库,它与Formik完美集成,提供了一种声明式的方式来定义数据结构和验证规则。对于数字类型的输入,Yup提供了.number()方法,并结合.min()和.max()方法来定义范围约束。
首先,确保你的项目中已安装Yup:
npm install yup # 或 yarn add yup
创建一个Yup schema,其中包含对数字字段的验证规则。例如,我们希望一个名为percentage的字段其值介于0到100之间:
import * as Yup from 'yup';
const MyValidationSchema = Yup.object().shape({
// 假设我们有一个名为 'percentage' 的数字字段
percentage: Yup.number()
.typeError('请输入一个有效的数字') // 当输入非数字时显示
.min(0, '百分比不能小于0') // 最小值校验,并提供自定义错误信息
.max(100, '百分比不能大于100') // 最大值校验,并提供自定义错误信息
.required('百分比是必填项'), // 必填校验
// 如果有其他字段,可以在这里添加它们的验证规则
// 例如:firstName: Yup.string().required('姓名为必填项'),
});在你的Formik组件中,通过validationSchema prop传入你定义的Yup schema。Formik会自动处理字段值的验证,并在errors和touched对象中提供验证结果。
完整示例代码:
以下是一个结合Formik和Yup实现数字范围校验的完整示例:
import React from 'react';
import { Formik, Form, Field } from 'formik';
import * as Yup from 'yup';
// 定义验证Schema
const ItemValidationSchema = Yup.object().shape({
// 假设我们正在验证一个数组中的某个项,例如 itemsAndServices[index].percentage
// 为了简化示例,我们直接验证一个名为 'percentage' 的字段
// 如果是嵌套结构,Yup支持类似 'itemsAndServices[0].percentage' 这样的路径
percentage: Yup.number()
.typeError('请输入一个有效的数字')
.min(0, '百分比不能小于0')
.max(100, '百分比不能大于100')
.required('百分比是必填项'),
itemName: Yup.string().required('项目名称是必填项'),
});
const NumberRangeValidationForm = () => (
<div style={{ padding: '20px', maxWidth: '400px', margin: 'auto', border: '1px solid #ccc', borderRadius: '8px' }}>
<h2>数字范围校验示例</h2>
<Formik
initialValues={{
percentage: 50, // 初始值
itemName: '服务A',
}}
validationSchema={ItemValidationSchema} // 传入Yup Schema
onSubmit={(values, { setSubmitting }) => {
// 模拟异步提交
setTimeout(() => {
alert('提交成功!\n' + JSON.stringify(values, null, 2));
setSubmitting(false);
}, 400);
}}
>
{({ errors, touched, isSubmitting }) => (
<Form>
<div style={{ marginBottom: '15px' }}>
<label htmlFor="itemName" style={{ display: 'block', marginBottom: '5px' }}>项目名称</label>
<Field name="itemName" type="text" style={{ width: '100%', padding: '8px', boxSizing: 'border-box' }} />
{errors.itemName && touched.itemName ? (
<div style={{ color: 'red', fontSize: '0.85em', marginTop: '5px' }}>{errors.itemName}</div>
) : null}
</div>
<div style={{ marginBottom: '20px' }}>
<label htmlFor="percentage" style={{ display: 'block', marginBottom: '5px' }}>百分比 (0-100)</label>
<Field
name="percentage"
type="number"
// 注意:这里的 min/max 属性仍然可以保留,它们可以作为浏览器层面的辅助提示,
// 但主要的验证逻辑和错误消息由 Yup Schema 和 Formik 处理。
min="0"
max="100"
style={{ width: '100%', padding: '8px', boxSizing: 'border-box' }}
/>
{/* 显示验证错误信息 */}
{errors.percentage && touched.percentage ? (
<div style={{ color: 'red', fontSize: '0.85em', marginTop: '5px' }}>{errors.percentage}</div>
) : null}
</div>
<button
type="submit"
disabled={isSubmitting}
style={{
padding: '10px 20px',
backgroundColor: '#007bff',
color: 'white',
border: 'none',
borderRadius: '5px',
cursor: 'pointer',
opacity: isSubmitting ? 0.7 : 1,
}}
>
{isSubmitting ? '提交中...' : '提交'}
</button>
</Form>
)}
</Formik>
</div>
);
export default NumberRangeValidationForm;在这个示例中,当用户输入一个不在0到100范围内的数字,或者输入非数字字符时,Formik会根据Yup Schema显示相应的错误信息。
除了使用全局的validationSchema,Formik的Field组件也支持一个validate prop。这个prop接受一个函数,该函数会接收字段的值作为参数,并返回一个错误字符串(如果有错误)或undefined(如果没有错误)。
这种方法适用于特定字段的简单、独立的验证逻辑,而无需构建整个Yup schema。例如:
import React from 'react';
import { Formik, Form, Field } from 'formik';
// 在Formik组件内部或外部定义验证函数
const validatePercentage = value => {
let error;
if (value === undefined || value === null || value === '') {
error = '百分比是必填项';
} else if (isNaN(Number(value))) { // 确保转换为数字进行判断
error = '请输入一个有效的数字';
} else if (Number(value) < 0) {
error = '百分比不能小于0';
} else if (Number(value) > 100) {
error = '百分比不能大于100';
}
return error;
};
const FieldValidatePropExample = () => (
<Formik
initialValues={{ percentage: '' }}
onSubmit={values => {
alert(JSON.stringify(values, null, 2));
}}
>
{({ errors, touched }) => (
<Form>
<label htmlFor="percentage">百分比 (0-100)</label>
<以上就是Formik数字输入框的范围校验:深入理解与Yup实践的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号