You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
-**cascader:** control the visibility of popup panel by `nzOpen` ([#9448](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9448)) ([4d5ec65](https://github.com/NG-ZORRO/ng-zorro-antd/commit/4d5ec6536f64690319e0fd219dc4b07c724764db))
6
+
-**cascader:** toggle checkbox of option by `ENTER` key in multiple mode ([#9457](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9457)) ([e02f1f4](https://github.com/NG-ZORRO/ng-zorro-antd/commit/e02f1f45f6ae1d5836b1b751bb23bfa55c5f1c33))
7
+
-**float-button:** support `nzBadge` ([#9489](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9489)) ([12beec7](https://github.com/NG-ZORRO/ng-zorro-antd/commit/12beec73fe3071e116788635ae17b1668d3b5ad8))
8
+
-**form:** support `nzRequiredMark` ([#9447](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9447)) ([800b6cf](https://github.com/NG-ZORRO/ng-zorro-antd/commit/800b6cf960af7c4dfce0378eeb9fd361d21ac06b))
9
+
-**input-number:** add affix and addon inputs ([#9451](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9451)) ([dbebd02](https://github.com/NG-ZORRO/ng-zorro-antd/commit/dbebd025cc5101d879301405f0e0ce4baca4bdf5))
10
+
-**input:** add `nzAllowClear` input and `nzClear` callback ([#9452](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9452)) ([830b4b3](https://github.com/NG-ZORRO/ng-zorro-antd/commit/830b4b3cced07ecc484375ab62a3593ac7140b39))
11
+
-**input:** introduce new component `nz-input-wrapper` ([#9408](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9408)) ([a8e56ec](https://github.com/NG-ZORRO/ng-zorro-antd/commit/a8e56ecbc5040dc36dd38881d2d3f7133c7c7991)), closes [#9403](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9403)
12
+
-**input:** add affix and addon inputs to `nz-input-wrapper` ([#9450](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9450)) ([763f69e](https://github.com/NG-ZORRO/ng-zorro-antd/commit/763f69e7e35ef3697245e9074034d17f110c5876))
-**message:** add support for custom styles and classes ([#9427](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9427)) ([2f866b3](https://github.com/NG-ZORRO/ng-zorro-antd/commit/2f866b31febe4c1f6dd784537fc8ca2b68a66a93))
16
+
-**pagination:** support `nzAlign` ([#9433](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9433)) ([88d0864](https://github.com/NG-ZORRO/ng-zorro-antd/commit/88d08648570756e35b989f55e15bcb116175dbc2))
17
+
-**segmented:** add default name if `nzName` is not provided ([#9466](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9466)) ([33f8142](https://github.com/NG-ZORRO/ng-zorro-antd/commit/33f8142626e337e1cef997bc99a289effcb64dd0))
18
+
19
+
### Bug Fixes
20
+
21
+
-**badge:** should `nzStyle` work even if `nzColor` is not provided ([#9486](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9486)) ([4424eb0](https://github.com/NG-ZORRO/ng-zorro-antd/commit/4424eb0a018c7d90fb74dfda6ceb5c54a080eb4d))
22
+
-**cascader:** display activated column correctly when reopen the popup panel ([#9456](https://github.com/NG-ZORRO/ng-zorro-antd/issues/9456)) ([7802a39](https://github.com/NG-ZORRO/ng-zorro-antd/commit/7802a39167d0efaf1bca5e829fa4907f7af54650))
Copy file name to clipboardExpand all lines: components/form/doc/index.en-US.md
+19-15Lines changed: 19 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,7 +12,9 @@ description: High-performance form component with data domain management. Includ
12
12
- When you need to create an instance or collect information.
13
13
- When you need to validate fields in certain rules.
14
14
15
-
> Form is totally based on [Angular Forms](https://angular.dev/guide/forms), you can use [reactive forms](https://angular.dev/guide/forms/reactive-forms) or [template-driven-forms](https://angular.dev/guide/forms/template-driven-forms).
15
+
> Form is totally based on [Angular Forms](https://angular.dev/guide/forms), you can
16
+
> use [reactive forms](https://angular.dev/guide/forms/reactive-forms)
17
+
> or [template-driven-forms](https://angular.dev/guide/forms/template-driven-forms).
16
18
> Please make sure you have read the official form document before using the component.
17
19
18
20
## Form
@@ -50,28 +52,28 @@ A form consists of one or more form fields whose type includes input, textarea,
50
52
51
53
### [nz-form]
52
54
53
-
| Property | Description | Type | Default Value | Global Config |
|`[nzLayout]`| Form layout |`'horizontal' \| 'vertical' \| 'inline'`|`'horizontal'`|
56
-
|`[nzAutoTips]`| Set default props `[nzAutoTips]` value of `nz-form-control`, please refer to the example: **Auto tips**|`Record<string, Record<string, string>>`|`{}`| ✅ |
57
-
|`[nzDisableAutoTips]`| Set default props `[nzDisableAutoTip]` value of `nz-form-control`|`boolean`|`false`| ✅ |
58
-
|`[nzNoColon]`| Set default props `[nzNoColon]` value of `nz-form-label`|`boolean`|`false`| ✅ |
59
-
|`[nzTooltipIcon]`| Set default props `[nzTooltipIcon]` value of `nz-form-label`|`string \| { type: string; theme: ThemeType }`|`{ type: 'question-circle', theme: 'outline' }`| ✅ |
60
-
|`[nzLabelAlign]`| Set default props `[nzLabelAlign]` value of `nz-form-label`|`'left' \| 'right'`|`'right'`|
61
-
|`[nzLabelWrap]`| Set default props `[nzLabelWrap]` value of `nz-form-label`|`boolean`|`false`|
62
-
|`[nzRequiredMark]`| Required mark style. Can use required mark or optional mark. |`NzRequiredMark`|`true`|
55
+
| Property | Description | Type | Default Value | Global Config | Version |
|`[nzLayout]`| Form layout |`'horizontal' \| 'vertical' \| 'inline'`|`'horizontal'`|||
58
+
|`[nzAutoTips]`| Set default props `[nzAutoTips]` value of `nz-form-control`, please refer to the example: **Auto tips**|`Record<string, Record<string, string>>`|`{}`| ✅ ||
59
+
|`[nzDisableAutoTips]`| Set default props `[nzDisableAutoTip]` value of `nz-form-control`|`boolean`|`false`| ✅ ||
60
+
|`[nzNoColon]`| Set default props `[nzNoColon]` value of `nz-form-label`|`boolean`|`false`| ✅ ||
61
+
|`[nzTooltipIcon]`| Set default props `[nzTooltipIcon]` value of `nz-form-label`|`string \| { type: string; theme: ThemeType }`|`{ type: 'question-circle', theme: 'outline' }`| ✅ ||
62
+
|`[nzLabelAlign]`| Set default props `[nzLabelAlign]` value of `nz-form-label`|`'left' \| 'right'`|`'right'`|||
63
+
|`[nzLabelWrap]`| Set default props `[nzLabelWrap]` value of `nz-form-label`|`boolean`|`false`|||
64
+
|`[nzRequiredMark]`| Required mark style. Can use required mark or optional mark. |`NzRequiredMark`|`true`|| 20.4.0 |
63
65
64
66
### nz-form-item
65
67
66
68
Used to separate the item in forms, contains label(optional) and control field.
67
69
68
-
> All api in [nz-row](/components/grid/zh) can be used in `nz-form-item`.
70
+
> All api in [nz-row](/components/grid/en) can be used in `nz-form-item`.
69
71
70
72
### nz-form-label
71
73
72
74
The label of the form item, optional.
73
75
74
-
> All api in [nz-col](/components/grid/zh) can be used in `nz-form-label`.
76
+
> All api in [nz-col](/components/grid/en) can be used in `nz-form-label`.
@@ -85,11 +87,13 @@ The label of the form item, optional.
85
87
86
88
### nz-form-control
87
89
88
-
> Note:Due to the lack of partial Observable in [Angular Form](https://github.com/angular/angular/issues/10887), you have to notify `nz-form-control` to update its status with `updateValueAndValidity` when you update form status using methods like `markAsDirty`.
90
+
> Note:Due to the lack of partial Observable in [Angular Form](https://github.com/angular/angular/issues/10887), you
91
+
> have to notify `nz-form-control` to update its status with `updateValueAndValidity` when you update form status using
92
+
> methods like `markAsDirty`.
89
93
90
94
A form consists of one or more form fields whose type includes input, textarea, checkbox, radio, select, tag, and more.
91
95
92
-
> All api in [nz-col](/components/grid/zh) can be used in `nz-form-control`.
96
+
> All api in [nz-col](/components/grid/en) can be used in `nz-form-control`.
0 commit comments