在 Mantine 项目中用 @mantine/form…

适用于 React + Mantine 项目里用 @mantine/form 创建、校验、提交表单，并处理嵌套字段、异步校验和跨组件共享表单状态。

适用场景

解决思路

1. 用 `useForm` 初始化表单：传入 `mode`（默认 `'controlled'`，大表单可用 `'uncontrolled'`）、`initialValues`（如 `{ email: '', age: 0 }`）和 `validate`（如 `email: isEmail('Invalid email')`、`age: isInRange({ min: 18 }, 'Must be at least 18')`）。
2. 通过 `form.getInputProps('字段名')` 把输入组件接入表单，例如 `<TextInput {...form.getInputProps('email')} label="Email" />` 和 `<NumberInput {...form.getInputProps('age')} label="Age" />`。
3. 对复选框使用 `form.getInputProps('agreed', { type: 'checkbox' })`，例如 `<Checkbox {...form.getInputProps('agreed', { type: 'checkbox' })} label="I agree" />`。
4. 用 `<form onSubmit={form.onSubmit((values) => console.log(values))}>` 包裹表单，并用 `<Button type="submit">Submit</Button>` 提交；`onSubmit` 只在校验通过时调用处理函数。
5. 需要处理校验失败时，使用 `form.onSubmit((values) => save(values), (errors) => console.log('Validation failed', errors))`。
6. 校验优先使用规则对象：`validate: { name: isNotEmpty('Required'), email: isEmail('Invalid email'), password: hasLength({ min: 8 }, 'Min 8 chars'), confirmPassword: matchesField('password', 'Passwords do not match') }`。
7. 跨字段逻辑使用函数形式的 `validate`，例如 `validate: (values) => ({ endDate: values.endDate < values.startDate ? 'End must be after start' : null })`。
8. 控制校验时机：`validateInputOnChange: true` 每次变更校验所有字段。
9. 控制校验时机：`validateInputOnChange: ['email']` 只校验指定字段。
10. 控制校验时机：`validateInputOnBlur: true` 在失焦时校验。
11. 理解模式差异：`'controlled'`（默认）状态存 React 状态，每次变更重渲染，输入组件用 `value` + `onChange`。
12. 理解模式差异：`'uncontrolled'` 状态存 refs，不触发重渲染，输入组件用 `defaultValue` + `onChange`。
13. 在 uncontrolled 模式下，当需要强制某输入重新渲染时，把 `form.key('fieldPath')` 作为 React 的 `key` 属性。
14. 需要完整 API（`useForm` 选项、返回值、`useField`、`createFormContext`、`createFormActions`、所有内置校验器、关键类型）时查阅 `references/api.md`。
15. 需要代码示例（嵌套对象、数组字段、异步校验、跨组件表单上下文、`transformValues`、独立 `useField`）时查阅 `references/patterns.md`。
16. 处理嵌套对象或数组字段时，参考 `references/patterns.md` 的嵌套对象/数组字段示例，并使用相关 API（如 `insertListItem`）操作数组字段。
17. 需要在组件间共享表单状态时使用 `createFormContext`；需要独立字段时使用 `useField`（详见 `references/api.md`）。
18. 需要异步校验时，参考 `references/patterns.md` 中的异步校验示例实现。

适用边界 · 注意事项

• 不使用 Mantine 或 @mantine/form 的项目中不要套用。
• 非 React 环境不适用。
• 如果使用其他表单库（如 React Hook Form、Formik）或只需极简原生表单，不需要按本技能实现。