在 Ant Design 的 Form 组件中,如果需要在某个 Form.Item 里根据其他 Form.Item 的值进行动态逻辑判断(例如显示/隐藏、禁用/启用、动态校验等),可以使用以下几种方法:
方法 1:使用 Form.Item 的 dependencies + shouldUpdate
适用于 监听其他字段变化并重新渲染当前表单项。
示例:B 字段依赖 A 字段的值
jsx
import { Form, Input } from 'antd';
const MyForm = () => {
return (
<Form>
<Form.Item name="fieldA" label="字段A">
<Input />
</Form.Item>
{/* 当 fieldA 变化时,重新渲染 fieldB */}
<Form.Item
name="fieldB"
label="字段B"
dependencies={['fieldA']}
shouldUpdate={(prevValues, currentValues) =>
prevValues.fieldA !== currentValues.fieldA
}
>
{({ getFieldValue }) => {
const fieldAValue = getFieldValue('fieldA');
return (
<Input
disabled={!fieldAValue} // 如果 fieldA 为空,禁用 fieldB
placeholder={fieldAValue ? '请输入B' : '请先填写A'}
/>
);
}}
</Form.Item>
</Form>
);
};
关键点
dependencies={['fieldA']}:声明依赖的字段名。shouldUpdate:决定是否重新渲染(返回true时更新)。getFieldValue():获取其他字段的值。
方法 2:使用 Form.useWatch (Ant Design 4.20.0+)
适用于 在组件内监听字段值变化 (无需 shouldUpdate)。
示例:动态显示提示信息
jsx
import { Form, Input, Typography } from 'antd';
const MyForm = () => {
const fieldAValue = Form.useWatch('fieldA', Form.useForm()[0]);
return (
<Form>
<Form.Item name="fieldA" label="字段A">
<Input />
</Form.Item>
<Form.Item name="fieldB" label="字段B">
<Input />
</Form.Item>
{/* 根据 fieldA 的值显示提示 */}
{fieldAValue && (
<Typography.Text type="warning">
当前A的值是: {fieldAValue}
</Typography.Text>
)}
</Form>
);
};
优点
- 代码更简洁,无需手动管理依赖。
- 适合复杂逻辑(如联动多个字段)。
方法 3:自定义校验规则(依赖其他字段)
适用于 动态校验规则(例如密码确认)。
示例:密码一致性校验
jsx
<Form.Item
name="password"
label="密码"
rules={[{ required: true }]}
>
<Input.Password />
</Form.Item>
<Form.Item
name="confirmPassword"
label="确认密码"
dependencies={['password']}
rules={[
{ required: true },
({ getFieldValue }) => ({
validator(_, value) {
if (!value || getFieldValue('password') === value) {
return Promise.resolve();
}
return Promise.reject('两次密码不一致!');
},
}),
]}
>
<Input.Password />
</Form.Item>
关键点
dependencies:声明依赖的字段(这里是password)。- 校验函数中通过
getFieldValue获取其他字段值。
方法 4:使用 useForm 实例手动控制
适用于 需要编程式干预表单逻辑(如提交时校验)。
示例:提交时检查字段A是否满足条件
jsx
import { Form, Input, Button } from 'antd';
const MyForm = () => {
const [form] = Form.useForm();
const handleSubmit = () => {
const fieldAValue = form.getFieldValue('fieldA');
if (fieldAValue !== '允许的值') {
alert('字段A不符合条件!');
return;
}
form.submit();
};
return (
<Form form={form}>
<Form.Item name="fieldA" label="字段A">
<Input />
</Form.Item>
<Button onClick={handleSubmit}>提交</Button>
</Form>
);
};
常见场景总结
| 场景 | 推荐方法 |
|---|---|
| 字段联动(显示/隐藏/禁用) | dependencies + shouldUpdate |
| 动态提示/UI更新 | Form.useWatch |
| 动态校验规则 | dependencies + 自定义 validator |
| 复杂编程逻辑 | useForm 实例 |
注意事项
- 性能优化 :
- 避免在
shouldUpdate中监听过多字段(可能引发频繁渲染)。 - 对大型表单优先使用
Form.useWatch。
- 避免在
- Ant Design 版本 :
useWatch需 Ant Design ≥ 4.20.0。
- TypeScript 类型 :
-
使用
FormInstance类型标注表单实例:typescriptconst [form] = Form.useForm<{ fieldA: string; fieldB: number }>();
-
通过以上方法,可以灵活实现 Form.Item 之间的值判断与联动逻辑!