diff --git a/components/form/index.en-US.md b/components/form/index.en-US.md index 89e3edcd50..23a3a8c12a 100644 --- a/components/form/index.en-US.md +++ b/components/form/index.en-US.md @@ -87,7 +87,7 @@ Form field component for data bidirectional binding, validation, layout, and so | labelCol | The layout of label. You can set `span` `offset` to something like `{span: 3, offset: 12}` or `sm: {span: 3, offset: 12}` same as with ``. You can set `labelCol` on Form which will not affect nest Item. If both exists, use Item first | [object](/components/grid/#Col) | - | | | messageVariables | default validate filed info | Record<string, string> | - | 4.7.0 | | name | Field name, support array | [NamePath](#NamePath) | - | | -| normalize | Normalize value from component value before passing to Form instance | (value, prevValue, prevValues) => any | - | | +| normalize | Normalize value from component value before passing to Form instance. Do not support async | (value, prevValue, prevValues) => any | - | | | noStyle | No style for `true`, used as a pure field control | boolean | false | | | preserve | Keep field value even when field removed | boolean | true | 4.4.0 | | required | Display required style. It will be generated by the validation rule | boolean | false | | @@ -415,6 +415,11 @@ Your name path should also contain Form.List `name`: dependencies should be `['users', 0, 'name']` + +### Why `normalize` do not support async? + +React can not get correct interaction of controlled component with async value update. When user trigger `onChange`, component will do no response since `value` update is async. If you want to trigger value update async, you should use customize component to handle value state internal and pass sync value control to Form instead. +