react-hook-form结合yup时如何让react-number-format传递浮点值给校验与提交
问题本质
- 你当前遇到的核心矛盾是:react-number-format默认在双向绑定过程中,会向外部抛出带格式的字符串值(比如带千分位分隔符、货币前缀的展示文本),但react-hook-form的表单值缓存、yup校验逻辑、最终接口提交流程都需要纯浮点类型的数值,两者类型不匹配就会导致跨字段值校验、值对比的逻辑完全失效。
落地实现方案
第一步:拆分组件的展示职责与存储职责,不使用字符串值做双向绑定
不要直接将NumberFormat组件绑定到RHF的register方法上,借助组件自带的onValueChange回调拆分展示值与业务值:onValueChange回调会返回两个核心值:formattedValue(用来做页面展示的带格式字符串)、floatValue(组件内部按照自身格式化规则解析好的纯浮点数值)- 不把
formattedValue存入RHF的表单值层,直接将回调里拿到的floatValue通过RHF的setValue方法写入对应表单项的存储值
示例代码:
import { useForm } from 'react-hook-form'; import NumberFormat from 'react-number-format'; function InvoiceForm() { const { setValue, watch } = useForm({ defaultValues: { grossValue: 0, // 待校验的目标输入框值 matchTarget: 0 } }); // 实时获取已存的总金额值 const grossValue = watch('grossValue'); return ( <div> {/* 总金额输入框配置逻辑和下面的匹配输入框一致 */} <NumberFormat thousandSeparator decimalScale={2} fixedDecimalScale onValueChange={(values) => { const { floatValue } = values; setValue('grossValue', floatValue || 0, { shouldValidate: true }) }} value={grossValue} /> {/* 待校验的匹配输入框 */} <NumberFormat thousandSeparator decimalScale={2} fixedDecimalScale onValueChange={(values) => { const { floatValue } = values; // 直接把解析好的浮点值存进RHF,不存格式化字符串 setValue('matchTarget', floatValue || 0, { // 值更新后自动触发校验逻辑 shouldValidate: true }) }} // 从RHF取值作为展示源,组件会自动格式化为带分隔符的友好格式 value={watch('matchTarget')} /> </div> ) }第二步:适配yup校验逻辑
因为RHF存储层保存的已经是纯浮点值,yup的校验逻辑不需要做额外的字符串解析,直接基于数值类型写跨字段对比规则即可,完全不需要手动处理格式字符串的解析逻辑。
示例schema:import * as yup from 'yup'; const invoiceSchema = yup.object({ grossValue: yup.number().required('总金额不能为空'), matchTarget: yup .number() .required('匹配金额不能为空') // 直接做浮点值的相等校验,无类型不匹配问题 .oneOf([yup.ref('grossValue')], '输入值必须与总金额相等') })第三步:确认提交流程的正确性
因为从值写入的源头就保证了存的是浮点值,RHF的handleSubmit回调最终拿到的所有表单值本身就是符合要求的数值类型,不需要在提交前再做一轮值类型转换,直接传给后端接口即可。
避坑提醒
- 不要手写
parseFloat逻辑处理格式化后的字符串,很容易因为千分位分隔符、特殊货币符号解析出NaN,直接用react-number-format内置返回的floatValue即可,这个值是组件针对自身格式化规则做的精准解析,可靠性远高于手写解析- 做好空值兜底:当用户清空输入框时,
floatValue会返回null,setValue时需要做兜底处理,避免存入undefined、NaN这类无效值触发校验异常- 校验逻辑只作用于存储层的业务值,不要和展示层的格式化文本做对比,否则哪怕实际数值相等,字符串对比也会因为格式符号导致校验不通过
内容的提问来源于stack exchange,提问作者user7605119
相关产品推荐
相关产品推荐

