Formik 是为 React 开发的开源表单库,提供状态管理、验证和提交处理功能,可简化复杂表单的开发。
- 状态管理 :自动跟踪输入值、验证状态和提交进度,无需手动编写状态逻辑。
- 验证功能 :支持声明式验证规则(如字段类型、长度限制、异步验证),实时反馈错误信息。
- 集成能力 :可与 Yup (验证)、 React Hook Form (表单钩子)等库组合使用,扩展功能。
npm install formik
import { useFormik } from "formik";
export default function Formik() {
const formik = useFormik({
initialValues: {
username: "",
email: "",
},
validate: (values) => {
const errors = {};
if (!values.username) {
errors.username = "用户名是必填项";
} else if (values.username.length < 2) {
errors.username = "用户名至少2个字符";
}
if (!values.email) {
errors.email = "邮箱是必填项";
} else if (
!/^[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}$/i.test(values.email)
) {
errors.email = "无效的邮箱地址";
}
return errors;
},
onSubmit: (values) => {
console.log(values);
alert(JSON.stringify(values, null, 2));
},
});
return (
);
}
import { useFormik } from "formik";
import * as Yup from "yup";
export default function Formik() {
const formik = useFormik({
initialValues: {
username: "",
email: "",
},
validationSchema: Yup.object({
username: Yup.string()
.min(2, "用户名至少2个字符")
.required("用户名是必填项"),
email: Yup.string().email("无效的邮箱地址").required("邮箱是必填项"),
}),
onSubmit: (values) => {
alert(JSON.stringify(values, null, 2));
},
});
return (
);
}
import { useForm } from "react-hook-form";
export default function Formik() {
const {
register,
handleSubmit,
formState: { errors, touchedFields },
} = useForm({
mode: "onChange",
defaultValues: {
username: "",
email: "",
},
});
const onSubmit = (values) => {
console.log(values);
alert(JSON.stringify(values, null, 2));
};
return (
);
}
validate: (values) => {
const errors = {};
if (!values.username) {
errors.username = "用户名是必填项";
} else if (values.username.length < 2) {
errors.username = "用户名至少2个字符";
}
// ... 其他校验
return errors;
};
validationSchema: Yup.object({
username: Yup.string()
.min(2, "用户名至少2个字符")
.required("用户名是必填项"),
email: Yup.string().email("无效的邮箱地址").required("邮箱是必填项"),
});
{...register("username", {
required: "用户名是必填项",
minLength: { value: 2, message: "用户名至少2个字符" },
})}
特性 | Formik validate | Formik + Yup | React Hook Form |
---|---|---|---|
书写方式 | 手写函数 | 声明式 schema | 注册时传规则 |
依赖 | 无 | Yup | 无/可选 Yup |
代码量 | 多 | 少 | 少 |
维护性 | 一般 | 好 | 好 |
灵活性 | 高 | 高 | 高 |
性能 | 一般 | 一般 | 优 |
适合场景 | 简单/自定义复杂逻辑 | 规则多/复杂表单 | 性能敏感/大表单 |
结论:
React 强大的表单验证库formik之集成Yup、React Hook Form库 - 高质量源码分享平台-免费下载各类网站源码与模板及前沿动态资讯