diff --git a/docs/en-US/component/button.md b/docs/en-US/component/button.md
index 45117eae78..7c88f33d9b 100644
--- a/docs/en-US/component/button.md
+++ b/docs/en-US/component/button.md
@@ -125,23 +125,25 @@ button/custom
 
 ## Button Attributes
 
-| Name                                | Description                                                     | Type                  | Accepted Values                                               | Default |
-| ----------------------------------- | --------------------------------------------------------------- | --------------------- | ------------------------------------------------------------- | ------- |
-| size                                | button size                                                     | string                | large / default /small                                        | —       |
-| type                                | button type                                                     | string                | primary / success / warning / danger / info / <del>text</del> | —       |
-| plain                               | determine whether it's a plain button                           | boolean               | —                                                             | false   |
-| text <VersionTag version="2.2.0" /> | determine whether it's a text button                            | boolean               | —                                                             | false   |
-| bg <VersionTag version="2.2.0" />   | determine whether the text button background color is always on | boolean               | —                                                             | false   |
-| link <VersionTag version="2.2.1" /> | determine whether it's a link button                            | boolean               | —                                                             | false   |
-| round                               | determine whether it's a round button                           | boolean               | —                                                             | false   |
-| circle                              | determine whether it's a circle button                          | boolean               | —                                                             | false   |
-| loading                             | determine whether it's loading                                  | boolean               | —                                                             | false   |
-| loading-icon                        | customize loading icon component                                | `string \| Component` | —                                                             | Loading |
-| disabled                            | disable the button                                              | boolean               | —                                                             | false   |
-| icon                                | icon component                                                  | `string \| Component` | —                                                             | —       |
-| autofocus                           | same as native button's `autofocus`                             | boolean               | —                                                             | false   |
-| native-type                         | same as native button's `type`                                  | string                | button / submit / reset                                       | button  |
-| auto-insert-space                   | automatically insert a space between two chinese characters     | boolean               |                                                               | —       |
+| Name                                | Description                                                             | Type                  | Accepted Values                                               | Default |
+| ----------------------------------- | ----------------------------------------------------------------------- | --------------------- | ------------------------------------------------------------- | ------- |
+| size                                | button size                                                             | string                | large / default /small                                        | —       |
+| type                                | button type                                                             | string                | primary / success / warning / danger / info / <del>text</del> | —       |
+| plain                               | determine whether it's a plain button                                   | boolean               | —                                                             | false   |
+| text <VersionTag version="2.2.0" /> | determine whether it's a text button                                    | boolean               | —                                                             | false   |
+| bg <VersionTag version="2.2.0" />   | determine whether the text button background color is always on         | boolean               | —                                                             | false   |
+| link <VersionTag version="2.2.1" /> | determine whether it's a link button                                    | boolean               | —                                                             | false   |
+| round                               | determine whether it's a round button                                   | boolean               | —                                                             | false   |
+| circle                              | determine whether it's a circle button                                  | boolean               | —                                                             | false   |
+| loading                             | determine whether it's loading                                          | boolean               | —                                                             | false   |
+| loading-icon                        | customize loading icon component                                        | `string \| Component` | —                                                             | Loading |
+| disabled                            | disable the button                                                      | boolean               | —                                                             | false   |
+| icon                                | icon component                                                          | `string \| Component` | —                                                             | —       |
+| autofocus                           | same as native button's `autofocus`                                     | boolean               | —                                                             | false   |
+| native-type                         | same as native button's `type`                                          | string                | button / submit / reset                                       | button  |
+| auto-insert-space                   | automatically insert a space between two chinese characters             | boolean               |                                                               | —       |
+| color                               | custom button color, automatically calculate `hover` and `active` color | string                |                                                               | —       |
+| dark                                | dark mode, which automatically converts `color` to dark mode colors     | boolean               |                                                               | false   |
 
 ## Button Slots