Merge branch 'release'

content/feedback/notification/index-en-US.md

@@ -280,20 +280,20 @@ Close Manually (`id` is the return value of the display methods)
 
 -   `Notification.close(id)`
 
-| Properties   | Instructions                                                                                   | type                 | Default    | version |
-| ------------ | ---------------------------------------------------------------------------------------------- | -------------------- | ---------- | ------- |
-| content      | Content                                                                                        | ReactNode | ''      |  |
-| duration     | Automatic close delay, no auto-close when set to 0                                             | number               | 3          |         |
-| getPopupContainer | Specifies the parent DOM, and the bullet layer will be rendered to the DOM, you need to set 'position: relative` | () => HTMLElement | () => document.body    |  0.34.0     |
-| icon         | Topleft icon                                                                                   | ReactNode               |  |         |  |
-| position     | Pop-up position, one of `top`、`bottom`、`topLeft`、`topRight`、`bottomLeft`、`bottomRight`    | string               | `topRight` |         |
-| showClose    | Toggle Whether show close button                                                               | boolean              | true       | 0.25.0  |
-| theme | Style of background fill, one of `light`, `normal` | string | `normal`   |  1.0.0     |
-| title        | Title                                                                                          | string               | ReactNode | ''      |  |
-| zIndex       | Z-index value. Only take effect for the first time.                                                                               | number               | 1010       |         |
-| onClick      | Callback function when clicking the notification                                               | (e: event) => void   |            | 0.27 .0 |
-| onClose      | Callback function when closing notification, triggered for either auto-close or manually close | () => void |            |         |
-| onCloseClick | Callback function when actively clicking on the close button                                   | (id: string \| number) => void |            |         |
+| Properties   | Instructions                                                                                                      | type                 | Default    | version |
+| ------------ |-------------------------------------------------------------------------------------------------------------------| -------------------- | ---------- | ------- |
+| content      | Content                                                                                                           | ReactNode | ''      |  |
+| duration     | Automatic close delay, no auto-close when set to 0                                                                | number               | 3          |         |
+| getPopupContainer | Specifies the parent DOM, and the bullet layer will be rendered to the DOM, you need to set 'position: relative` This will change the DOM tree position, but not the view's rendering position. | () => HTMLElement | () => document.body    |  0.34.0     |
+| icon         | Topleft icon                                                                                                      | ReactNode               |  |         |  |
+| position     | Pop-up position, one of `top`、`bottom`、`topLeft`、`topRight`、`bottomLeft`、`bottomRight`                            | string               | `topRight` |         |
+| showClose    | Toggle Whether show close button                                                                                  | boolean              | true       | 0.25.0  |
+| theme | Style of background fill, one of `light`, `normal`                                                                | string | `normal`   |  1.0.0     |
+| title        | Title                                                                                                             | string               | ReactNode | ''      |  |
+| zIndex       | Z-index value. Only take effect for the first time.                                                               | number               | 1010       |         |
+| onClick      | Callback function when clicking the notification                                                                  | (e: event) => void   |            | 0.27 .0 |
+| onClose      | Callback function when closing notification, triggered for either auto-close or manually close                    | () => void |            |         |
+| onCloseClick | Callback function when actively clicking on the close button                                                      | (id: string \| number) => void |            |         |
 
 The global configuration is set before any method call, and takes effect only once (>= 0.25.0):
 

content/feedback/notification/index.md

@@ -272,20 +272,20 @@ import { Notification, Button } from '@douyinfe/semi-ui';
 
 -   `Notification.close(id)`
 
-| 属性 | 说明 | 类型 | 默认值 | 版本 |
-| --- | --- | --- | --- | --- |
-| content | 通知内容 |ReactNode | '' |  |
-| duration | 自动关闭的延时，单位 s，设为 0 时不自动关闭 | number | 3 |  |
-| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 `position: relative` | () => HTMLElement | () => document.body | 0.34.0 |
-| icon | 左上角 icon | React.Node |  |  |
+| 属性 | 说明                                                                     | 类型 | 默认值 | 版本 |
+| --- |------------------------------------------------------------------------| --- | --- | --- |
+| content | 通知内容                                                                   |ReactNode | '' |  |
+| duration | 自动关闭的延时，单位 s，设为 0 时不自动关闭                                               | number | 3 |  |
+| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 `position: relative` 这会改变浮层 DOM 树位置，但不会改变视图渲染位置。                   | () => HTMLElement | () => document.body | 0.34.0 |
+| icon | 左上角 icon                                                               | React.Node |  |  |
 | position | 弹出位置，可选 `top`、`bottom`、`topLeft`、`topRight`、`bottomLeft`、`bottomRight` | string | `topRight` |  |
-| showClose | 是否展示关闭按钮 | boolean | true | 0.25.0 |
-| theme | 填充样式，支持`light`, `normal` | string | `normal` | 1.0.0 |
-| title | 通知标题 | ReactNode | '' |  |
-| zIndex | 弹层 z-index 值，首次设置一次生效 | number | 1010 |  |
-| onClick | 点击通知的回调函数 | (e: event) => void |  | 0.27.0 |
-| onClose | 通知关闭的回调函数(主动关闭、延时到达关闭都会触发) | () => void |  |  |
-| onCloseClick | 主动点击关闭按钮时的回调函数 | (id: string \| number) => void |  |  |
+| showClose | 是否展示关闭按钮                                                               | boolean | true | 0.25.0 |
+| theme | 填充样式，支持`light`, `normal`                                               | string | `normal` | 1.0.0 |
+| title | 通知标题                                                                   | ReactNode | '' |  |
+| zIndex | 弹层 z-index 值，首次设置一次生效                                                  | number | 1010 |  |
+| onClick | 点击通知的回调函数                                                              | (e: event) => void |  | 0.27.0 |
+| onClose | 通知关闭的回调函数(主动关闭、延时到达关闭都会触发)                                             | () => void |  |  |
+| onCloseClick | 主动点击关闭按钮时的回调函数                                                         | (id: string \| number) => void |  |  |
 
 全局配置在调用前提前配置，全局一次生效 ( >= 0.25.0 )：
 

content/feedback/popconfirm/index-en-US.md

@@ -214,7 +214,7 @@ Please refer to [Use with Tooltip/Popover](/en-US/show/tooltip#Use-with-Popver-o
 | content            | Content displayed (function type, supported in version 2.30.0)                                                                                                         | ReactNode\|({ initialFocusRef }) => ReactNode        |                     |
 | defaultVisible     | Bubble box is displayed by default                                                                                                                                    | boolean                    |                     | **0.19.0**        |
 | disabled           | Click on the Pop confirmation box to see if the bubbles pop up.                                                                                                       | boolean                    | false               |
-| getPopupContainer  | Specify the parent DOM, and the pop-up layer will be rendered into the DOM. Customization needs to set `position: relative`                                                                                                       | Function():HTMLElement           | () => document.body |
+| getPopupContainer  | Specify the parent DOM, and the pop-up layer will be rendered into the DOM. Customization needs to set `position: relative`   This will change the DOM tree position, but not the view's rendering position.                                                                                                      | Function():HTMLElement           | () => document.body |
 | guardFocus         | When the focus is in the popup layer, toggle whether the Tab makes the focus loop in the popup layer | boolean | true | **2.8.0** |
 | icon               | Custom pop bubble Icon icon                                                                                                                                           |  ReactNode        | <IconAlertTriangle size="extra-large" />    |
 | motion             | Whether there is animation when the drop-down list appears/hidden. You can customize animation by passing in an object that conforms to the structure | boolean | true |

content/feedback/popconfirm/index.md

@@ -202,36 +202,36 @@ import { Button, Popconfirm, Space } from '@douyinfe/semi-ui';
 
 ## API 参考
 
-| 属性 | 说明 | 类型 | 默认值 | 版本 |
-| --- | --- | --- | --- | --- |
-| arrowPointAtCenter | “小三角”是否指向元素中心，需要同时传入"showArrow=true" | boolean | false | **0.34.0** |
-| cancelText | 取消按钮文字 | string | "取消" |
-| cancelButtonProps | 取消按钮的 props | object |  | **0.29.0** |
-| cancelType | 取消按钮类型 | string | "tertiary" |
-| closeOnEsc | 在 trigger 聚焦时或在弹出层内聚焦元素上按 Esc 键是否关闭面板，受控时不生效 | boolean | true | **2.8.0** |
-| content | 显示的内容（函数类型，2.10.0 版本支持） | ReactNode\|({ initialFocusRef }) => ReactNode |  |
-| defaultVisible | 气泡框默认是否展示 | boolean |  | **0.19.0** |
-| disabled | 点击 Popconfirm 子元素是否弹出气泡确认框 | boolean | false |
-| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义时容器需要设置 `position: relative` | Function():HTMLElement | () => document.body |
-| guardFocus | 当焦点处于弹出层内时，切换 Tab 是否让焦点在弹出层内循环 | boolean | true | **2.8.0** |
-| icon | 自定义弹出气泡 Icon 图标 | ReactNode | <IconAlertTriangle size="extra-large" /> |
-| motion | 下拉列表出现/隐藏时，是否有动画 | boolean | true |
-| okText | 确认按钮文字 | string | "确认" |
-| okType | 确认按钮类型 | string | "primary" |
-| okButtonProps | 确认按钮的 props | object |  | **0.29.0** |
+| 属性 | 说明                                                                                                                                        | 类型 | 默认值 | 版本 |
+| --- |-------------------------------------------------------------------------------------------------------------------------------------------| --- | --- | --- |
+| arrowPointAtCenter | “小三角”是否指向元素中心，需要同时传入"showArrow=true"                                                                                                      | boolean | false | **0.34.0** |
+| cancelText | 取消按钮文字                                                                                                                                    | string | "取消" |
+| cancelButtonProps | 取消按钮的 props                                                                                                                               | object |  | **0.29.0** |
+| cancelType | 取消按钮类型                                                                                                                                    | string | "tertiary" |
+| closeOnEsc | 在 trigger 聚焦时或在弹出层内聚焦元素上按 Esc 键是否关闭面板，受控时不生效                                                                                              | boolean | true | **2.8.0** |
+| content | 显示的内容（函数类型，2.10.0 版本支持）                                                                                                                   | ReactNode\|({ initialFocusRef }) => ReactNode |  |
+| defaultVisible | 气泡框默认是否展示                                                                                                                                 | boolean |  | **0.19.0** |
+| disabled | 点击 Popconfirm 子元素是否弹出气泡确认框                                                                                                                | boolean | false |
+| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义时容器需要设置 `position: relative` 这会改变浮层 DOM 树位置，但不会改变视图渲染位置。                                                                                   | Function():HTMLElement | () => document.body |
+| guardFocus | 当焦点处于弹出层内时，切换 Tab 是否让焦点在弹出层内循环                                                                                                            | boolean | true | **2.8.0** |
+| icon | 自定义弹出气泡 Icon 图标                                                                                                                           | ReactNode | <IconAlertTriangle size="extra-large" /> |
+| motion | 下拉列表出现/隐藏时，是否有动画                                                                                                                          | boolean | true |
+| okText | 确认按钮文字                                                                                                                                    | string | "确认" |
+| okType | 确认按钮类型                                                                                                                                    | string | "primary" |
+| okButtonProps | 确认按钮的 props                                                                                                                               | object |  | **0.29.0** |
 | position | 方向，可选值：`top`,`topLeft`,`topRight`,`left`,`leftTop`,`leftBottom`,<br/>`right`,`rightTop`,`rightBottom`,`bottom`,`bottomLeft`,`bottomRight` | string | "bottomLeft" |
-| returnFocusOnClose | 按下 Esc 键后，焦点是否回到 trigger 上，只有设置 trigger 为 click 时生效 | boolean | true | **2.8.0** |
-| showArrow | 是否显示箭头三角形 | boolean | false |  |
-| stopPropagation | 是否阻止弹层上的点击事件冒泡 | boolean | true | **0.34.0** |
-| title | 显示的标题 | string\|ReactNode |  |
-| trigger | 触发展示的时机，可选值：hover / focus / click / custom | string | 'click' |
-| visible | 气泡框是否展示的受控属性 | boolean |  | **0.19.0** |
-| zIndex | 浮层 z-index 值 | number | 1030 |
-| onConfirm | 点击确认按钮回调 | Function(e) |  |
-| onCancel | 点击取消按钮回调 | Function(e) |  |
-| onClickOutSide | 当弹出层处于展示状态，点击非 Children、非浮层内部区域时的回调 | Function(e) | **2.1.0** |
-| onEscKeyDown | 在 trigger 或弹出层按 Esc 键时调用 | function(e:event) |  | **2.8.0** |
-| onVisibleChange | 气泡框切换显示隐藏的回调 | Function(visible: boolean): void | () => {} | **0.19.0** |
+| returnFocusOnClose | 按下 Esc 键后，焦点是否回到 trigger 上，只有设置 trigger 为 click 时生效                                                                                       | boolean | true | **2.8.0** |
+| showArrow | 是否显示箭头三角形                                                                                                                                 | boolean | false |  |
+| stopPropagation | 是否阻止弹层上的点击事件冒泡                                                                                                                            | boolean | true | **0.34.0** |
+| title | 显示的标题                                                                                                                                     | string\|ReactNode |  |
+| trigger | 触发展示的时机，可选值：hover / focus / click / custom                                                                                                | string | 'click' |
+| visible | 气泡框是否展示的受控属性                                                                                                                              | boolean |  | **0.19.0** |
+| zIndex | 浮层 z-index 值                                                                                                                              | number | 1030 |
+| onConfirm | 点击确认按钮回调                                                                                                                                  | Function(e) |  |
+| onCancel | 点击取消按钮回调                                                                                                                                  | Function(e) |  |
+| onClickOutSide | 当弹出层处于展示状态，点击非 Children、非浮层内部区域时的回调                                                                                                       | Function(e) | **2.1.0** |
+| onEscKeyDown | 在 trigger 或弹出层按 Esc 键时调用                                                                                                                  | function(e:event) |  | **2.8.0** |
+| onVisibleChange | 气泡框切换显示隐藏的回调                                                                                                                              | Function(visible: boolean): void | () => {} | **0.19.0** |
 
 ## Accessibility
 

content/feedback/toast/index-en-US.md

@@ -383,14 +383,14 @@ The static methods provided are as follows: Display: You can pass in `options` o
 
 **If not specifically declared in Toast.config(config), the following APIs need to call additional ToastFactory.create(config) to create new Toast settings**
 
-| Properties | Instructions | type | Default | version |
-| --- | --- | --- | --- | --- |
-| bottom | Pop-up position bottom | number \| string | - | 0.25.0 |
-| getPopupContainer | Specifies the parent DOM, and the bullet layer will be rendered to the DOM, you need to set container and inner .semi-toast-wrapper  'position: relative` | () => HTMLElement \| null | () => document.body | 0.34.0 |
-| left | Pop-up position left | number \| string | - | 0.25.0 |
-| right | Pop-up position right | number \| string | - | 0.25.0 |
-| top | Pop-up position top | number \| string | - | 0.25.0 |
-| zIndex | Z-index value | number | 1010 |  |
+| Properties | Instructions                                                                                                                                                | type | Default | version |
+| --- |-------------------------------------------------------------------------------------------------------------------------------------------------------------| --- | --- | --- |
+| bottom | Pop-up position bottom                                                                                                                                      | number \| string | - | 0.25.0 |
+| getPopupContainer | Specifies the parent DOM, and the bullet layer will be rendered to the DOM, you need to set container and inner .semi-toast-wrapper  'position: relative`   This will change the DOM tree position, but not the view's rendering position.  | () => HTMLElement \| null | () => document.body | 0.34.0 |
+| left | Pop-up position left                                                                                                                                        | number \| string | - | 0.25.0 |
+| right | Pop-up position right                                                                                                                                       | number \| string | - | 0.25.0 |
+| top | Pop-up position top                                                                                                                                         | number \| string | - | 0.25.0 |
+| zIndex | Z-index value                                                                                                                                               | number | 1010 |  |
 
 -   `ToastFactory.create(config) => Toast`  
     If you need Toast with different configs in your application, you can use ToastFactory.create(config)to create a new Toast (>= 1.23):

content/feedback/toast/index.md

@@ -384,14 +384,14 @@ render(Demo);
 
 **若未在 Toast.config(config) 中特别声明，以下API需要调用额外的 ToastFactory.create(config) 创建新 Toast 生效设置**
 
-| 属性 | 说明                                                                                       | 类型 | 默认值 | 版本 |
-| --- |------------------------------------------------------------------------------------------| --- | --- | --- |
-| bottom | 弹出位置 bottom                                                                              | number \| string | - | 0.25.0 |
-| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 container 和 内部的 .semi-toast-wrapper `position: relative` | () => HTMLElement \| null | () => document.body | 0.34.0 |
-| left | 弹出位置 left                                                                                | number \| string | - | 0.25.0 |
-| right | 弹出位置 right                                                                               | number \| string | - | 0.25.0 |
-| top | 弹出位置 top                                                                                 | number \| string | - | 0.25.0 |
-| zIndex | 弹层 z-index 值                                                                             | number | 1010 |  |
+| 属性 | 说明                                                                                        | 类型 | 默认值 | 版本 |
+| --- |-------------------------------------------------------------------------------------------| --- | --- | --- |
+| bottom | 弹出位置 bottom                                                                               | number \| string | - | 0.25.0 |
+| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 container 和 内部的 .semi-toast-wrapper 这会改变浮层 DOM 树位置，但不会改变视图渲染位置。  `position: relative` | () => HTMLElement \| null | () => document.body | 0.34.0 |
+| left | 弹出位置 left                                                                                 | number \| string | - | 0.25.0 |
+| right | 弹出位置 right                                                                                | number \| string | - | 0.25.0 |
+| top | 弹出位置 top                                                                                  | number \| string | - | 0.25.0 |
+| zIndex | 弹层 z-index 值                                                                              | number | 1010 |  |
 
 
 -   `ToastFactory.create(config) => Toast`  

content/input/autocomplete/index-en-US.md

@@ -355,43 +355,43 @@ import { IllustrationNoContent } from '@douyinfe/semi-illustrations';
 
 ## API reference
 
-| Properties | Instructions | Type | Default | Version|
-| --- | --- | --- | --- | -- |
-| autoFocus | Whether to auto focus | bool | false | 1.16.0|
-| autoAdjustOverflow | Whether to automatically adjust the direction when the floating layer is blocked<br/>| bool | true | 0.27.0|
-| className | Style class name | string | |
-| clearIcon | Can be used to customize the clear button, valid when showClear is true | ReactNode | |  2.25.0|
-| data | The data source of the candidates, which can be a string array or an object array | array | [] |
-| defaultActiveFirstOption | Whether to highlight the first option by default (press enter to select directly) | bool | false |
-| defaultOpen | Whether to expand the drop-down menu by default | boolean | false |
-| defaultValue | Defaults | string | |
-| disabled | Whether to disable | boolean | false |
-| dropdownClassName | Css class name of the drop-down list | string |  |
-| dropdownStyle | Inline style of the drop-down list | object |  |
-| emptyContent | Customize the drop-down content when data is empty | ReactNode | null | 1.16.0|
-| getPopupContainer | Specify the parent DOM, the floating layer of the drop-down list will be rendered into the DOM, and the customization needs to set `position: relative` | () => HTMLElement | () => document.body |
-| loading | Whether the drop-down list shows loading animation | boolean | false |
-| maxHeight | The maximum height of the drop-down list | number\|string | 300 |
-| motion | Is there an animation when the drop-down list appears/hidden | boolean | true |
+| Properties | Instructions                                                                                                                                                                                                                            | Type | Default | Version|
+| --- |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| --- | --- | -- |
+| autoFocus | Whether to auto focus                                                                                                                                                                                                                   | bool | false | 1.16.0|
+| autoAdjustOverflow | Whether to automatically adjust the direction when the floating layer is blocked<br/>                                                                                                                                                   | bool | true | 0.27.0|
+| className | Style class name                                                                                                                                                                                                                        | string | |
+| clearIcon | Can be used to customize the clear button, valid when showClear is true                                                                                                                                                                 | ReactNode | |  2.25.0|
+| data | The data source of the candidates, which can be a string array or an object array                                                                                                                                                       | array | [] |
+| defaultActiveFirstOption | Whether to highlight the first option by default (press enter to select directly)                                                                                                                                                       | bool | false |
+| defaultOpen | Whether to expand the drop-down menu by default                                                                                                                                                                                         | boolean | false |
+| defaultValue | Defaults                                                                                                                                                                                                                                | string | |
+| disabled | Whether to disable                                                                                                                                                                                                                      | boolean | false |
+| dropdownClassName | Css class name of the drop-down list                                                                                                                                                                                                    | string |  |
+| dropdownStyle | Inline style of the drop-down list                                                                                                                                                                                                      | object |  |
+| emptyContent | Customize the drop-down content when data is empty                                                                                                                                                                                      | ReactNode | null | 1.16.0|
+| getPopupContainer | Specify the parent DOM, the floating layer of the drop-down list will be rendered into the DOM, and the customization needs to set `position: relative`  This will change the DOM tree position, but not the view's rendering position.                                                                                 | () => HTMLElement | () => document.body |
+| loading | Whether the drop-down list shows loading animation                                                                                                                                                                                      | boolean | false |
+| maxHeight | The maximum height of the drop-down list                                                                                                                                                                                                | number\|string | 300 |
+| motion | Is there an animation when the drop-down list appears/hidden                                                                                                                                                                            | boolean | true |
 | onSelectWithObject | When clicking on the candidate, whether to add other attributes of the selected item option as callback parameters. When set to true, the input parameter type of onSelect will change from `string` to object: {value, label, ...rest} | boolean | false | 1.23.0|
-| placeholder | Input box prompt | string | |
-| position | The display position of the drop-down menu, the optional values are the same as the tooltip component | string | 'bottomLeft' |
-| prefix | The prefix tag of the select box | ReactNode |  | 0.23.0|
-| renderItem | Control the rendering of drop-down list candidates | (option: string\|Item)=> React.Node |  |
-| renderSelectedItem | Customize the drop-down list through renderSelectedItem after the candidate is clicked and selected, the content rendered in the select box<br/>** only supports the return value of String type **| (option: string\|Item) => string |  | 0.23.0|
-| showClear | Whether to show the clear button | boolean | false |
-| size | Size, optional `small`, `default`, `large`  | string | `default` |
-| style | style | object |  |
-| suffix | The prefix tag of the select box | ReactNode |  | 0.23.0|
-| value | The current value | string\|number |  |
-| validateStatus | Validation status, optional values are `default`, `error`, `warning`, and the default is default. Only affect the display style | string | 'default' | 1.14.0|
-| zIndex | ZIndex of the drop-down menu | number |  |
-| onBlur | Callback when the focus is lost | Function(event) | |
-| onChange | Input box change / change when the candidate is selected | Function(value:string\|number) | | 1.23.0|
-| onFocus | The callback when the focus is obtained | Function(event) | |
-| onKeyDown | keydown callback | (e: React.KeyboardEvent) => void | | 2.21.0 |
-| onSearch | Callback when input changes | Function(value: string) | |
-| onSelect | Callback when the drop-down menu candidate is selected | Function(item: string\|number\|Item) | |
+| placeholder | Input box prompt                                                                                                                                                                                                                        | string | |
+| position | The display position of the drop-down menu, the optional values are the same as the tooltip component                                                                                                                                   | string | 'bottomLeft' |
+| prefix | The prefix tag of the select box                                                                                                                                                                                                        | ReactNode |  | 0.23.0|
+| renderItem | Control the rendering of drop-down list candidates                                                                                                                                                                                      | (option: string\|Item)=> React.Node |  |
+| renderSelectedItem | Customize the drop-down list through renderSelectedItem after the candidate is clicked and selected, the content rendered in the select box<br/>** only supports the return value of String type **                                     | (option: string\|Item) => string |  | 0.23.0|
+| showClear | Whether to show the clear button                                                                                                                                                                                                        | boolean | false |
+| size | Size, optional `small`, `default`, `large`                                                                                                                                                                                              | string | `default` |
+| style | style                                                                                                                                                                                                                                   | object |  |
+| suffix | The prefix tag of the select box                                                                                                                                                                                                        | ReactNode |  | 0.23.0|
+| value | The current value                                                                                                                                                                                                                       | string\|number |  |
+| validateStatus | Validation status, optional values are `default`, `error`, `warning`, and the default is default. Only affect the display style                                                                                                         | string | 'default' | 1.14.0|
+| zIndex | ZIndex of the drop-down menu                                                                                                                                                                                                            | number |  |
+| onBlur | Callback when the focus is lost                                                                                                                                                                                                         | Function(event) | |
+| onChange | Input box change / change when the candidate is selected                                                                                                                                                                                | Function(value:string\|number) | | 1.23.0|
+| onFocus | The callback when the focus is obtained                                                                                                                                                                                                 | Function(event) | |
+| onKeyDown | keydown callback                                                                                                                                                                                                                        | (e: React.KeyboardEvent) => void | | 2.21.0 |
+| onSearch | Callback when input changes                                                                                                                                                                                                             | Function(value: string) | |
+| onSelect | Callback when the drop-down menu candidate is selected                                                                                                                                                                                  | Function(item: string\|number\|Item) | |
 
 ## Accessibility
 ### Keyboard and Focus

content/input/autocomplete/index.md

@@ -370,43 +370,43 @@ import { IllustrationNoContent } from '@douyinfe/semi-illustrations';
 
 ## API 参考
 
-| 属性 | 说明 | 类型 | 默认值 | 版本|
-| --- | --- | --- | --- |--- |
-| autoFocus | 是否自动聚焦 | bool | false | 1.16.0|
-| autoAdjustOverflow | 浮层被遮挡时是否自动调整方向 | bool | true | 0.27.0|
-| className | 样式类名 | string | |
-| clearIcon | 可用于自定义清除按钮, showClear为true时有效 | ReactNode | 2.25.0  |
-| data | 候选项的数据源，可以为字符串数组或对象数组 | array | [] |
-| defaultActiveFirstOption | 是否默认高亮第一个选项（按回车可直接选中） | bool | false |
-| defaultOpen | 是否默认展开下拉菜单 | boolean | false |
-| defaultValue | 默认值 | string | |
-| disabled | 是否禁用 | boolean | false |
-| dropdownClassName | 下拉列表的 CSS 类名 | string |  |
-| dropdownStyle | 下拉列表的内联样式 | object |  |
-| emptyContent | data 为空时自定义下拉内容  | ReactNode | null | 1.16.0 |
-| getPopupContainer | 指定父级 DOM，下拉列表浮层将会渲染至该 DOM 中，自定义需要设置 `position: relative` | () => HTMLElement | () => document.body |
-| loading | 下拉列表是否展示加载动画 | boolean | false |
-| maxHeight | 下拉列表的最大高度 | number\|string | 300 |
-| motion | 下拉列表出现/隐藏时，是否有动画 | boolean | true |
-| onSelectWithObject | 点击候选项时，是否将选中项 option 的其他属性也作为回调入参。设为 true 时，onSelect 的入参类型会从 `string` 变为 object: { value, label, ...rest }| boolean | false |1.23.0 |
-| placeholder | 输入框提示 | string | |
-| position | 下拉菜单的显示位置，可选值同 tooltip 组件 | string | 'bottomLeft' |
-| prefix | 选择框的前缀标签 | ReactNode |  | 0.23.0|
-| renderItem | 控制下拉列表候选项的渲染 | (option: string\|Item)=> React.Node |  |
-| renderSelectedItem | 通过 renderSelectedItem 自定义下拉列表候选项被点击选中后，在选择框中的渲染内容<br/>**仅支持 String 类型的返回值**<br/> | (option: string\|Item) => string |  |0.23.0 |
-| showClear | 是否展示清除按钮 | boolean | false |
-| size | 尺寸，可选`small`, `default`, `large`  | string | `default` |
-| style | 样式 | object |  |
-| suffix | 选择框的前缀标签 | ReactNode |  |0.23.0 |
-| validateStatus | 校验状态，可选值`default`、`error`、`warning`，默认 default。仅影响展示样式 | string | 'default' | 1.14.0|
-| value | 当前值 | string\|number | 无 |
-| zIndex | 下拉菜单的 zIndex | number |  |
-| onBlur | 失去焦点时的回调 | Function(event) | |
-| onChange | 输入框变化/候选项选中时变化 | Function(value:string\|number) | |1.23.0 |
-| onFocus | 获得焦点时的回调 | Function(event) | |
-| onKeyDown | keydown 回调 | (e: React.KeyboardEvent) => void | | 2.21.0 |
-| onSearch | 输入变化时的回调 | Function(value: string) | |
-| onSelect | 下拉菜单候选项被选中时的回调 | Function(item: string\|number\|Item) | |
+| 属性 | 说明                                                                                                         | 类型 | 默认值 | 版本|
+| --- |------------------------------------------------------------------------------------------------------------| --- | --- |--- |
+| autoFocus | 是否自动聚焦                                                                                                     | bool | false | 1.16.0|
+| autoAdjustOverflow | 浮层被遮挡时是否自动调整方向                                                                                             | bool | true | 0.27.0|
+| className | 样式类名                                                                                                       | string | |
+| clearIcon | 可用于自定义清除按钮, showClear为true时有效                                                                              | ReactNode | 2.25.0  |
+| data | 候选项的数据源，可以为字符串数组或对象数组                                                                                      | array | [] |
+| defaultActiveFirstOption | 是否默认高亮第一个选项（按回车可直接选中）                                                                                      | bool | false |
+| defaultOpen | 是否默认展开下拉菜单                                                                                                 | boolean | false |
+| defaultValue | 默认值                                                                                                        | string | |
+| disabled | 是否禁用                                                                                                       | boolean | false |
+| dropdownClassName | 下拉列表的 CSS 类名                                                                                               | string |  |
+| dropdownStyle | 下拉列表的内联样式                                                                                                  | object |  |
+| emptyContent | data 为空时自定义下拉内容                                                                                            | ReactNode | null | 1.16.0 |
+| getPopupContainer | 指定父级 DOM，下拉列表浮层将会渲染至该 DOM 中，自定义需要设置 `position: relative` 这会改变浮层 DOM 树位置，但不会改变视图渲染位置。                                                   | () => HTMLElement | () => document.body |
+| loading | 下拉列表是否展示加载动画                                                                                               | boolean | false |
+| maxHeight | 下拉列表的最大高度                                                                                                  | number\|string | 300 |
+| motion | 下拉列表出现/隐藏时，是否有动画                                                                                           | boolean | true |
+| onSelectWithObject | 点击候选项时，是否将选中项 option 的其他属性也作为回调入参。设为 true 时，onSelect 的入参类型会从 `string` 变为 object: { value, label, ...rest } | boolean | false |1.23.0 |
+| placeholder | 输入框提示                                                                                                      | string | |
+| position | 下拉菜单的显示位置，可选值同 tooltip 组件                                                                                  | string | 'bottomLeft' |
+| prefix | 选择框的前缀标签                                                                                                   | ReactNode |  | 0.23.0|
+| renderItem | 控制下拉列表候选项的渲染                                                                                               | (option: string\|Item)=> React.Node |  |
+| renderSelectedItem | 通过 renderSelectedItem 自定义下拉列表候选项被点击选中后，在选择框中的渲染内容<br/>**仅支持 String 类型的返回值**<br/>                           | (option: string\|Item) => string |  |0.23.0 |
+| showClear | 是否展示清除按钮                                                                                                   | boolean | false |
+| size | 尺寸，可选`small`, `default`, `large`                                                                           | string | `default` |
+| style | 样式                                                                                                         | object |  |
+| suffix | 选择框的前缀标签                                                                                                   | ReactNode |  |0.23.0 |
+| validateStatus | 校验状态，可选值`default`、`error`、`warning`，默认 default。仅影响展示样式                                                     | string | 'default' | 1.14.0|
+| value | 当前值                                                                                                        | string\|number | 无 |
+| zIndex | 下拉菜单的 zIndex                                                                                               | number |  |
+| onBlur | 失去焦点时的回调                                                                                                   | Function(event) | |
+| onChange | 输入框变化/候选项选中时变化                                                                                             | Function(value:string\|number) | |1.23.0 |
+| onFocus | 获得焦点时的回调                                                                                                   | Function(event) | |
+| onKeyDown | keydown 回调                                                                                                 | (e: React.KeyboardEvent) => void | | 2.21.0 |
+| onSearch | 输入变化时的回调                                                                                                   | Function(value: string) | |
+| onSelect | 下拉菜单候选项被选中时的回调                                                                                             | Function(item: string\|number\|Item) | |
 
 ## Accessibility
 ### 键盘和焦点

content/input/cascader/index-en-US.md

@@ -1746,72 +1746,72 @@ function Demo() {
 
 ### Cascader
 
-| Properties | Instructions | type | Default | version |
-| ---------- | ------------ | ---- | ------- | ------- |
-| arrowIcon | Customize the right drop-down arrow Icon, when the showClear switch is turned on and there is currently a selected value, hover will give priority to the clear icon  | ReactNode | - | 1.15.0 |
-| autoAdjustOverflow | Whether to automatically adjust the expansion direction of the dropdown for automatic adjustment of the expansion direction during edge occlusion | boolean | true | - |
-| autoMergeValue | Auto merge value. Specifically, after opening, when a parent node is selected, the value will not include the descendants of the node. Does not support dynamic switching | boolean | true |  1.28.0 |
-| borderless        | borderless mode  >=2.33.0                                                                                                                                                                     | boolean                         |           |
-| bottomSlot | bottom slot | ReactNode | - |  1.27.0 |
-| changeOnSelect | Toggle whether non-leaf nodes are selectable | boolean | false | - |
-| className | ClassName | string | - | - |
-| clearIcon | Can be used to customize the clear button, valid when showClear is true | ReactNode | - | 2.25.0 |
-| defaultOpen | Set whether to open the dropDown by default | boolean | false | - |
-| defaultValue | Default selected value | string\|number\|CascaderData\|(string\|number\|CascaderData)[] | - | -  |
-| disabled | Makes the element disabled | boolean | false | - |
-| displayProp | Set the attribute value displayed by the backfill option displayed | string | `label` | - |
-| displayRender | Set the backfill format value | (selected: string[] \| Entity, idx?: number) => ReactNode | selected => selected.join ('/') | -  |
-| dropdownClassName  | ClassName property for the drop-down menu  | string | - | - |
+| Properties | Instructions                                                                                                                                                                                                                                  | type | Default | version |
+| ---------- |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| ---- | ------- | ------- |
+| arrowIcon | Customize the right drop-down arrow Icon, when the showClear switch is turned on and there is currently a selected value, hover will give priority to the clear icon                                                                          | ReactNode | - | 1.15.0 |
+| autoAdjustOverflow | Whether to automatically adjust the expansion direction of the dropdown for automatic adjustment of the expansion direction during edge occlusion                                                                                             | boolean | true | - |
+| autoMergeValue | Auto merge value. Specifically, after opening, when a parent node is selected, the value will not include the descendants of the node. Does not support dynamic switching                                                                     | boolean | true |  1.28.0 |
+| borderless        | borderless mode  >=2.33.0                                                                                                                                                                                                                     | boolean                         |           |
+| bottomSlot | bottom slot                                                                                                                                                                                                                                   | ReactNode | - |  1.27.0 |
+| changeOnSelect | Toggle whether non-leaf nodes are selectable                                                                                                                                                                                                  | boolean | false | - |
+| className | ClassName                                                                                                                                                                                                                                     | string | - | - |
+| clearIcon | Can be used to customize the clear button, valid when showClear is true                                                                                                                                                                       | ReactNode | - | 2.25.0 |
+| defaultOpen | Set whether to open the dropDown by default                                                                                                                                                                                                   | boolean | false | - |
+| defaultValue | Default selected value                                                                                                                                                                                                                        | string\|number\|CascaderData\|(string\|number\|CascaderData)[] | - | -  |
+| disabled | Makes the element disabled                                                                                                                                                                                                                    | boolean | false | - |
+| displayProp | Set the attribute value displayed by the backfill option displayed                                                                                                                                                                            | string | `label` | - |
+| displayRender | Set the backfill format value                                                                                                                                                                                                                 | (selected: string[] \| Entity, idx?: number) => ReactNode | selected => selected.join ('/') | -  |
+| dropdownClassName  | ClassName property for the drop-down menu                                                                                                                                                                                                     | string | - | - |
 | dropdownMargin | Popup layer calculates the size of the safe area when the current direction overflows, used in scenes covered by fixed elements, more detail refer to [issue#549](https://github.com/DouyinFE/semi-design/issues/549), same as Tooltip margin | object\|number | - | 2.25.0 |
-| dropdownStyle | Inline style of drop-down menu  | object  | - | -  |
-| emptyContent | Content displayed when the search has no result | ReactNode | `No result`  | - |
-| filterLeafOnly |  Whether the search results only show the path of leaf nodes   | boolean  | true | 1.26.0  |
-| filterRender | Used to render filtered options | (props: FilterRenderProps) => ReactNode; | - | 2.28.0 |
-| filterSorter | Sort the filtered options | (first: CascaderData, second: CascaderData, inputValue: string) => number | - | 2.28.0 |
-| filterTreeNode | Set filter, the value of treeNodeFilterProp is used for searching, data parameter provided since v2.28.0 | ((inputValue: string, treeNodeString: string, data?: CascaderData) => boolean) \| boolean | false | - |
-| getPopupContainer | Specify the parent DOM, the drop-down box will be rendered into the DOM, the customization needs to set position: relative |() => HTMLElement|() => document.body|-|
-| insetLabel | Prefix alias, used mainly in Form | ReactNode | - | 0.28.0 |
-| leafOnly | When multiple selections, the set value only includes leaf nodes, that is, the displayed Tag and onChange value parameters only include leaf nodes. Does not support dynamic switching | boolean | false | 2.2.0  |
-| loadData | Load data asynchronously and the return value should be a promise | (selectOptions: CascaderData[]) => Promise< void > |-| 1.8.0|
-| max| In the case of multiple selections, the number of multiple selections is limited, and the onExceed callback will be triggered when max is exceeded | number |-|1.28.0|
-| maxTagCount| When multiple selections, the maximum number of labels to be displayed will be displayed in the form of +N after exceeding| number |-|1.28.0|
-| motion | Set the pop-up animation of the dropdown box |boolean|true|-|
-| mouseEnterDelay | After the mouse is moved in, the time to delay the display of the dropdown box, in milliseconds | number | 50 | - |
-| mouseLeaveDelay | After the mouse is moved out, the time to hide the display of the dropdown box, in milliseconds | number | 50 | - |
-| multiple | Set multiple | boolean | false |  1.28.0 |
-| placeholder | Placeholder | string | - | - |
-| prefix | Prefix label | ReactNode | - | 0.28.0  |
-| preventScroll | Indicates whether the browser should scroll the document to display the newly focused element, acting on the focus method inside the component, excluding the component passed in by the user | boolean | - | 2.15.0 |
-|restTagsPopoverProps |The configuration properties of the [Popover](/en-US/show/popover#API%20Reference) |PopoverProps   | {}  |1.28.0|
-| searchPlaceholder  | Placeholder for search input | string | - | -  |
-| separator  | Custom separator, including: the separator of the content displayed in the dropdown during search and displayed in the Trigger during single selection | string| ` / ` | 2.2.0 |
-| showClear |  Toggle whether to show clear button   | boolean  | false | 0.35.0 |
-| showNext| Set the way to expand the Dropdown submenu, one of: `click`、`hover` | string |`click`|1.29.0|
-| showRestTagsPopover| When the number of tags exceeds maxTagCount and hover reaches +N, whether to display the remaining content through Popover| boolean |false|1.28.0|
-| size | Selectbox size, one of `large`, `small`, `default`  | string | `default`  | - |
-| stopPropagation | Whether to prevent the click event on the dropdown box from bubbling | boolean | true | - |
-| disableStrictly | Set whether to enable strict prohibition. After opening, when the node is disabled, the selected state cannot be changed through the relationship between the child or the parent | boolean | false | 1.32.0|
-| style | Inline style | CSSProperties | - | - |
-| suffix | Suffix label | ReactNode | -  | 0.28.0  |
-| topSlot | top slot | ReactNode | - |  1.27.0 |
-| treeData | Render data. Refer to [CascaderData](#CascaderData)  for detailed formatting. | CascaderData[] |  []  | - |
-| treeNodeFilterProp | When searching, the input item filters the corresponding CascaderData property. | string | `label`   | - |
-| triggerRender | Method to create a custom trigger  | (props: TriggerRenderProps) => ReactNode | - | 0.34.0 |
-| value | Selected value (controlled mode) | string\|number\|CascaderData\|(string\|number\|CascaderData)[][]  | - | -  |
-| validateStatus |The validation status of the trigger only affects the display style. Optional: default、error、warning | string | `default` | - |
-| zIndex | zIndex for dropdown menu | number | 1030 | - |
-| enableLeafClick | Multiple mode, click the leaf option enable trigger check | boolean | false | 2.2.0 |
-| onBlur | Out of focus Cascader's callback | (e: MouseEvent) => void | - | - |
-| onChange | Callback function when the tree node is selected | (value: string\|number\|CascaderData\|(string\|number\|CascaderData)[]) => void | - | - |
-| onClear| When showClear is true, click the clear button to trigger the callback | () => void |-|1.29.0|
-| onChangeWithObject | Toggle whether to return all properties in an option as a return value. When set to true, return value looks like CascaderData. For controlled mode, you need to pass CascaderData to value correspondingly. DefaultValue similarly. | boolean | false | 1.16.0 |
-| onDropdownVisibleChange | Callback function when dropdown menu visibility changes   | (visible: boolean) => void | - | 0.35.0 |
-| onExceed| When multiple selections are made, the callback triggered after max is exceeded | (checkedItem: Entity[]) => void |-|1.28.0|
-| onFocus| Focus on Cascader's callback | (e: MouseEvent) => void | - | - |
-| onListScroll | Callback function when panel list scroll | (e: React.Event, panel: { panelIndex: number; activeNode: CascaderData; } ) => void | - | 1.15.0 |
-| onLoad | Callback function when a node is loaded | (newLoadedKeys: Set< string >, data: CascaderData) => void | - | 1.8.0|
-| onSearch | Callback function when the values for search input changes | (value: string) => void | - | - |
-| onSelect | Callback function when selected | (value: string \| number \| (string \| number)[]) => void | - | - |
+| dropdownStyle | Inline style of drop-down menu                                                                                                                                                                                                                | object  | - | -  |
+| emptyContent | Content displayed when the search has no result                                                                                                                                                                                               | ReactNode | `No result`  | - |
+| filterLeafOnly | Whether the search results only show the path of leaf nodes                                                                                                                                                                                   | boolean  | true | 1.26.0  |
+| filterRender | Used to render filtered options                                                                                                                                                                                                               | (props: FilterRenderProps) => ReactNode; | - | 2.28.0 |
+| filterSorter | Sort the filtered options                                                                                                                                                                                                                     | (first: CascaderData, second: CascaderData, inputValue: string) => number | - | 2.28.0 |
+| filterTreeNode | Set filter, the value of treeNodeFilterProp is used for searching, data parameter provided since v2.28.0                                                                                                                                      | ((inputValue: string, treeNodeString: string, data?: CascaderData) => boolean) \| boolean | false | - |
+| getPopupContainer | Specify the parent DOM, the drop-down box will be rendered into the DOM, the customization needs to set position: relative   This will change the DOM tree position, but not the view's rendering position.                                                                                                                   |() => HTMLElement|() => document.body|-|
+| insetLabel | Prefix alias, used mainly in Form                                                                                                                                                                                                             | ReactNode | - | 0.28.0 |
+| leafOnly | When multiple selections, the set value only includes leaf nodes, that is, the displayed Tag and onChange value parameters only include leaf nodes. Does not support dynamic switching                                                        | boolean | false | 2.2.0  |
+| loadData | Load data asynchronously and the return value should be a promise                                                                                                                                                                             | (selectOptions: CascaderData[]) => Promise< void > |-| 1.8.0|
+| max| In the case of multiple selections, the number of multiple selections is limited, and the onExceed callback will be triggered when max is exceeded                                                                                            | number |-|1.28.0|
+| maxTagCount| When multiple selections, the maximum number of labels to be displayed will be displayed in the form of +N after exceeding                                                                                                                    | number |-|1.28.0|
+| motion | Set the pop-up animation of the dropdown box                                                                                                                                                                                                  |boolean|true|-|
+| mouseEnterDelay | After the mouse is moved in, the time to delay the display of the dropdown box, in milliseconds                                                                                                                                               | number | 50 | - |
+| mouseLeaveDelay | After the mouse is moved out, the time to hide the display of the dropdown box, in milliseconds                                                                                                                                               | number | 50 | - |
+| multiple | Set multiple                                                                                                                                                                                                                                  | boolean | false |  1.28.0 |
+| placeholder | Placeholder                                                                                                                                                                                                                                   | string | - | - |
+| prefix | Prefix label                                                                                                                                                                                                                                  | ReactNode | - | 0.28.0  |
+| preventScroll | Indicates whether the browser should scroll the document to display the newly focused element, acting on the focus method inside the component, excluding the component passed in by the user                                                 | boolean | - | 2.15.0 |
+|restTagsPopoverProps | The configuration properties of the [Popover](/en-US/show/popover#API%20Reference)                                                                                                                                                            |PopoverProps   | {}  |1.28.0|
+| searchPlaceholder  | Placeholder for search input                                                                                                                                                                                                                  | string | - | -  |
+| separator  | Custom separator, including: the separator of the content displayed in the dropdown during search and displayed in the Trigger during single selection                                                                                        | string| ` / ` | 2.2.0 |
+| showClear | Toggle whether to show clear button                                                                                                                                                                                                           | boolean  | false | 0.35.0 |
+| showNext| Set the way to expand the Dropdown submenu, one of: `click`、`hover`                                                                                                                                                                           | string |`click`|1.29.0|
+| showRestTagsPopover| When the number of tags exceeds maxTagCount and hover reaches +N, whether to display the remaining content through Popover                                                                                                                    | boolean |false|1.28.0|
+| size | Selectbox size, one of `large`, `small`, `default`                                                                                                                                                                                            | string | `default`  | - |
+| stopPropagation | Whether to prevent the click event on the dropdown box from bubbling                                                                                                                                                                          | boolean | true | - |
+| disableStrictly | Set whether to enable strict prohibition. After opening, when the node is disabled, the selected state cannot be changed through the relationship between the child or the parent                                                             | boolean | false | 1.32.0|
+| style | Inline style                                                                                                                                                                                                                                  | CSSProperties | - | - |
+| suffix | Suffix label                                                                                                                                                                                                                                  | ReactNode | -  | 0.28.0  |
+| topSlot | top slot                                                                                                                                                                                                                                      | ReactNode | - |  1.27.0 |
+| treeData | Render data. Refer to [CascaderData](#CascaderData)  for detailed formatting.                                                                                                                                                                 | CascaderData[] |  []  | - |
+| treeNodeFilterProp | When searching, the input item filters the corresponding CascaderData property.                                                                                                                                                               | string | `label`   | - |
+| triggerRender | Method to create a custom trigger                                                                                                                                                                                                             | (props: TriggerRenderProps) => ReactNode | - | 0.34.0 |
+| value | Selected value (controlled mode)                                                                                                                                                                                                              | string\|number\|CascaderData\|(string\|number\|CascaderData)[][]  | - | -  |
+| validateStatus | The validation status of the trigger only affects the display style. Optional: default、error、warning                                                                                                                                          | string | `default` | - |
+| zIndex | zIndex for dropdown menu                                                                                                                                                                                                                      | number | 1030 | - |
+| enableLeafClick | Multiple mode, click the leaf option enable trigger check                                                                                                                                                                                     | boolean | false | 2.2.0 |
+| onBlur | Out of focus Cascader's callback                                                                                                                                                                                                              | (e: MouseEvent) => void | - | - |
+| onChange | Callback function when the tree node is selected                                                                                                                                                                                              | (value: string\|number\|CascaderData\|(string\|number\|CascaderData)[]) => void | - | - |
+| onClear| When showClear is true, click the clear button to trigger the callback                                                                                                                                                                        | () => void |-|1.29.0|
+| onChangeWithObject | Toggle whether to return all properties in an option as a return value. When set to true, return value looks like CascaderData. For controlled mode, you need to pass CascaderData to value correspondingly. DefaultValue similarly.          | boolean | false | 1.16.0 |
+| onDropdownVisibleChange | Callback function when dropdown menu visibility changes                                                                                                                                                                                       | (visible: boolean) => void | - | 0.35.0 |
+| onExceed| When multiple selections are made, the callback triggered after max is exceeded                                                                                                                                                               | (checkedItem: Entity[]) => void |-|1.28.0|
+| onFocus| Focus on Cascader's callback                                                                                                                                                                                                                  | (e: MouseEvent) => void | - | - |
+| onListScroll | Callback function when panel list scroll                                                                                                                                                                                                      | (e: React.Event, panel: { panelIndex: number; activeNode: CascaderData; } ) => void | - | 1.15.0 |
+| onLoad | Callback function when a node is loaded                                                                                                                                                                                                       | (newLoadedKeys: Set< string >, data: CascaderData) => void | - | 1.8.0|
+| onSearch | Callback function when the values for search input changes                                                                                                                                                                                    | (value: string) => void | - | - |
+| onSelect | Callback function when selected                                                                                                                                                                                                               | (value: string \| number \| (string \| number)[]) => void | - | - |
 
 ### CascaderData
 

content/input/cascader/index.md

@@ -1751,7 +1751,7 @@ function Demo() {
 | filterRender         | 自定义渲染筛选后的选项                                                                                                                                         | (props: FilterRenderProps) => ReactNode;                                                  | -                              | 2.28.0 |
 | filterSorter         | 对筛选后的选项进行排序                                                                                                                                         | (first: CascaderData, second: CascaderData, inputValue: string) => number                 | -                              | 2.28.0 |
 | filterTreeNode       | 设置筛选，默认用 treeNodeFilterProp 的值作为要筛选的 TreeNode 的属性值， data 参数自 v2.28.0 开始提供                                                                           | ((inputValue: string, treeNodeString: string, data?: CascaderData) => boolean) \| boolean | false                          | -      |
-| getPopupContainer    | 指定父级 DOM，下拉框将会渲染至该 DOM 中，自定义需要设置 position: relative                                                                                                 | () => HTMLElement                                                                         | () => document.body            | -      |
+| getPopupContainer    | 指定父级 DOM，下拉框将会渲染至该 DOM 中，自定义需要设置 position: relative   这会改变浮层 DOM 树位置，但不会改变视图渲染位置。                                                                                               | () => HTMLElement                                                                         | () => document.body            | -      |
 | insetLabel           | 前缀标签别名，主要用于 Form                                                                                                                                    | ReactNode                                                                                 | -                              | 0.28.0 |
 | leafOnly             | 多选时设置 value 只包含叶子节点，即显示的 Tag 和 onChange 的 value 参数只包含叶子节点。不支持动态切换                                                                                   | boolean                                                                                   | false                          | 2.2.0  |
 | loadData             | 异步加载数据，需要返回一个Promise                                                                                                                                | (selectOptions: CascaderData[]) => Promise< void >                                        | -                              | 1.8.0  |

content/input/datepicker/index-en-US.md

@@ -881,70 +881,70 @@ function Demo() {
 
 ## API Reference
 
-| Properties         | Instructions                                                                                                                                                                           | Type      | Default | Version    |
-|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------|---------|------------|
-| autoAdjustOverflow | Whether the floating layer automatically adjusts its direction when it is blocked                                                                                                      | boolean   | true    | **0.34.0** |
-| autoFocus          | Automatic access to focus                                                                                                                                                              | boolean   | false   | **1.10.0** |
-| autoSwitchDate     | When the year and month are changed through the left and right buttons and the drop-down menu at the top of the panel, the date is automatically switched. Only valid for `date` type. | boolean   | true    | **1.13.0** |
-| bottomSlot         | Render the bottom extra area                                                                                                                                                           | ReactNode |         | **1.22.0** |
-| borderless        | borderless mode  >=2.33.0                                                                                                                                                                     | boolean                         |           |
-| className          | Class name                                                                                                                                                                             | string    | -       |            |
-| clearIcon          | Can be used to customize the clear button, valid when showClear is true                                                                                                                | ReactNode |         | **2.25.0** |
-| defaultOpen        | Panel displays or hides by default                                                                                                                                                     | boolean   | false   |            |
-| defaultPickerValue | Default panel date                                                                                                                                                                     | ValueType |         |            |
-| defaultValue       | Default value                                                                                                                                                                            | ValueType                                                                                                                                                                                                    |                                             |                           |  |
-| density            | Density of picker panel, one of `default`, `compact`                                                                 | string                                                                                                                                                                                                    | default                                        | **1.17.0**              |
-| disabled           | Is it disabled?                                                                                                                                                                           | boolean                                                                                                                                                                                                   | false                                                                                 |                           |
-| disabledDate       | The date is prohibited from the judgment method, and the date is prohibited when returned to true. Options parameter supported after 1.9.0, rangeEnd supported after 1.29 and rangeInputFocus is supported since 2.22            | <ApiType detail='(date: Date, options: { rangeStart: string, rangeEnd: string, rangeInputFocus: "rangeStart" \| "rangeEnd" \| false }) => boolean'>(date, options) => boolean</ApiType>     | () = > false                                                                          |                           |
-| disabledTime       | Time prohibition configuration, the return value will be transparently passed to [`TimePicker`](/en-US/input/timepicker#API_Reference) as a parameter    | <ApiType detail='(date: Date \| Date[], panelType?: string) => ({ disabledHours:() => number[], disabledMinutes: (hour: number) => number[], disabledSeconds: (hour: number, minute: number) => number[] })'>(date, panelType) => object</ApiType> | () => false        | **0.36.0**                |
-| disabledTimePicker | Disable time selection or not.                                                                                                                                                            | boolean           | **0.32.0**                |
-| dropdownClassName  | CSS classname for drop-down menu                                                                                                                                                          | string                                                               |                                 | **1.13.0** |
+| Properties         | Instructions                                                                                                                                                                                                                                  | Type      | Default | Version    |
+|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------|---------|------------|
+| autoAdjustOverflow | Whether the floating layer automatically adjusts its direction when it is blocked                                                                                                                                                             | boolean   | true    | **0.34.0** |
+| autoFocus          | Automatic access to focus                                                                                                                                                                                                                     | boolean   | false   | **1.10.0** |
+| autoSwitchDate     | When the year and month are changed through the left and right buttons and the drop-down menu at the top of the panel, the date is automatically switched. Only valid for `date` type.                                                        | boolean   | true    | **1.13.0** |
+| bottomSlot         | Render the bottom extra area                                                                                                                                                                                                                  | ReactNode |         | **1.22.0** |
+| borderless        | borderless mode  >=2.33.0                                                                                                                                                                                                                     | boolean                         |           |
+| className          | Class name                                                                                                                                                                                                                                    | string    | -       |            |
+| clearIcon          | Can be used to customize the clear button, valid when showClear is true                                                                                                                                                                       | ReactNode |         | **2.25.0** |
+| defaultOpen        | Panel displays or hides by default                                                                                                                                                                                                            | boolean   | false   |            |
+| defaultPickerValue | Default panel date                                                                                                                                                                                                                            | ValueType |         |            |
+| defaultValue       | Default value                                                                                                                                                                                                                                 | ValueType                                                                                                                                                                                                    |                                             |                           |  |
+| density            | Density of picker panel, one of `default`, `compact`                                                                                                                                                                                          | string                                                                                                                                                                                                    | default                                        | **1.17.0**              |
+| disabled           | Is it disabled?                                                                                                                                                                                                                               | boolean                                                                                                                                                                                                   | false                                                                                 |                           |
+| disabledDate       | The date is prohibited from the judgment method, and the date is prohibited when returned to true. Options parameter supported after 1.9.0, rangeEnd supported after 1.29 and rangeInputFocus is supported since 2.22                         | <ApiType detail='(date: Date, options: { rangeStart: string, rangeEnd: string, rangeInputFocus: "rangeStart" \| "rangeEnd" \| false }) => boolean'>(date, options) => boolean</ApiType>     | () = > false                                                                          |                           |
+| disabledTime       | Time prohibition configuration, the return value will be transparently passed to [`TimePicker`](/en-US/input/timepicker#API_Reference) as a parameter                                                                                         | <ApiType detail='(date: Date \| Date[], panelType?: string) => ({ disabledHours:() => number[], disabledMinutes: (hour: number) => number[], disabledSeconds: (hour: number, minute: number) => number[] })'>(date, panelType) => object</ApiType> | () => false        | **0.36.0**                |
+| disabledTimePicker | Disable time selection or not.                                                                                                                                                                                                                | boolean           | **0.32.0**                |
+| dropdownClassName  | CSS classname for drop-down menu                                                                                                                                                                                                              | string                                                               |                                 | **1.13.0** |
 | dropdownMargin | Popup layer calculates the size of the safe area when the current direction overflows, used in scenes covered by fixed elements, more detail refer to [issue#549](https://github.com/DouyinFE/semi-design/issues/549), same as Tooltip margin | object\|number |  | **2.25.0** |
-| dropdownStyle      | Inline style of drop-down menu                                                                                                                                                           | object                                                               |                                  | **1.13.0** |
-| endDateOffset      | When type is dateRange, set the end date of the selected range                                                                                                                            | (selectedDate?: Date) => Date;                                                                                                                                                                            | -                                                                                     | **1.10.0**                |
-| format             | Date string format displayed in the input box                                                                                                                                             | string                                                                                                                                                                                                    | Corresponding to type: For details, see [Date and Time Format](#Date%20and%20Time%20Format) |                           |
-| getPopupContainer | Specifies the parent DOM, and the bullet layer will be rendered to the DOM, you need to set 'position: relative` | function():HTMLElement | () = > document.body |
-| inputReadOnly      | Is the text box readonly                                                                                                                                                                  | boolean                                                                                                                                                                                                   | false                                                                                 |                           |
-| insetInput        | Whether the input box is embedded in the panel. InsetInputProps type supported after v2.29                                                                                                                                | boolean  \| <ApiType detail='{ placeholder?: { dateStart?: string; dateEnd?: string; timeStart?: string; timeEnd?: string } }'>InsetInputProps</ApiType>                                                                                                                                                                                                | false                                                                                 | **2.7.0**                          |
-| inputStyle         | Input box style                                                                                                                                                                           | object                                                                                                                                                                                                    |                                                                                       |                           |
-| insetLabel         | Prefix label, lower priority than `prefix`                                                                                                                                                | string\|ReactNode                                                                                                                                                                                         |                                                                                       |                           |
-| max                | When multiple is set to true, the number of selected, non-pass or value is null\|undefined, unlimited.                                                                                     | number                                                                                                                                                                                                    | -                                                                                     |                           |
-| multiple           | Whether you can choose multiple, only type = "date" is supported                                                                                                                          | boolean                                                                                                                                                                                                   | false                                                                                 |                           |
-| needConfirm        | Do you need to "confirm selection", only `type= "dateTime"\| "dateTimeRange"` works.       | boolean                                                                                                                                                                                                   |                                                                                       | **0.18.0**                |
-| open               | Controlled properties displayed or hidden by panels                                                                                                                                       | boolean                                                                                                                                                                                                   |                                                                                       |                           |
-| placeholder        | Input box prompts text                                                                                                                                                                    | string\|string[]                                                                                                                                                                                                    | 'Select date'                                                                         |                           |
-| position           | Floating layer position, optional value with [Popover #API Reference · position](/en-US/show/popover#API%20Reference)                                                                 | string                                                                                                                                                                                                    | 'bottomLeft'                                                                          |                           |
-| prefix             | Prefix content                                                                                                                                                                            | string\|ReactNode                                                                                                                                                                                         |                                                                                       |                           |
-| presets            | Date Time Shortcut     |  <ApiType detail='Array< { start: BaseValueType, end :BaseValueType, text: string } \| () => { start:B aseValueType, end: BaseValueType, text: string }>'>Array</ApiType>                                  | []                                                                                    |                           |
-| preventScroll | Indicates whether the browser should scroll the document to display the newly focused element, acting on the focus method inside the component, excluding the component passed in by the user | boolean |  |  |
-| presetPosition     | Date time shortcut panel position, optional 'left', 'right', 'top', 'bottom' | 'bottom' | **2.18.0** |
-| rangeSeparator     | Custom range type picker separator of input trigger | string | '~' | **1.31.0** 
-| renderDate         | Custom date display content                                                                                                                                                               | (dayNumber, fullDate) => ReactNode                                                                                                                                                                        | -                                                                                     | **1.4.0**            |
-| renderFullDate     | Custom display date box                                                                                                                                                                   | (dayNumber, fullDate, dayStatus) => ReactNode                                                                                                                                                             | -                                                                                     | **1.4.0**            |
-| showClear          | Do you show the clear button?                                                                                                                                        | boolean                                                                                                                                                                                                   | true                                                                                  |        **0.35.0**                           |
-| size               | Size, optional: "small," "default," "large"                                                                                                                                               | string                                                                                                                                                                                                    | 'default'                                                                             |                           |
-| spacing            | The distance between the pop-up layer and the children element                                                                                                                            | number                                                                                                                                                                                                    | 4                                                                                     | **1.9.0**                 |
-| startDateOffset    | When type is dateRange, set the start date of the selected range                                                                                                                          | (selectedDate?: Date) => Date;                                                                                                                                                                            | -                                                                                     | **1.10.0**                |
-| startYear | start year of the year scroll panel | number | 100 years before current year | **2.36.0** |
-| endYear | end year of the year scroll panel | number | 100 years after current year | **2.36.0** |
-| syncSwitchMonth    | In the scene of range, it supports synchronous switching of the month of the dual panel|boolean|false|**1.28.0**|
-| timePickerOpts     | For other parameters that can be transparently passed to the time selector, see [TimePicker·API Reference](/en-US/input/timepicker#API%20Reference)                                    |                                                                                                                                                                                                           | object                                                                                | **1.1.0**                 |
-| topSlot            | Render the top extra area                                                                                 | ReactNode                                                                                                                                                                                                 |                                                | **1.22.0**                   |
-| triggerRender      | Custom trigger rendering method                                                                                                                                                           | (TriggerRenderProps) => ReactNode                                                                                                                                                                    |                                                                                       | **0.34.0**                |
-| type               | Type, optional value: "date", "dateRange", "dateTime", "dateTimeRange", "month", "monthRange"                                                                                                           | string                                                                                                                                                                                                    | 'date'                                                                                |  |
-| value              | Controlled value                                                                                                                                                                          | ValueType                                                                                                                                                     |                                                                                       |                           |
-| weekStartsOn       | Take the day of the week as the first day of the week, 0 for Sunday, 1 for Monday, and so on.                                                                                             | number                                                                                                                                                                                                    | 0                                                                                     |                           |
-| onBlur | Callback when focus is lost. It is not recommended to use this API in range selection | (event) => void | () => {} | **1.0.0** |
-| onCancel           | Cancel the callback when selected, enter the reference as the value of the last confirmed selection, only `type` equals "dateTime"or "dateTimeRange" and `needConfirm` equals true        | <ApiType detail='(date: DateType, dateStr: StringType) => void'>(date, dateString) => void</ApiType>                                                              |                                                                                       | **0.18.0**                |
-| onChange           | A callback when the value changes |   <ApiType detail='(date: DateType, dateString: StringType) => void'>(date, dateString) => void</ApiType>       |                                                                                       |                           |
-| onClear            | A callback when click the clear button                                                                                                                                                    | (event) => void                                                                                                                                                                                     | () => {}                                                                              | **1.16.0**           |
-| onClickOutSide    | When the pop-up layer is in a display state, click the non-popup layer and trigger callback | () => void | () => {} | **2.31.0** |
-| onConfirm          | Confirm the callback at the time of selection, enter the reference as the value of the current selection, only `type` equals "dateTime" or "dateTimeRange" and `needConfirm` equals true  |  <ApiType detail='(date: DateType, dateStr: StringType) => void'>(date, dateString) => void</ApiType>|                                                                                       | **0.18.0**                |
-| onFocus | Callback when focus is obtained. It is not recommended to use this API in range selection  | (event) => void | () => {} | **1.0.0** |
-| onOpenChange       | Callback when popup open or close                                                                                                                                 | (isOpen) => void                                                                                                                                                                                 |                                                                                       |                           |
-| onPanelChange      | Callback when the year or date of the panel is switched|  <ApiType detail='(date: DateType \| DateType[], dateStr: StringType \| StringType[])=>void'>(date, dateStr) => void</ApiType>  |  |**1.28.0**|
-| onPresetClick      | Callback when click preset button                                                                          | <ApiType detail='(item: Object, e: Event) => void'>(item, e) => void</ApiType>       |   **1.24.0**                           |
-| yearAndMonthOpts | Other parameters that can be transparently passed to the year-month selector, see details in [ScrollList#API](/zh-CN/show/scrolllist#ScrollItem)|  | object | **2.22.0** |
+| dropdownStyle      | Inline style of drop-down menu                                                                                                                                                                                                                | object                                                               |                                  | **1.13.0** |
+| endDateOffset      | When type is dateRange, set the end date of the selected range                                                                                                                                                                                | (selectedDate?: Date) => Date;                                                                                                                                                                            | -                                                                                     | **1.10.0**                |
+| format             | Date string format displayed in the input box                                                                                                                                                                                                 | string                                                                                                                                                                                                    | Corresponding to type: For details, see [Date and Time Format](#Date%20and%20Time%20Format) |                           |
+| getPopupContainer | Specifies the parent DOM, and the bullet layer will be rendered to the DOM, you need to set 'position: relative`  This will change the DOM tree position, but not the view's rendering position.                                                                                                                              | function():HTMLElement | () = > document.body |
+| inputReadOnly      | Is the text box readonly                                                                                                                                                                                                                      | boolean                                                                                                                                                                                                   | false                                                                                 |                           |
+| insetInput        | Whether the input box is embedded in the panel. InsetInputProps type supported after v2.29                                                                                                                                                    | boolean  \| <ApiType detail='{ placeholder?: { dateStart?: string; dateEnd?: string; timeStart?: string; timeEnd?: string } }'>InsetInputProps</ApiType>                                                                                                                                                                                                | false                                                                                 | **2.7.0**                          |
+| inputStyle         | Input box style                                                                                                                                                                                                                               | object                                                                                                                                                                                                    |                                                                                       |                           |
+| insetLabel         | Prefix label, lower priority than `prefix`                                                                                                                                                                                                    | string\|ReactNode                                                                                                                                                                                         |                                                                                       |                           |
+| max                | When multiple is set to true, the number of selected, non-pass or value is null\|undefined, unlimited.                                                                                                                                        | number                                                                                                                                                                                                    | -                                                                                     |                           |
+| multiple           | Whether you can choose multiple, only type = "date" is supported                                                                                                                                                                              | boolean                                                                                                                                                                                                   | false                                                                                 |                           |
+| needConfirm        | Do you need to "confirm selection", only `type= "dateTime"\| "dateTimeRange"` works.                                                                                                                                                          | boolean                                                                                                                                                                                                   |                                                                                       | **0.18.0**                |
+| open               | Controlled properties displayed or hidden by panels                                                                                                                                                                                           | boolean                                                                                                                                                                                                   |                                                                                       |                           |
+| placeholder        | Input box prompts text                                                                                                                                                                                                                        | string\|string[]                                                                                                                                                                                                    | 'Select date'                                                                         |                           |
+| position           | Floating layer position, optional value with [Popover #API Reference · position](/en-US/show/popover#API%20Reference)                                                                                                                         | string                                                                                                                                                                                                    | 'bottomLeft'                                                                          |                           |
+| prefix             | Prefix content                                                                                                                                                                                                                                | string\|ReactNode                                                                                                                                                                                         |                                                                                       |                           |
+| presets            | Date Time Shortcut                                                                                                                                                                                                                            |  <ApiType detail='Array< { start: BaseValueType, end :BaseValueType, text: string } \| () => { start:B aseValueType, end: BaseValueType, text: string }>'>Array</ApiType>                                  | []                                                                                    |                           |
+| preventScroll | Indicates whether the browser should scroll the document to display the newly focused element, acting on the focus method inside the component, excluding the component passed in by the user                                                 | boolean |  |  |
+| presetPosition     | Date time shortcut panel position, optional 'left', 'right', 'top', 'bottom'                                                                                                                                                                  | 'bottom' | **2.18.0** |
+| rangeSeparator     | Custom range type picker separator of input trigger                                                                                                                                                                                           | string | '~' | **1.31.0** 
+| renderDate         | Custom date display content                                                                                                                                                                                                                   | (dayNumber, fullDate) => ReactNode                                                                                                                                                                        | -                                                                                     | **1.4.0**            |
+| renderFullDate     | Custom display date box                                                                                                                                                                                                                       | (dayNumber, fullDate, dayStatus) => ReactNode                                                                                                                                                             | -                                                                                     | **1.4.0**            |
+| showClear          | Do you show the clear button?                                                                                                                                                                                                                 | boolean                                                                                                                                                                                                   | true                                                                                  |        **0.35.0**                           |
+| size               | Size, optional: "small," "default," "large"                                                                                                                                                                                                   | string                                                                                                                                                                                                    | 'default'                                                                             |                           |
+| spacing            | The distance between the pop-up layer and the children element                                                                                                                                                                                | number                                                                                                                                                                                                    | 4                                                                                     | **1.9.0**                 |
+| startDateOffset    | When type is dateRange, set the start date of the selected range                                                                                                                                                                              | (selectedDate?: Date) => Date;                                                                                                                                                                            | -                                                                                     | **1.10.0**                |
+| startYear | start year of the year scroll panel                                                                                                                                                                                                           | number | 100 years before current year | **2.36.0** |
+| endYear | end year of the year scroll panel                                                                                                                                                                                                             | number | 100 years after current year | **2.36.0** |
+| syncSwitchMonth    | In the scene of range, it supports synchronous switching of the month of the dual panel                                                                                                                                                       |boolean|false|**1.28.0**|
+| timePickerOpts     | For other parameters that can be transparently passed to the time selector, see [TimePicker·API Reference](/en-US/input/timepicker#API%20Reference)                                                                                           |                                                                                                                                                                                                           | object                                                                                | **1.1.0**                 |
+| topSlot            | Render the top extra area                                                                                                                                                                                                                     | ReactNode                                                                                                                                                                                                 |                                                | **1.22.0**                   |
+| triggerRender      | Custom trigger rendering method                                                                                                                                                                                                               | (TriggerRenderProps) => ReactNode                                                                                                                                                                    |                                                                                       | **0.34.0**                |
+| type               | Type, optional value: "date", "dateRange", "dateTime", "dateTimeRange", "month", "monthRange"                                                                                                                                                 | string                                                                                                                                                                                                    | 'date'                                                                                |  |
+| value              | Controlled value                                                                                                                                                                                                                              | ValueType                                                                                                                                                     |                                                                                       |                           |
+| weekStartsOn       | Take the day of the week as the first day of the week, 0 for Sunday, 1 for Monday, and so on.                                                                                                                                                 | number                                                                                                                                                                                                    | 0                                                                                     |                           |
+| onBlur | Callback when focus is lost. It is not recommended to use this API in range selection                                                                                                                                                         | (event) => void | () => {} | **1.0.0** |
+| onCancel           | Cancel the callback when selected, enter the reference as the value of the last confirmed selection, only `type` equals "dateTime"or "dateTimeRange" and `needConfirm` equals true                                                            | <ApiType detail='(date: DateType, dateStr: StringType) => void'>(date, dateString) => void</ApiType>                                                              |                                                                                       | **0.18.0**                |
+| onChange           | A callback when the value changes                                                                                                                                                                                                             |   <ApiType detail='(date: DateType, dateString: StringType) => void'>(date, dateString) => void</ApiType>       |                                                                                       |                           |
+| onClear            | A callback when click the clear button                                                                                                                                                                                                        | (event) => void                                                                                                                                                                                     | () => {}                                                                              | **1.16.0**           |
+| onClickOutSide    | When the pop-up layer is in a display state, click the non-popup layer and trigger callback                                                                                                                                                   | () => void | () => {} | **2.31.0** |
+| onConfirm          | Confirm the callback at the time of selection, enter the reference as the value of the current selection, only `type` equals "dateTime" or "dateTimeRange" and `needConfirm` equals true                                                      |  <ApiType detail='(date: DateType, dateStr: StringType) => void'>(date, dateString) => void</ApiType>|                                                                                       | **0.18.0**                |
+| onFocus | Callback when focus is obtained. It is not recommended to use this API in range selection                                                                                                                                                     | (event) => void | () => {} | **1.0.0** |
+| onOpenChange       | Callback when popup open or close                                                                                                                                                                                                             | (isOpen) => void                                                                                                                                                                                 |                                                                                       |                           |
+| onPanelChange      | Callback when the year or date of the panel is switched                                                                                                                                                                                       |  <ApiType detail='(date: DateType \| DateType[], dateStr: StringType \| StringType[])=>void'>(date, dateStr) => void</ApiType>  |  |**1.28.0**|
+| onPresetClick      | Callback when click preset button                                                                                                                                                                                                             | <ApiType detail='(item: Object, e: Event) => void'>(item, e) => void</ApiType>       |   **1.24.0**                           |
+| yearAndMonthOpts | Other parameters that can be transparently passed to the year-month selector, see details in [ScrollList#API](/zh-CN/show/scrolllist#ScrollItem)                                                                                              |  | object | **2.22.0** |
 
 ## Methods
 

content/input/datepicker/index.md

@@ -844,77 +844,77 @@ function Demo() {
 
 ## API 参考
 
-| 属性               | 说明                                                                      | 类型      | 默认值  | 版本       |
-|--------------------|-------------------------------------------------------------------------|-----------|---------|------------|
-| autoAdjustOverflow | 浮层被遮挡时是否自动调整方向                                              | boolean   | true    | **0.34.0** |
-| autoFocus          | 自动获取焦点                                                              | boolean   | false   | **1.10.0** |
-| autoSwitchDate     | 通过面板上方左右按钮、下拉菜单更改年月时，自动切换日期。仅对 date type 生效。 | boolean   | true    | **1.13.0** |
-| borderless        | 无边框模式  >=2.33.0                                                                                                                                     | boolean                         |           |
-| bottomSlot         | 渲染底部额外区域                                                          | ReactNode |         | **1.22.0** |
-| className          | 类名                                                                      | string    | -       |            |
-| clearIcon          | 可用于自定义清除按钮, showClear为true时有效                               | ReactNode |         | **2.25.0** |
-| defaultOpen        | 面板默认显示或隐藏                                                        | boolean   | false   |            |
-| defaultPickerValue | 默认面板日期                                                              | ValueType |         |            |
-| defaultValue       | 默认值                                                                    | ValueType |         |            |
-| density            | 面板的尺寸，可选值：`default`, `compact`                                    | string    | default | **1.17.0** |
-| disabled           | 是否禁用                                                                  | boolean   | false   |            |
-| disabledDate | 日期禁止判断方法，返回为 true 时禁止该日期，options 参数 1.9.0 后支持，其中 rangeEnd 1.29 后支持，rangeInputFocus 2.22 后支持 | <ApiType detail='(date: Date, options: { rangeStart: string, rangeEnd: string, rangeInputFocus: "rangeStart" \| "rangeEnd" \| false }) => boolean'>(date, options) => boolean</ApiType> | () => false   |
-| disabledTime | 时间禁止配置，返回值将会作为参数透传给 [`TimePicker`](/zh-CN/input/timepicker#API_参考) | <ApiType detail='(date: Date \| Date[], panelType?: string) => ({ disabledHours:() => number[], disabledMinutes: (hour: number) => number[], disabledSeconds: (hour: number, minute: number) => number[] })'>(date, panelType) => object</ApiType> | () => false | **0.36.0** |
-| disabledTimePicker | 是否禁止时间选择 | boolean |  | **0.32.0** |
-| dropdownClassName | 下拉列表的 CSS 类名 | string |  | **1.13.0** |
-| dropdownStyle | 下拉列表的内联样式 | object |  | **1.13.0** |
-| dropdownMargin | 下拉列表算溢出时的增加的冗余值，详见[issue#549](https://github.com/DouyinFE/semi-design/issues/549)，作用同 Tooltip margin      | object\|number  |  | **2.25.0**
-| endDateOffset | type 为 dateRange 时，设置单击选择范围的结束日期 | (selectedDate?: Date) => Date; | - | **1.10.0** |
-| format | 在输入框内展现的日期串格式 | string | 与 type 对应：详见[日期时间格式](#日期时间格式) |  |
-| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 `position: relative` | function():HTMLElement | () => document.body |  |
-| hideDisabledOptions | 隐藏禁止选择的时间 | boolean | false |  |
-| insetInput | 面板中是否嵌入输入框，InsetInputProps 类型 v2.29 支持  | boolean \| <ApiType detail='{ placeholder?: { dateStart?: string; dateEnd?: string; timeStart?: string; timeEnd?: string } }'>InsetInputProps</ApiType>  | false | **2.7.0** |
-| inputReadOnly | 文本框是否 readonly | boolean | false |  |
-| inputStyle | 输入框样式 | object |  |  |
-| insetLabel | 前缀标签，优先级低于 `prefix` | string\|ReactNode |  |  |
-| max | multiple 为 true 时，多选的数目,不传或者值为 null\|undefined 的话无限制 | number | - |  |
-| motion | 是否开启面板展开的动画 | boolean | true |  |
-| multiple | 是否可以选择多个，仅支持 type="date" | boolean | false |  |
-| needConfirm | 是否需要“确认选择”，仅 type="dateTime"\|"dateTimeRange" 时有效 | boolean |  | **0.18.0** |
-| open | 面板显示或隐藏的受控属性 | boolean |  |  |
-| placeholder | 输入框提示文字 | string\|string[] | 'Select date' |  |
-| position | 浮层位置，可选值同[Popover#API 参考·position 参数](/zh-CN/show/popover#API参考) | string | 'bottomLeft' |  |
-| prefix | 前缀内容 | string\|ReactNode |  |  |
-| presets | 日期时间快捷方式 |  <ApiType detail='Array< { start: BaseValueType, end :BaseValueType, text: string } \| () => { start:B aseValueType, end: BaseValueType, text: string }>'>Array</ApiType> | [] |  |
-| preventScroll | 指示浏览器是否应滚动文档以显示新聚焦的元素，作用于组件内的 focus 方法 | boolean |  |  |
-| presetPosition | 日期时间快捷方式面板位置, 可选值'left', 'right', 'top', 'bottom' | string |  'bottom' | **2.18.0** |
-| rangeSeparator | 自定义范围类型输入框的日期分隔符 | string | '~' | **1.31.0** |
-| renderDate | 自定义日期显示内容 | (dayNumber, fullDate) => ReactNode | - | **1.4.0** |
-| renderFullDate | 自定义显示日期格子内容 | (dayNumber, fullDate, dayStatus) => ReactNode | - | **1.4.0** |
-| showClear | 是否显示清除按钮 | boolean | true | **0.35.0** |
-| size | 尺寸，可选值："small", "default", "large" | string | 'default' |  |
-| spacing | 浮层与 trigger 的距离 | number | 4 | **1.9.0** |
-| startDateOffset | type 为 dateRange 时，设置单击选择范围的开始日期 | <ApiType detail='(selectedDate?: Date) => Date '>(selectedDate) => Date </ApiType>| - | **1.10.0** |
-| startYear | 滚轮的开始年 | number | 当前年前 100 年 | **2.36.0** |
-| endYear | 滚轮的结束年，结束年需要大于开始年 | number | 当前年后 100 年 | **2.36.0** |
-| stopPropagation | 是否阻止弹出层上的点击事件冒泡 | boolean | false |  |
-| style | 自定义样式 | CSSProperties |  |  |
-| syncSwitchMonth | 在范围选择的场景中，支持同步切换双面板的月份 | boolean | false | **1.28.0** |
-| timePickerOpts | 其他可以透传给时间选择器的参数，详见 [TimePicker·API 参考](/zh-CN/input/timepicker#API_参考) |  | object | **1.1.0** |
-| topSlot | 渲染顶部额外区域 | ReactNode |  | **1.22.0** |
-| triggerRender | 自定义触发器渲染方法，第一个参数是个 Object，详情看下方类型定义 | (props) => ReactNode| | **0.34.0** |
-| type | 类型，可选值："date", "dateRange", "dateTime", "dateTimeRange", "month", "monthRange" | string | 'date' |  |
-| validateStatus | 校验状态，可选值 default、error、warning，默认 default。仅影响展示样式 | string |  |  |
-| value | 受控的值 | ValueType |  |  |
-| weekStartsOn | 以周几作为每周第一天，0 代表周日，1 代表周一，以此类推 | number | 0 |  |
-| zIndex | 弹出面板的 zIndex | number | 1030 |  |
-| onBlur | 失去焦点时的回调，范围选择时不推荐使用 | (e: event) => void | () => {} | **1.0.0** |
+| 属性               | 说明                                                                                                   | 类型      | 默认值  | 版本       |
+|--------------------|------------------------------------------------------------------------------------------------------|-----------|---------|------------|
+| autoAdjustOverflow | 浮层被遮挡时是否自动调整方向                                                                                       | boolean   | true    | **0.34.0** |
+| autoFocus          | 自动获取焦点                                                                                               | boolean   | false   | **1.10.0** |
+| autoSwitchDate     | 通过面板上方左右按钮、下拉菜单更改年月时，自动切换日期。仅对 date type 生效。                                                         | boolean   | true    | **1.13.0** |
+| borderless        | 无边框模式  >=2.33.0                                                                                      | boolean                         |           |
+| bottomSlot         | 渲染底部额外区域                                                                                             | ReactNode |         | **1.22.0** |
+| className          | 类名                                                                                                   | string    | -       |            |
+| clearIcon          | 可用于自定义清除按钮, showClear为true时有效                                                                        | ReactNode |         | **2.25.0** |
+| defaultOpen        | 面板默认显示或隐藏                                                                                            | boolean   | false   |            |
+| defaultPickerValue | 默认面板日期                                                                                               | ValueType |         |            |
+| defaultValue       | 默认值                                                                                                  | ValueType |         |            |
+| density            | 面板的尺寸，可选值：`default`, `compact`                                                                       | string    | default | **1.17.0** |
+| disabled           | 是否禁用                                                                                                 | boolean   | false   |            |
+| disabledDate | 日期禁止判断方法，返回为 true 时禁止该日期，options 参数 1.9.0 后支持，其中 rangeEnd 1.29 后支持，rangeInputFocus 2.22 后支持          | <ApiType detail='(date: Date, options: { rangeStart: string, rangeEnd: string, rangeInputFocus: "rangeStart" \| "rangeEnd" \| false }) => boolean'>(date, options) => boolean</ApiType> | () => false   |
+| disabledTime | 时间禁止配置，返回值将会作为参数透传给 [`TimePicker`](/zh-CN/input/timepicker#API_参考)                                   | <ApiType detail='(date: Date \| Date[], panelType?: string) => ({ disabledHours:() => number[], disabledMinutes: (hour: number) => number[], disabledSeconds: (hour: number, minute: number) => number[] })'>(date, panelType) => object</ApiType> | () => false | **0.36.0** |
+| disabledTimePicker | 是否禁止时间选择                                                                                             | boolean |  | **0.32.0** |
+| dropdownClassName | 下拉列表的 CSS 类名                                                                                         | string |  | **1.13.0** |
+| dropdownStyle | 下拉列表的内联样式                                                                                            | object |  | **1.13.0** |
+| dropdownMargin | 下拉列表算溢出时的增加的冗余值，详见[issue#549](https://github.com/DouyinFE/semi-design/issues/549)，作用同 Tooltip margin | object\|number  |  | **2.25.0**
+| endDateOffset | type 为 dateRange 时，设置单击选择范围的结束日期                                                                     | (selectedDate?: Date) => Date; | - | **1.10.0** |
+| format | 在输入框内展现的日期串格式                                                                                        | string | 与 type 对应：详见[日期时间格式](#日期时间格式) |  |
+| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 `position: relative` 这会改变浮层 DOM 树位置，但不会改变视图渲染位置。                                                 | function():HTMLElement | () => document.body |  |
+| hideDisabledOptions | 隐藏禁止选择的时间                                                                                            | boolean | false |  |
+| insetInput | 面板中是否嵌入输入框，InsetInputProps 类型 v2.29 支持                                                               | boolean \| <ApiType detail='{ placeholder?: { dateStart?: string; dateEnd?: string; timeStart?: string; timeEnd?: string } }'>InsetInputProps</ApiType>  | false | **2.7.0** |
+| inputReadOnly | 文本框是否 readonly                                                                                       | boolean | false |  |
+| inputStyle | 输入框样式                                                                                                | object |  |  |
+| insetLabel | 前缀标签，优先级低于 `prefix`                                                                                  | string\|ReactNode |  |  |
+| max | multiple 为 true 时，多选的数目,不传或者值为 null\|undefined 的话无限制                                                 | number | - |  |
+| motion | 是否开启面板展开的动画                                                                                          | boolean | true |  |
+| multiple | 是否可以选择多个，仅支持 type="date"                                                                             | boolean | false |  |
+| needConfirm | 是否需要“确认选择”，仅 type="dateTime"\|"dateTimeRange" 时有效                                                    | boolean |  | **0.18.0** |
+| open | 面板显示或隐藏的受控属性                                                                                         | boolean |  |  |
+| placeholder | 输入框提示文字                                                                                              | string\|string[] | 'Select date' |  |
+| position | 浮层位置，可选值同[Popover#API 参考·position 参数](/zh-CN/show/popover#API参考)                                     | string | 'bottomLeft' |  |
+| prefix | 前缀内容                                                                                                 | string\|ReactNode |  |  |
+| presets | 日期时间快捷方式                                                                                             |  <ApiType detail='Array< { start: BaseValueType, end :BaseValueType, text: string } \| () => { start:B aseValueType, end: BaseValueType, text: string }>'>Array</ApiType> | [] |  |
+| preventScroll | 指示浏览器是否应滚动文档以显示新聚焦的元素，作用于组件内的 focus 方法                                                               | boolean |  |  |
+| presetPosition | 日期时间快捷方式面板位置, 可选值'left', 'right', 'top', 'bottom'                                                    | string |  'bottom' | **2.18.0** |
+| rangeSeparator | 自定义范围类型输入框的日期分隔符                                                                                     | string | '~' | **1.31.0** |
+| renderDate | 自定义日期显示内容                                                                                            | (dayNumber, fullDate) => ReactNode | - | **1.4.0** |
+| renderFullDate | 自定义显示日期格子内容                                                                                          | (dayNumber, fullDate, dayStatus) => ReactNode | - | **1.4.0** |
+| showClear | 是否显示清除按钮                                                                                             | boolean | true | **0.35.0** |
+| size | 尺寸，可选值："small", "default", "large"                                                                   | string | 'default' |  |
+| spacing | 浮层与 trigger 的距离                                                                                      | number | 4 | **1.9.0** |
+| startDateOffset | type 为 dateRange 时，设置单击选择范围的开始日期                                                                     | <ApiType detail='(selectedDate?: Date) => Date '>(selectedDate) => Date </ApiType>| - | **1.10.0** |
+| startYear | 滚轮的开始年                                                                                               | number | 当前年前 100 年 | **2.36.0** |
+| endYear | 滚轮的结束年，结束年需要大于开始年                                                                                    | number | 当前年后 100 年 | **2.36.0** |
+| stopPropagation | 是否阻止弹出层上的点击事件冒泡                                                                                      | boolean | false |  |
+| style | 自定义样式                                                                                                | CSSProperties |  |  |
+| syncSwitchMonth | 在范围选择的场景中，支持同步切换双面板的月份                                                                               | boolean | false | **1.28.0** |
+| timePickerOpts | 其他可以透传给时间选择器的参数，详见 [TimePicker·API 参考](/zh-CN/input/timepicker#API_参考)                               |  | object | **1.1.0** |
+| topSlot | 渲染顶部额外区域                                                                                             | ReactNode |  | **1.22.0** |
+| triggerRender | 自定义触发器渲染方法，第一个参数是个 Object，详情看下方类型定义                                                                  | (props) => ReactNode| | **0.34.0** |
+| type | 类型，可选值："date", "dateRange", "dateTime", "dateTimeRange", "month", "monthRange"                       | string | 'date' |  |
+| validateStatus | 校验状态，可选值 default、error、warning，默认 default。仅影响展示样式                                                    | string |  |  |
+| value | 受控的值                                                                                                 | ValueType |  |  |
+| weekStartsOn | 以周几作为每周第一天，0 代表周日，1 代表周一，以此类推                                                                        | number | 0 |  |
+| zIndex | 弹出面板的 zIndex                                                                                         | number | 1030 |  |
+| onBlur | 失去焦点时的回调，范围选择时不推荐使用                                                                                  | (e: event) => void | () => {} | **1.0.0** |
 | onCancel | 取消选择时的回调，入参为上次确认选择的值，仅 type="dateTime"\|"dateTimeRange" 且 needConfirm=true 时有效。<br/>0.x版本入参顺序与新版有所不同 | <ApiType detail='(date: DateType, dateStr: StringType) => void'>(date, dateString) => void</ApiType> |  | **0.18.0** |
-| onChange | 值变化时的回调。<br/>0.x版本入参顺序与新版有所不同 | <ApiType detail='(date: DateType, dateString: StringType) => void'>(date, dateString) => void</ApiType> |  |  |
-| onChangeWithDateFirst | 0.x 中 onChange(string, Date), 1.0 后(Date, string)。此开关设为 false 时，入参顺序将与 0.x 版本保持一致 | boolean | true | **1.0.0** |
-| onClear | 点击 clear 按钮时触发 | (e: event) => void | () => {} | **1.16.0** |
-| onClickOutSide | 当弹出层处于展示状态，点击非弹出层、触发器的回调 | () => void | () => {} | **2.31.0** |
-| onConfirm | 确认选择时的回调，入参为当前选择的值，仅 type="dateTime"\|"dateTimeRange" 且 needConfirm=true 时有效。<br/>0.x版本入参顺序与新版有所不同 | <ApiType detail='(date: DateType, dateStr: StringType) => void'>(date, dateString) => void</ApiType>|  | **0.18.0** |
-| onFocus | 获得焦点时的回调，范围选择时不推荐使用 | (e: event) => void | () => {} | **1.0.0** |
-| onOpenChange | 面板显示或隐藏状态切换的回调 | <ApiType detail='(isOpen: boolean) => void'>(isOpen) => void</ApiType> |  |  |
-| onPanelChange | 切换面板的年份或者日期时的回调 | <ApiType detail='(date: DateType \| DateType[], dateStr: StringType \| StringType[])=>void'>(date, dateStr) => void</ApiType> | function | **1.28.0** |
-| onPresetClick | 点击快捷选择按钮的回调 | <ApiType detail='(item: Object, e: Event) => void'>(item, e) => void</ApiType> | () => {}  | **1.24.0** |
-| yearAndMonthOpts | 其他可以透传给年月选择器的参数，详见 [ScrollList#API](/zh-CN/show/scrolllist#ScrollItem)|  | object | **2.20.0** |
+| onChange | 值变化时的回调。<br/>0.x版本入参顺序与新版有所不同                                                                        | <ApiType detail='(date: DateType, dateString: StringType) => void'>(date, dateString) => void</ApiType> |  |  |
+| onChangeWithDateFirst | 0.x 中 onChange(string, Date), 1.0 后(Date, string)。此开关设为 false 时，入参顺序将与 0.x 版本保持一致                    | boolean | true | **1.0.0** |
+| onClear | 点击 clear 按钮时触发                                                                                       | (e: event) => void | () => {} | **1.16.0** |
+| onClickOutSide | 当弹出层处于展示状态，点击非弹出层、触发器的回调                                                                             | () => void | () => {} | **2.31.0** |
+| onConfirm | 确认选择时的回调，入参为当前选择的值，仅 type="dateTime"\|"dateTimeRange" 且 needConfirm=true 时有效。<br/>0.x版本入参顺序与新版有所不同   | <ApiType detail='(date: DateType, dateStr: StringType) => void'>(date, dateString) => void</ApiType>|  | **0.18.0** |
+| onFocus | 获得焦点时的回调，范围选择时不推荐使用                                                                                  | (e: event) => void | () => {} | **1.0.0** |
+| onOpenChange | 面板显示或隐藏状态切换的回调                                                                                       | <ApiType detail='(isOpen: boolean) => void'>(isOpen) => void</ApiType> |  |  |
+| onPanelChange | 切换面板的年份或者日期时的回调                                                                                      | <ApiType detail='(date: DateType \| DateType[], dateStr: StringType \| StringType[])=>void'>(date, dateStr) => void</ApiType> | function | **1.28.0** |
+| onPresetClick | 点击快捷选择按钮的回调                                                                                          | <ApiType detail='(item: Object, e: Event) => void'>(item, e) => void</ApiType> | () => {}  | **1.24.0** |
+| yearAndMonthOpts | 其他可以透传给年月选择器的参数，详见 [ScrollList#API](/zh-CN/show/scrolllist#ScrollItem)                               |  | object | **2.20.0** |
 
 ## Methods
 

content/input/form/index-en-US.md

@@ -1956,15 +1956,15 @@ The table below describes the features available in the formApi.
 
 
 | Function      | Description                                                                        | example                                                                                                                       |
-| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |-------------------------------------------------------------------------------------------------------------------------------|
 | getFormState  | Get FormState                                                                                                                                                                                                                                                                                                                      | formApi.getFormState()                                                                                                        |
 | submitForm    | Manually submit form operation                                                                                                                                                                                                                                                                                               | formApi.submitForm()                                                                                                          |
-| reset         | Reset the form manually                                                                                                                                                                                                                                                                                                            | formApi.reset()                                                                                                               |
-| validate      | Manually trigger validation of the entire form. the verification of the entire Field will be triggered by default when no parameters are passed , if you want to trigger the verification of some fields, pass in the target field array <br/><br/> After the Form level validator is configured, the Field level validator will not be triggered again when submit or formApi.validate()  | formApi.validate() <br/>.then(values ​​=> {})<br/>.catch(errors => {})<br/>OR formApi.validate(['fieldA','fieldB'])                                                        |
+| reset         | Reset the form manually                                                                                                                                                                                                                                                                                                            | formApi.reset(fields?: Array <string\>)                                                                                      |
+| validate      | Manually trigger validation of the entire form. the verification of the entire Field will be triggered by default when no parameters are passed , if you want to trigger the verification of some fields, pass in the target field array <br/><br/> After the Form level validator is configured, the Field level validator will not be triggered again when submit or formApi.validate()  | formApi.validate() <br/>.then(values ​​=> {})<br/>.catch(errors => {})<br/>OR formApi.validate(['fieldA','fieldB'])           |
 | setValues ​​  | Set the values ​​of the entire form. The isOverride in the second parameter is false by default. <br/> By default, only the values ​​of the existing field in the Form are updated from `newValues` to`formState.values`. <br/> When isOverride is `true`, the newValues ​​will be overwritten and assigned to formState.values ​​ | formApi.setValues(newValues: object, {isOverride: boolean})                                                                   |
 | getValues ​​  | Get the values of all Field                                                                                                                                                                                                                                                                                                        | formApi.getValues()                                                                                                           |
 | setValue      | provides direct modification of formState.values ​​method.<br/>The difference from `setValues` ​​is that it only modifies a single field.                                                                                                                                                                                          | formApi.setValue(field: string, newFieldValue: any)                                                                           |
-| getValue      | Get the value of all / single Field                                                                                                                                                                                                                                                                                                | formApi.getValue()<br/>formApi.getValue(field: string)                                                                         |
+| getValue      | Get the value of all / single Field                                                                                                                                                                                                                                                                                                | formApi.getValue()<br/>formApi.getValue(field: string)                                                                        |
 | setTouched    | Modify formState.touched                                                                                                                                                                                                                                                                                                           | formApi.setTouched(field: string, isTouched: boolean)<br/>                                                                    |
 | getTouched    | Get the touched state of the Field                                                                                                                                                                                                                                                                                                 | formApi.getTouched(field: string)                                                                                             |
 | setError      | Modify the error information of a field                                                                                                                                                                                                                                                                                            | formApi.setError(field: string, fieldErrorMessage: string)                                                                    |

content/input/form/index.md

@@ -1951,22 +1951,22 @@ FormState 存储了所有 Form 内部的状态值，包括各表单控件的值
     为了防止用户在读取 formState、values 等内部状态后，意外操作直接了修改 Form 组件的内部状态等情况，Semi 对于 formApi.setValue、setValues的入参、formApi.getFormState、getValue、getValues的返回结果都会自动进行 deepClone
 </Notice>
 
-| Function      | 说明                                                                                                                                                                                                                             | example                                                                                                                       |
-| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
-| getFormState  | 获取 FormState                                                                                                                                                                                                                   | formApi.getFormState()                                                                                                        |
-| submitForm    | 可手动触发 submit 提交操作                                                                                                                                                                                                       | formApi.submitForm()                                                                                                        |
-| reset         | 可手动对 form 进行重置                                                                                                                                                                                                           | formApi.reset()                                                                                                          |
-| validate      | 可手动触发对表单的校验，不传参时默认触发整全体Field的校验（配置Form级别校验器后，Field级别校验器在submit或formApi.validate()时不会再被触发），若想触发部分field的校验，将目标field数组传入即可                                                                                                                                                                                                       | formApi.validate()<br/>.then(values=>{})<br/>.catch(errors=>{}) <br/>或 formApi.validate(\['fieldA','fieldB'\])<br/>                                                              |
-| setValues     | 设置整个表单的值。第二个参数中的 isOverride 默认为 false<br/>默认情况下只会从`newValues`中取 Form 中已存在的 field 的值更新到`formState.values`中。<br/>当 isOverride 为`true`时，会直接以 newValues 覆盖赋值给 formState.values | formApi.setValues(newValues: object, { isOverride: boolean })                                                                 |
-| setValue      | 提供直接修改 formState.values 方法，与 setValues 的区别是它仅修改单个 field                                                                                                                                                      | formApi.setValue(field: string, newFieldValue: any)                                                                           |
-| getValue      | 获取 单个 Field 的值                                                                                                                                                                                                             | formApi.getValue() <br/>formApi.getValue(field: string)                                                                        |
-| getValues     | 获取 所有 Field 的值                                                                                                                                                                         | formApi.getValues()                                                                                                           |
-| setTouched    | 修改 formState.touched                                                                                                                                                                                                           | formApi.setTouched(field: string, isTouched: boolean) <br/>                                                                   |
-| getTouched    | 获取 Field 的 touched 状态                                                                                                                                                                                                       | formApi.getTouched(field: string)                                                                                             |
-| setError      | 修改 某个 field 的 error 信息                                                                                                                                                                                                    | formApi.setError(field: string, fieldErrorMessage: string)                                                                    |
-| getError      | 获取 Field 的 error 状态                                                                                                                                                                                                         | formApi.getError(field: string)                                                                                               |
-| getFieldExist | 获取 Form 中是否存在对应的 field                                                                                                                                                                                                 | formApi.getFieldExist(field: string)                                                                                          |
-| scrollToField | 滚动至指定的 field                                                                                                                                                                                                                   | formApi.scrollToField(field: string, scrollOpts: object) |
+| Function      | 说明                                                                                                                                                                                                                             | example                                                                                                             |
+| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |---------------------------------------------------------------------------------------------------------------------|
+| getFormState  | 获取 FormState                                                                                                                                                                                                                   | formApi.getFormState()                                                                                              |
+| submitForm    | 可手动触发 submit 提交操作                                                                                                                                                                                                       | formApi.submitForm()                                                                                                |
+| reset         | 可手动对 form 进行重置                                                                                                                                                                                                           | formApi.reset(fields?: Array <string\>)                                                                             |
+| validate      | 可手动触发对表单的校验，不传参时默认触发整全体Field的校验（配置Form级别校验器后，Field级别校验器在submit或formApi.validate()时不会再被触发），若想触发部分field的校验，将目标field数组传入即可                                                                                                                                                                                                       | formApi.validate()<br/>.then(values=>{})<br/>.catch(errors=>{}) <br/>或 formApi.validate(\['fieldA','fieldB'\])<br/> |
+| setValues     | 设置整个表单的值。第二个参数中的 isOverride 默认为 false<br/>默认情况下只会从`newValues`中取 Form 中已存在的 field 的值更新到`formState.values`中。<br/>当 isOverride 为`true`时，会直接以 newValues 覆盖赋值给 formState.values | formApi.setValues(newValues: object, { isOverride: boolean })                                                       |
+| setValue      | 提供直接修改 formState.values 方法，与 setValues 的区别是它仅修改单个 field                                                                                                                                                      | formApi.setValue(field: string, newFieldValue: any)                                                                 |
+| getValue      | 获取 单个 Field 的值                                                                                                                                                                                                             | formApi.getValue() <br/>formApi.getValue(field: string)                                                             |
+| getValues     | 获取 所有 Field 的值                                                                                                                                                                         | formApi.getValues()                                                                                                 |
+| setTouched    | 修改 formState.touched                                                                                                                                                                                                           | formApi.setTouched(field: string, isTouched: boolean) <br/>                                                         |
+| getTouched    | 获取 Field 的 touched 状态                                                                                                                                                                                                       | formApi.getTouched(field: string)                                                                                   |
+| setError      | 修改 某个 field 的 error 信息                                                                                                                                                                                                    | formApi.setError(field: string, fieldErrorMessage: string)                                                          |
+| getError      | 获取 Field 的 error 状态                                                                                                                                                                                                         | formApi.getError(field: string)                                                                                     |
+| getFieldExist | 获取 Form 中是否存在对应的 field                                                                                                                                                                                                 | formApi.getFieldExist(field: string)                                                                                |
+| scrollToField | 滚动至指定的 field                                                                                                                                                                                                                   | formApi.scrollToField(field: string, scrollOpts: object)                                                            |
 ### 如何获取 formApi
 
 -   Form 组件在 ComponentDidMount 阶段，会执行 props 传入的 getFormApi 回调，你可以在回调函数中保存 formApi 的引用，以便后续进行调用(**示例如下代码**)  

content/input/select/index-en-US.md

@@ -1319,74 +1319,74 @@ import { Select, Checkbox } from '@douyinfe/semi-ui';
 
 ### Select Props
 
-| Properties | Instructions | Type | Default | version |
-| --- | --- | --- | --- | --- |
-| allowCreate | Whether to allow the user to create new entries. Needs to be used with `filter`. When allowCreate is enabled, it will no longer respond to updates to children or optionList | boolean | false |
-| arrowIcon | Customize the right drop-down arrow Icon, when the showClear switch is turned on and there is currently a selected value, hover will give priority to the clear icon  | ReactNode |  | 1.15.0|
-| autoAdjustOverflow | Whether the pop-up layer automatically adjusts the direction when it is obscured (only vertical direction is supported for the time being, and the inserted parent is body) | boolean | true |
-| autoClearSearchValue | After selecting the option, whether to automatically clear the search keywords, it will take effect when mutilple and filter are both enabled | boolean | true | 2.3.0|
-| autoFocus | Whether automatically focus when component mount | boolean | false |
-| borderless        | borderless mode  >=2.33.0                                                                                                                                                                     | boolean                         |           |
-| className | The CSS class name of the wrapper element | string |  |
-| clearIcon    | Can be used to customize the clear button, valid when showClear is true                       | ReactNode                       |   | 2.25.0 |
-| clickToHide | When expanded, click on the selection box to automatically put away the drop-down list | boolean | false |
-| defaultValue | Originally selected value when component mount | string\|number\|array |  |
-| defaultOpen | Whether show dropdown when component mounted | boolean | false |
-| defaultActiveFirstOption | Whether to highlight the first option by default (press Enter to select directly) | boolean | true |
-| disabled | Whether disabled component | boolean | false |
-| dropdownClassName | ClassName of the pop-up layer | string |  |
-| dropdownMatchSelectWidth | Is the minimum width of the drop-down menu equal to Select | boolean | true |
-| dropdownMargin | Popup layer calculates the size of the safe area when the current direction overflows, used in scenes covered by fixed elements, more detail refer to [issue#549](https://github.com/DouyinFE/semi-design/issues/549), same as Tooltip margin | object\|number |  | 2.25.0 |
-| dropdownStyle | The inline style of the pop-up layer | object |  |
-| emptyContent | Content displayed when there is no result. When set to null, the drop-down list will not be displayed | string | ReactNode |  |
-| ellipsisTrigger | When maxTagCount exists and is multi-select, whether to perform adaptive processing on the overflow part of the tag(When the width is insufficient, the last tag content is truncated). After enabling this function, there will be a certain performance loss, and it is not recommended to use it in large form scenarios  | boolean   | false       | 2.28.0 | 
-| expandRestTagsOnClick | When maxTagCount exists and is multi-selected, select whether to expand redundant Tags when the panel is open       | boolean                          | false       | 2.28.0 | 
+| Properties | Instructions                                                                                                                                                                                                                                                                                                                                                       | Type | Default | version |
+| --- |--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| --- | --- | --- |
+| allowCreate | Whether to allow the user to create new entries. Needs to be used with `filter`. When allowCreate is enabled, it will no longer respond to updates to children or optionList                                                                                                                                                                                       | boolean | false |
+| arrowIcon | Customize the right drop-down arrow Icon, when the showClear switch is turned on and there is currently a selected value, hover will give priority to the clear icon                                                                                                                                                                                               | ReactNode |  | 1.15.0|
+| autoAdjustOverflow | Whether the pop-up layer automatically adjusts the direction when it is obscured (only vertical direction is supported for the time being, and the inserted parent is body)                                                                                                                                                                                        | boolean | true |
+| autoClearSearchValue | After selecting the option, whether to automatically clear the search keywords, it will take effect when mutilple and filter are both enabled                                                                                                                                                                                                                      | boolean | true | 2.3.0|
+| autoFocus | Whether automatically focus when component mount                                                                                                                                                                                                                                                                                                                   | boolean | false |
+| borderless        | borderless mode  >=2.33.0                                                                                                                                                                                                                                                                                                                                          | boolean                         |           |
+| className | The CSS class name of the wrapper element                                                                                                                                                                                                                                                                                                                          | string |  |
+| clearIcon    | Can be used to customize the clear button, valid when showClear is true                                                                                                                                                                                                                                                                                            | ReactNode                       |   | 2.25.0 |
+| clickToHide | When expanded, click on the selection box to automatically put away the drop-down list                                                                                                                                                                                                                                                                             | boolean | false |
+| defaultValue | Originally selected value when component mount                                                                                                                                                                                                                                                                                                                     | string\|number\|array |  |
+| defaultOpen | Whether show dropdown when component mounted                                                                                                                                                                                                                                                                                                                       | boolean | false |
+| defaultActiveFirstOption | Whether to highlight the first option by default (press Enter to select directly)                                                                                                                                                                                                                                                                                  | boolean | true |
+| disabled | Whether disabled component                                                                                                                                                                                                                                                                                                                                         | boolean | false |
+| dropdownClassName | ClassName of the pop-up layer                                                                                                                                                                                                                                                                                                                                      | string |  |
+| dropdownMatchSelectWidth | Is the minimum width of the drop-down menu equal to Select                                                                                                                                                                                                                                                                                                         | boolean | true |
+| dropdownMargin | Popup layer calculates the size of the safe area when the current direction overflows, used in scenes covered by fixed elements, more detail refer to [issue#549](https://github.com/DouyinFE/semi-design/issues/549), same as Tooltip margin                                                                                                                      | object\|number |  | 2.25.0 |
+| dropdownStyle | The inline style of the pop-up layer                                                                                                                                                                                                                                                                                                                               | object |  |
+| emptyContent | Content displayed when there is no result. When set to null, the drop-down list will not be displayed                                                                                                                                                                                                                                                              | string | ReactNode |  |
+| ellipsisTrigger | When maxTagCount exists and is multi-select, whether to perform adaptive processing on the overflow part of the tag(When the width is insufficient, the last tag content is truncated). After enabling this function, there will be a certain performance loss, and it is not recommended to use it in large form scenarios                                        | boolean   | false       | 2.28.0 | 
+| expandRestTagsOnClick | When maxTagCount exists and is multi-selected, select whether to expand redundant Tags when the panel is open                                                                                                                                                                                                                                                      | boolean                          | false       | 2.28.0 | 
 | filter | Whether searchable or not, the default is false. When `true` is passed, it means turn on search ability, default filtering policy is whether the label matches search input<br/>When the input type is function, the function arguments are searchInput, option. It should return true when the option meets the filtering conditions, otherwise it returns false. | false | boolean\|function |  |
-| getPopupContainer | Specifies the parent DOM, and the popup layer will be rendered to the DOM, you need to set 'position: relative`| function(): HTMLElement | () => document.body |
-| inputProps | When filter is true, the additional configuration parameters of the input, please refer to the Input component for specific configurable properties (note: please do not pass in `value`, `ref`, `onChange`, `onFocus`, otherwise it will override Select related callbacks and affect component behavior)  | object | | 2.2.0|
-| innerTopSlot | Render at the top of the pop-up layer, custom slot inside the optionList | ReactNode |  |
-| innerBottomSlot | Render at the bottom of the pop-up layer, custom slot inside the optionList | ReactNode |  |
-| insetLabel | Same to `prefix`, just an alias | ReactNode |  |
-| loading | Does the drop-down list show the loading animation | boolean | false |
-| max | Maximum number of choices, effective only in multi-selection mode | number |  |
-| maxTagCount | In multi-selection mode, when the option is beyond maxTag Count, the subsequent option is rendered in the form of + N | number |  |
-| maxHeight | Maximum height of `optionList` in the pop-up layer | string \| number | 270 |
-| multiple | Whether allow multiple selection | boolean | false |
-| outerBottomSlot | Rendered at the bottom of the popup layer, custom slot level with optionList | ReactNode |  |
-| outerTopSlot | Rendered at the top of the pop-up layer, custom slot level with optionList | ReactNode | |1.6.0 |
-| optionList | You can pass Option through this property, make sure that each element in the array has `label`, `value` properties | Array (\[{value, label}\]) |  |
-| placeholder | placeholder | ReactNode |  |
-| position | Pop-up layer position, refer to [Popover·API reference·position](/en-US/show/popover#API%20Reference) | string | 'bottomLeft' |
-| prefix | An input helper rendered before | ReactNode |  |
-| preventScroll | Indicates whether the browser should scroll the document to display the newly focused element, acting on the focus method inside the component, excluding the component passed in by the user | boolean |  |  |
-| remote | Whether to turn on remote search, when remote is true, the input content will not be locally filtered and matched | boolean | false |
-| renderCreateItem | When allowCreate is true, you can customize the rendering of the creation label | function(inputValue: string) | InputValue => 'Create' + InputValue |
-| renderSelectedItem | Customize the rendering of selected tabs in the selection box | function(option) |  |
-| restTagsPopoverProps | The configuration properties of the [Popover](/en-US/show/popover#API%20Reference) | PopoverProps | {} | 2.22.0 |
-| showArrow | Whether to show arrow icon | boolean | true |
-| showClear | Whether to show the clear button | boolean | false |
-| showRestTagsPopover | When the number of tags exceeds maxTagCount and hover reaches +N, whether to display the remaining content through Popover | boolean | false | 2.22.0 |
-| size | Size, optional value `default` / `small` / `large` | string | 'default' |
-| spacing | Spacing between popup layer and trigger | number | 4 |
-| stopPropagation | Whether to prevent click events on the popup layer from bubbling | boolean | true |  |
-| style | Inline Style | object |  |
-| suffix | An input helper rendered after | ReactNode |  |
-| triggerRender | Custom DOM of trigger | function |  |
-| virtualize | List virtualization, used to optimize performance in the case of a large number of nodes, composed of height, width, and itemSize  | object |  | 0.37.0 |
-| validateStatus | Verification result, optional `warning`, `error`, `default` (only affect the style background color) | string | 'default' |
-| value | The currently selected value is passed as a controlled component, used in conjunction with `onchange` | string\|number\|array |  |
-| zIndex | Popup layer z-index | number | 1030 |
-| onBlur | Callback when blur | function(event) |  |
-| onChange | Callback function when selected option | function (value) |  |
-| onChangeWithObject | Whether to use the other properties of the selected option as a callback. When set to true, the entry type of onchange changes from string to object: {value, label,...rest} | boolean | false |
-| onClear | Callback when click clear icon | function |  |
-| onCreate | Allow Create is true and provides after the callback when creating the standby option | function |  |
-| onDeselect | Callback when selected cancel | function (value, option) |  |
-| onDropdownVisibleChange | A callback when the drop-down menu expands / collapsed | function(visible: boolean) |  |
-| onExceed | Callback invoked when the number of attempts to select exceeds the max limit, effective only at multi-selection | function |  |
-| onFocus | Callback when focus select | function(event) |  |
-| onSearch | The callback function when the content of the input box changes. The second parameter is available after v2.31 | function(sugInput: string, e: ReactEvent) |  |
-| onSelect | Callback when selected | function (value, option) |  |
+| getPopupContainer | Specifies the parent DOM, and the popup layer will be rendered to the DOM, you need to set 'position: relative`    This will change the DOM tree position, but not the view's rendering position.                                                                                                                                                                                                                                                  | function(): HTMLElement | () => document.body |
+| inputProps | When filter is true, the additional configuration parameters of the input, please refer to the Input component for specific configurable properties (note: please do not pass in `value`, `ref`, `onChange`, `onFocus`, otherwise it will override Select related callbacks and affect component behavior)                                                         | object | | 2.2.0|
+| innerTopSlot | Render at the top of the pop-up layer, custom slot inside the optionList                                                                                                                                                                                                                                                                                           | ReactNode |  |
+| innerBottomSlot | Render at the bottom of the pop-up layer, custom slot inside the optionList                                                                                                                                                                                                                                                                                        | ReactNode |  |
+| insetLabel | Same to `prefix`, just an alias                                                                                                                                                                                                                                                                                                                                    | ReactNode |  |
+| loading | Does the drop-down list show the loading animation                                                                                                                                                                                                                                                                                                                 | boolean | false |
+| max | Maximum number of choices, effective only in multi-selection mode                                                                                                                                                                                                                                                                                                  | number |  |
+| maxTagCount | In multi-selection mode, when the option is beyond maxTag Count, the subsequent option is rendered in the form of + N                                                                                                                                                                                                                                              | number |  |
+| maxHeight | Maximum height of `optionList` in the pop-up layer                                                                                                                                                                                                                                                                                                                 | string \| number | 270 |
+| multiple | Whether allow multiple selection                                                                                                                                                                                                                                                                                                                                   | boolean | false |
+| outerBottomSlot | Rendered at the bottom of the popup layer, custom slot level with optionList                                                                                                                                                                                                                                                                                       | ReactNode |  |
+| outerTopSlot | Rendered at the top of the pop-up layer, custom slot level with optionList                                                                                                                                                                                                                                                                                         | ReactNode | |1.6.0 |
+| optionList | You can pass Option through this property, make sure that each element in the array has `label`, `value` properties                                                                                                                                                                                                                                                | Array (\[{value, label}\]) |  |
+| placeholder | placeholder                                                                                                                                                                                                                                                                                                                                                        | ReactNode |  |
+| position | Pop-up layer position, refer to [Popover·API reference·position](/en-US/show/popover#API%20Reference)                                                                                                                                                                                                                                                              | string | 'bottomLeft' |
+| prefix | An input helper rendered before                                                                                                                                                                                                                                                                                                                                    | ReactNode |  |
+| preventScroll | Indicates whether the browser should scroll the document to display the newly focused element, acting on the focus method inside the component, excluding the component passed in by the user                                                                                                                                                                      | boolean |  |  |
+| remote | Whether to turn on remote search, when remote is true, the input content will not be locally filtered and matched                                                                                                                                                                                                                                                  | boolean | false |
+| renderCreateItem | When allowCreate is true, you can customize the rendering of the creation label                                                                                                                                                                                                                                                                                    | function(inputValue: string) | InputValue => 'Create' + InputValue |
+| renderSelectedItem | Customize the rendering of selected tabs in the selection box                                                                                                                                                                                                                                                                                                      | function(option) |  |
+| restTagsPopoverProps | The configuration properties of the [Popover](/en-US/show/popover#API%20Reference)                                                                                                                                                                                                                                                                                 | PopoverProps | {} | 2.22.0 |
+| showArrow | Whether to show arrow icon                                                                                                                                                                                                                                                                                                                                         | boolean | true |
+| showClear | Whether to show the clear button                                                                                                                                                                                                                                                                                                                                   | boolean | false |
+| showRestTagsPopover | When the number of tags exceeds maxTagCount and hover reaches +N, whether to display the remaining content through Popover                                                                                                                                                                                                                                         | boolean | false | 2.22.0 |
+| size | Size, optional value `default` / `small` / `large`                                                                                                                                                                                                                                                                                                                 | string | 'default' |
+| spacing | Spacing between popup layer and trigger                                                                                                                                                                                                                                                                                                                            | number | 4 |
+| stopPropagation | Whether to prevent click events on the popup layer from bubbling                                                                                                                                                                                                                                                                                                   | boolean | true |  |
+| style | Inline Style                                                                                                                                                                                                                                                                                                                                                       | object |  |
+| suffix | An input helper rendered after                                                                                                                                                                                                                                                                                                                                     | ReactNode |  |
+| triggerRender | Custom DOM of trigger                                                                                                                                                                                                                                                                                                                                              | function |  |
+| virtualize | List virtualization, used to optimize performance in the case of a large number of nodes, composed of height, width, and itemSize                                                                                                                                                                                                                                  | object |  | 0.37.0 |
+| validateStatus | Verification result, optional `warning`, `error`, `default` (only affect the style background color)                                                                                                                                                                                                                                                               | string | 'default' |
+| value | The currently selected value is passed as a controlled component, used in conjunction with `onchange`                                                                                                                                                                                                                                                              | string\|number\|array |  |
+| zIndex | Popup layer z-index                                                                                                                                                                                                                                                                                                                                                | number | 1030 |
+| onBlur | Callback when blur                                                                                                                                                                                                                                                                                                                                                 | function(event) |  |
+| onChange | Callback function when selected option                                                                                                                                                                                                                                                                                                                             | function (value) |  |
+| onChangeWithObject | Whether to use the other properties of the selected option as a callback. When set to true, the entry type of onchange changes from string to object: {value, label,...rest}                                                                                                                                                                                       | boolean | false |
+| onClear | Callback when click clear icon                                                                                                                                                                                                                                                                                                                                     | function |  |
+| onCreate | Allow Create is true and provides after the callback when creating the standby option                                                                                                                                                                                                                                                                              | function |  |
+| onDeselect | Callback when selected cancel                                                                                                                                                                                                                                                                                                                                      | function (value, option) |  |
+| onDropdownVisibleChange | A callback when the drop-down menu expands / collapsed                                                                                                                                                                                                                                                                                                             | function(visible: boolean) |  |
+| onExceed | Callback invoked when the number of attempts to select exceeds the max limit, effective only at multi-selection                                                                                                                                                                                                                                                    | function |  |
+| onFocus | Callback when focus select                                                                                                                                                                                                                                                                                                                                         | function(event) |  |
+| onSearch | The callback function when the content of the input box changes. The second parameter is available after v2.31                                                                                                                                                                                                                                                     | function(sugInput: string, e: ReactEvent) |  |
+| onSelect | Callback when selected                                                                                                                                                                                                                                                                                                                                             | function (value, option) |  |
 
 ### Option Props
 

content/input/select/index.md

@@ -1378,76 +1378,76 @@ import { Select, Checkbox } from '@douyinfe/semi-ui';
 
 ### Select Props
 
-| 属性 | 说明 | 类型 | 默认值 | 版本 |
-| --- | --- | --- | --- | --- |
-| allowCreate | 是否允许用户创建新条目，需配合 filter 使用。该项为true时不再响应 optionList的变更 | boolean | false |
-| arrowIcon | 自定义右侧下拉箭头 Icon，当 showClear 开关打开且当前有选中值时，hover 会优先显示 clear icon | ReactNode |  | 1.15.0 |
-| autoAdjustOverflow | 浮层被遮挡时是否自动调整方向（暂时仅支持竖直方向，且插入的父级为 body） | boolean | true |
-| autoClearSearchValue | 选中选项后，是否自动清空搜索关键字，当 mutilple、filter 都开启时生效 | boolean | true | 2.3.0 |
-| autoFocus | 初始渲染时是否自动 focus | boolean | false |
-| borderless        | 无边框模式  >=2.33.0                                 | boolean                         |           |
-| className | 类名 | string |  |
-| clearIcon | 可用于自定义清除按钮, showClear为true时有效 | ReactNode | 2.25.0  |
-| clickToHide | 已展开时，点击选择框是否自动收起下拉列表 | boolean | false |
-| defaultValue | 初始选中的值 | string\|number\|array |  |
-| defaultOpen | 是否默认展开下拉列表 | boolean | false |
-| disabled | 是否禁用 | boolean | false |
-| defaultActiveFirstOption | 是否默认高亮第一个选项（按回车可直接选中） <br/>**v2.17.0 之后默认值从 false 变为 true** | boolean | true |
-| dropdownClassName | 弹出层的 className | string |  |
-| dropdownMatchSelectWidth | 下拉菜单最小宽度是否等于 Select | boolean | true |
-| dropdownStyle | 弹出层的样式 | object |  |
-| dropdownMargin | 弹出层计算溢出时的增加的冗余值，详见[issue#549](https://github.com/DouyinFE/semi-design/issues/549)，作用同 Tooltip margin | object\|number |  | 2.25.0 |
-| emptyContent | 无结果时展示的内容。设为 null 时，下拉列表将不展示 | string\|ReactNode |  |
-| ellipsisTrigger | 当 maxTagCount 存在且为多选时，是否对溢出部分的 tag 做自适应处理(当宽度不足时，最后一个tag内容作截断处理)。开启该功能后会有一定性能损耗，不推荐在大表单场景下使用       | boolean   | false       | 2.28.0 | 
-| expandRestTagsOnClick | 当maxTagCount存在且为多选时，select 在面板打开状态下是否展开多余的 Tag        | boolean   | false       | 2.28.0 | 
+| 属性 | 说明                                                                                                                                    | 类型 | 默认值 | 版本 |
+| --- |---------------------------------------------------------------------------------------------------------------------------------------| --- | --- | --- |
+| allowCreate | 是否允许用户创建新条目，需配合 filter 使用。该项为true时不再响应 optionList的变更                                                                                  | boolean | false |
+| arrowIcon | 自定义右侧下拉箭头 Icon，当 showClear 开关打开且当前有选中值时，hover 会优先显示 clear icon                                                                        | ReactNode |  | 1.15.0 |
+| autoAdjustOverflow | 浮层被遮挡时是否自动调整方向（暂时仅支持竖直方向，且插入的父级为 body）                                                                                                | boolean | true |
+| autoClearSearchValue | 选中选项后，是否自动清空搜索关键字，当 mutilple、filter 都开启时生效                                                                                            | boolean | true | 2.3.0 |
+| autoFocus | 初始渲染时是否自动 focus                                                                                                                       | boolean | false |
+| borderless        | 无边框模式  >=2.33.0                                                                                                                       | boolean                         |           |
+| className | 类名                                                                                                                                    | string |  |
+| clearIcon | 可用于自定义清除按钮, showClear为true时有效                                                                                                         | ReactNode | 2.25.0  |
+| clickToHide | 已展开时，点击选择框是否自动收起下拉列表                                                                                                                  | boolean | false |
+| defaultValue | 初始选中的值                                                                                                                                | string\|number\|array |  |
+| defaultOpen | 是否默认展开下拉列表                                                                                                                            | boolean | false |
+| disabled | 是否禁用                                                                                                                                  | boolean | false |
+| defaultActiveFirstOption | 是否默认高亮第一个选项（按回车可直接选中） <br/>**v2.17.0 之后默认值从 false 变为 true**                                                                           | boolean | true |
+| dropdownClassName | 弹出层的 className                                                                                                                        | string |  |
+| dropdownMatchSelectWidth | 下拉菜单最小宽度是否等于 Select                                                                                                                   | boolean | true |
+| dropdownStyle | 弹出层的样式                                                                                                                                | object |  |
+| dropdownMargin | 弹出层计算溢出时的增加的冗余值，详见[issue#549](https://github.com/DouyinFE/semi-design/issues/549)，作用同 Tooltip margin                                  | object\|number |  | 2.25.0 |
+| emptyContent | 无结果时展示的内容。设为 null 时，下拉列表将不展示                                                                                                          | string\|ReactNode |  |
+| ellipsisTrigger | 当 maxTagCount 存在且为多选时，是否对溢出部分的 tag 做自适应处理(当宽度不足时，最后一个tag内容作截断处理)。开启该功能后会有一定性能损耗，不推荐在大表单场景下使用                                          | boolean   | false       | 2.28.0 | 
+| expandRestTagsOnClick | 当maxTagCount存在且为多选时，select 在面板打开状态下是否展开多余的 Tag                                                                                        | boolean   | false       | 2.28.0 | 
 | filter | 是否可搜索，默认为 false。传入 true 时，代表开启搜索并采用默认过滤策略（label 是否与 sugInput 匹配），传入值为函数时，会接收 sugInput, option 两个参数，当 option 符合筛选条件应返回 true，否则返回 false | boolean \|function(sugInput, option) | false |
-| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 `position: relative` | function():HTMLElement | () => document.body |
-| inputProps | filter 为 true 时, input 输入框的额外配置参数，具体可配置属性请参考 Input 组件（注意：请不要传入 value、ref、onChange、onFocus，否则会覆盖 Select 相关回调，影响组件行为） | object |  | 2.2.0 |
-| innerTopSlot | 渲染在弹出层顶部，在 optionList 内部的自定义 slot | ReactNode |  |
-| innerBottomSlot | 渲染在弹出层底部，在 optionList 内部的自定义 slot | ReactNode |  |
-| insetLabel | 同上，与 prefix 区别是 fontWeight 更大 | ReactNode |  |
-| loading | 下拉列表是否展示加载动画 | boolean | false |
-| maxTagCount | 多选模式下，已选项超出 maxTagCount 时，后续选项会被渲染成+N 的形式 | number |  |
-| max | 最多可选几项，仅在多选模式下生效 | number |  |
-| maxHeight | 下拉菜单中 `optionList` 的最大高度 | string\|number | 270 |
-| multiple | 是否多选 | boolean | false |
-| outerTopSlot | 渲染在弹出层顶部，与 optionList 平级的自定义 slot | ReactNode |  |
-| outerBottomSlot | 渲染在弹出层底部，与 optionList 平级的自定义 slot | ReactNode |  |
-| optionList | 可以通过该属性传入 Option,请确保数组内每个元素都具备 label、value 属性 | array(\[{value, label}\]) |  |
-| placeholder | 选择框默认文字 | ReactNode |  |
-| position | 菜单展开的位置，可选项同 Tooltip position | string | 'bottomLeft' |
-| prefix | 选择框的前缀标签 | ReactNode |  |
-| preventScroll | 指示浏览器是否应滚动文档以显示新聚焦的元素，作用于组件内的 focus 方法 | boolean |  |  |
-| renderCreateItem | allowCreate 为 true 时，可自定义创建标签的渲染 | function(inputValue:string) | inputValue => '创建' + inputValue |
-| renderSelectedItem | 通过 renderSelectedItem 自定义选择框中已选项标签的渲染 | function(option) |  |
-| renderOptionItem | 通过 renderOptionItem 完全自定义下拉列表中候选项的渲染 | function(props) 入参详见 Demo |  |
-| restTagsPopoverProps | Popover 的配置属性，可以控制 position、zIndex、trigger 等，具体参考[Popover](/zh-CN/show/popover#API%20%E5%8F%82%E8%80%83) | PopoverProps | {} | 2.22.0 |
-| remote | 是否开启远程搜索，当 remote 为 true 时，input 内容改变后不会进行本地筛选匹配 | boolean | false |
-| size | 大小，可选值 `default`/`small`/`large` | string | 'default' |
-| style | 样式 | object |  |
-| stopPropagation | 是否阻止浮层上的点击事件冒泡 | boolean | true |  |
-| suffix | 选择框的后缀标签 | ReactNode |  |
-| showClear | 是否展示清除按钮 | boolean | false |
-| showArrow | 是否展示下拉箭头 | boolean | true |
-| showRestTagsPopover | 当超过 maxTagCount，hover 到 +N 时，是否通过 Popover 显示剩余内容 | boolean | false | 2.22.0 |
-| spacing | 浮层与选择器的距离 | number | 4 |
-| triggerRender | 自定义触发器渲染 | function |  |
-| value | 当前选中的的值,传入该值时将作为受控组件，配合 `onChange` 使用 | string\|number\|array |  |
-| validateStatus | 校验结果，可选`warning`、`error`、 `default`（只影响样式背景色） | string | 'default' |
-| virtualize | 列表虚拟化，用于大量节点的情况优化性能表现，由 height, width, itemSize 组成 | object |  |
-| zIndex | 弹层的 zIndex | number | 1030 |
-| onBlur | 失去焦点时的回调 | function(event) |  |
-| onChange | 变化时回调函数 | function(value:string\|number\|array) |  |
-| onCreate | allowCreate 为 true，创建备选项时的回调 | function(option) |  |
-| onClear | 清除按钮的回调 | function |  |
-| onChangeWithObject | 是否将选中项 option 的其他属性作为回调。设为 true 时，onChange 的入参类型会从 string 变为 object: { value, label, ...rest } | boolean | false |
-| onDropdownVisibleChange | 下拉菜单展开/收起时的回调 | function(visible:boolean) |  |
-| onListScroll | 候选项列表滚动时的回调 | function(e) |  |
-| onSearch | input 输入框内容发生改变时回调函数，第二个参数于 v2.31 后提供 | function(sugInput:string, e: ReactEvent) |  |
-| onSelect | 被选中时的回调 | function(value, option) |  |
-| onDeselect | 取消选中时的回调，仅在多选时有效 | function(value, option) |  |
-| onExceed | 当试图选择数超出 max 限制时的回调，仅在多选时生效 <br/> 入参在 v1.16.0 后提供 | function(option) |  |
-| onFocus | 获得焦点时的回调 | function(event) |  |
+| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 `position: relative` 这会改变浮层 DOM 树位置，但不会改变视图渲染位置。                                                      | function():HTMLElement | () => document.body |
+| inputProps | filter 为 true 时, input 输入框的额外配置参数，具体可配置属性请参考 Input 组件（注意：请不要传入 value、ref、onChange、onFocus，否则会覆盖 Select 相关回调，影响组件行为）                   | object |  | 2.2.0 |
+| innerTopSlot | 渲染在弹出层顶部，在 optionList 内部的自定义 slot                                                                                                     | ReactNode |  |
+| innerBottomSlot | 渲染在弹出层底部，在 optionList 内部的自定义 slot                                                                                                     | ReactNode |  |
+| insetLabel | 同上，与 prefix 区别是 fontWeight 更大                                                                                                         | ReactNode |  |
+| loading | 下拉列表是否展示加载动画                                                                                                                          | boolean | false |
+| maxTagCount | 多选模式下，已选项超出 maxTagCount 时，后续选项会被渲染成+N 的形式                                                                                             | number |  |
+| max | 最多可选几项，仅在多选模式下生效                                                                                                                      | number |  |
+| maxHeight | 下拉菜单中 `optionList` 的最大高度                                                                                                              | string\|number | 270 |
+| multiple | 是否多选                                                                                                                                  | boolean | false |
+| outerTopSlot | 渲染在弹出层顶部，与 optionList 平级的自定义 slot                                                                                                     | ReactNode |  |
+| outerBottomSlot | 渲染在弹出层底部，与 optionList 平级的自定义 slot                                                                                                     | ReactNode |  |
+| optionList | 可以通过该属性传入 Option,请确保数组内每个元素都具备 label、value 属性                                                                                         | array(\[{value, label}\]) |  |
+| placeholder | 选择框默认文字                                                                                                                               | ReactNode |  |
+| position | 菜单展开的位置，可选项同 Tooltip position                                                                                                         | string | 'bottomLeft' |
+| prefix | 选择框的前缀标签                                                                                                                              | ReactNode |  |
+| preventScroll | 指示浏览器是否应滚动文档以显示新聚焦的元素，作用于组件内的 focus 方法                                                                                                | boolean |  |  |
+| renderCreateItem | allowCreate 为 true 时，可自定义创建标签的渲染                                                                                                      | function(inputValue:string) | inputValue => '创建' + inputValue |
+| renderSelectedItem | 通过 renderSelectedItem 自定义选择框中已选项标签的渲染                                                                                                 | function(option) |  |
+| renderOptionItem | 通过 renderOptionItem 完全自定义下拉列表中候选项的渲染                                                                                                  | function(props) 入参详见 Demo |  |
+| restTagsPopoverProps | Popover 的配置属性，可以控制 position、zIndex、trigger 等，具体参考[Popover](/zh-CN/show/popover#API%20%E5%8F%82%E8%80%83)                              | PopoverProps | {} | 2.22.0 |
+| remote | 是否开启远程搜索，当 remote 为 true 时，input 内容改变后不会进行本地筛选匹配                                                                                      | boolean | false |
+| size | 大小，可选值 `default`/`small`/`large`                                                                                                      | string | 'default' |
+| style | 样式                                                                                                                                    | object |  |
+| stopPropagation | 是否阻止浮层上的点击事件冒泡                                                                                                                        | boolean | true |  |
+| suffix | 选择框的后缀标签                                                                                                                              | ReactNode |  |
+| showClear | 是否展示清除按钮                                                                                                                              | boolean | false |
+| showArrow | 是否展示下拉箭头                                                                                                                              | boolean | true |
+| showRestTagsPopover | 当超过 maxTagCount，hover 到 +N 时，是否通过 Popover 显示剩余内容                                                                                      | boolean | false | 2.22.0 |
+| spacing | 浮层与选择器的距离                                                                                                                             | number | 4 |
+| triggerRender | 自定义触发器渲染                                                                                                                              | function |  |
+| value | 当前选中的的值,传入该值时将作为受控组件，配合 `onChange` 使用                                                                                                 | string\|number\|array |  |
+| validateStatus | 校验结果，可选`warning`、`error`、 `default`（只影响样式背景色）                                                                                         | string | 'default' |
+| virtualize | 列表虚拟化，用于大量节点的情况优化性能表现，由 height, width, itemSize 组成                                                                                    | object |  |
+| zIndex | 弹层的 zIndex                                                                                                                            | number | 1030 |
+| onBlur | 失去焦点时的回调                                                                                                                              | function(event) |  |
+| onChange | 变化时回调函数                                                                                                                               | function(value:string\|number\|array) |  |
+| onCreate | allowCreate 为 true，创建备选项时的回调                                                                                                          | function(option) |  |
+| onClear | 清除按钮的回调                                                                                                                               | function |  |
+| onChangeWithObject | 是否将选中项 option 的其他属性作为回调。设为 true 时，onChange 的入参类型会从 string 变为 object: { value, label, ...rest }                                        | boolean | false |
+| onDropdownVisibleChange | 下拉菜单展开/收起时的回调                                                                                                                         | function(visible:boolean) |  |
+| onListScroll | 候选项列表滚动时的回调                                                                                                                           | function(e) |  |
+| onSearch | input 输入框内容发生改变时回调函数，第二个参数于 v2.31 后提供                                                                                                 | function(sugInput:string, e: ReactEvent) |  |
+| onSelect | 被选中时的回调                                                                                                                               | function(value, option) |  |
+| onDeselect | 取消选中时的回调，仅在多选时有效                                                                                                                      | function(value, option) |  |
+| onExceed | 当试图选择数超出 max 限制时的回调，仅在多选时生效 <br/> 入参在 v1.16.0 后提供                                                                                     | function(option) |  |
+| onFocus | 获得焦点时的回调                                                                                                                              | function(event) |  |
 
 ### Option Props
 

content/input/timepicker/index-en-US.md

@@ -297,53 +297,53 @@ function Demo(props = {}) {
 
 ## API Reference
 
-| Parameters | Instructions | Type | Default | Version |
-| --- | --- | --- | --- | --- |
-| autoAdjustOverflow | Whether the floating layer automatically adjusts its direction when it is blocked | boolean | true | **0.34.0** |
-| autoFocus | Automatic access to focus | boolean | false |
-| borderless        | borderless mode  >=2.33.0                                                                                                                                                                     | boolean                         |           |
-| className | Outer style name | string |  |
-| clearIcon | Can be used to customize the clear button, valid when showClear is true | ReactNode |  |  **2.25.0**|
-| clearText | Clear button prompt copy | string | Clear |
-| defaultOpen | Whether the panel is open by default | boolean |  | **0.19.0** |
-| defaultValue | Default time | Date\|timeStamp\|string (array when type = "timeRange") |  |
-| disabled | Disable all operations | boolean | false |
-| disabledHours | Prohibited selection of partial hour options | () => number [] |  |
-| disabledMinutes | Prohibited to select some minute options | (selectedHour: number) => number[] |  |
-| disabledSeconds | Unable to select partial second option | (selectedHour: number, selectedMinute: number) => number[] |  |
+| Parameters | Instructions                                                                                                                                                                                                                                  | Type | Default | Version |
+| --- |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| --- | --- | --- |
+| autoAdjustOverflow | Whether the floating layer automatically adjusts its direction when it is blocked                                                                                                                                                             | boolean | true | **0.34.0** |
+| autoFocus | Automatic access to focus                                                                                                                                                                                                                     | boolean | false |
+| borderless        | borderless mode  >=2.33.0                                                                                                                                                                                                                     | boolean                         |           |
+| className | Outer style name                                                                                                                                                                                                                              | string |  |
+| clearIcon | Can be used to customize the clear button, valid when showClear is true                                                                                                                                                                       | ReactNode |  |  **2.25.0**|
+| clearText | Clear button prompt copy                                                                                                                                                                                                                      | string | Clear |
+| defaultOpen | Whether the panel is open by default                                                                                                                                                                                                          | boolean |  | **0.19.0** |
+| defaultValue | Default time                                                                                                                                                                                                                                  | Date\|timeStamp\|string (array when type = "timeRange") |  |
+| disabled | Disable all operations                                                                                                                                                                                                                        | boolean | false |
+| disabledHours | Prohibited selection of partial hour options                                                                                                                                                                                                  | () => number [] |  |
+| disabledMinutes | Prohibited to select some minute options                                                                                                                                                                                                      | (selectedHour: number) => number[] |  |
+| disabledSeconds | Unable to select partial second option                                                                                                                                                                                                        | (selectedHour: number, selectedMinute: number) => number[] |  |
 | dropdownMargin | Popup layer calculates the size of the safe area when the current direction overflows, used in scenes covered by fixed elements, more detail refer to [issue#549](https://github.com/DouyinFE/semi-design/issues/549), same as Tooltip margin | object\|number |  | **2.25.0** |
-| focusOnOpen     | Whether to open the panel and focus the input box when mounting                         | boolean                                                                            | false                                                     |                    |
-| format | Time format of presentation | string | "HH: mm: ss." |  |
-| getPopupContainer | Specifies the container and the floating layer will be rendered into the element, you need to set 'position: relative` | () => HTMLElement | () => document.body |
-| hideDisabledOptions | Hide the option of forbidden selection | boolean | false |
-| hourStep | Hour option interval | number | 1 |
-| inputReadOnly | Set the input box to read-only (avoid opening a virtual keyboard on a mobile device) | boolean | false |
-| insetLabel | Prefix label, lower priority than `prefix` | string\|ReactNode |  |  |
-| minuteStep | Minute option interval | number | 1 |
-| motion | Whether to display the pop-up layer animation | boolean | true |  |
-| open | Controlled property of whether the panel is open | boolean |  |
-| panelFooter | Addon at the bottom of the panel | ReactNode\|ReactNode[]\|string |  |
-| panelHeader | Panel head addon | ReactNode\|ReactNode[]\|string |  |
-| placeholder | What's displayed when it's not worth it. | string | "Select time" |
-| popupClassName | Pop-up class name | string | '' |
-| popupStyle | Pop-up layer style object | object | - |
-| position | Floating position | string | type="timeRange" => "bottom"<br/>type="time" => "bottomLeft" |
-| prefix | Prefix content | string\|ReactNode |  |  |
-| preventScroll | Indicates whether the browser should scroll the document to display the newly focused element, acting on the focus method inside the component, excluding the component passed in by the user | boolean |  |  |
-| rangeSeparator | time range delimiter | string | "~" |
-| scrollItemProps | The props passed through to ScrollItem. The optional values are the same as [ScrollList#API](/zh-CN/show/scrolllist#ScrollItem) | object |  | **0.31.0** |
-| secondStep | Second option interval | number | 1 |
-| showClear | Whether to show the clear button | boolean | true | **0.35.0**|
-| size  | Size of input box, one of 'default', 'small' and 'large'          | string                                                                   | 'default'                                                              |                    |
-| triggerRender | Custom trigger rendering method | ({ placeholder: string }) => ReactNode |  | **0.34.0** |
-| type | type | "time"\|"timeRange" | "time" |
-| use12Hours | Using a 12-hour system, `format` default to `h: mm: ssa` when true | boolean | false |
-| value | Current time | Date\|timeStamp\|string (array when type = "timeRange") |  |
-| onBlur | Callback when focus is lost | (e: domEvent) => void | () => {} | **1.0.0** |
-| onChange | A callback in time. | (time: Date\|Date[], timeString: string\|string[]) => void |  |
-| onChangeWithDateFirst | Set the order of parameter in `onChange`, `true`: (Date, string); `false`: (string, Date) | boolean | true | **2.4.0** |
-| onFocus | Callback when focus is obtained | (e: domEvent) => void | () => {} | **1.0.0** |
-| onOpenChange | A callback when the panel is on / off | (isOpen: boolean) => void |  |
+| focusOnOpen     | Whether to open the panel and focus the input box when mounting                                                                                                                                                                               | boolean                                                                            | false                                                     |                    |
+| format | Time format of presentation                                                                                                                                                                                                                   | string | "HH: mm: ss." |  |
+| getPopupContainer | Specifies the container and the floating layer will be rendered into the element, you need to set 'position: relative`  This will change the DOM tree position, but not the view's rendering position.                                                                                                                        | () => HTMLElement | () => document.body |
+| hideDisabledOptions | Hide the option of forbidden selection                                                                                                                                                                                                        | boolean | false |
+| hourStep | Hour option interval                                                                                                                                                                                                                          | number | 1 |
+| inputReadOnly | Set the input box to read-only (avoid opening a virtual keyboard on a mobile device)                                                                                                                                                          | boolean | false |
+| insetLabel | Prefix label, lower priority than `prefix`                                                                                                                                                                                                    | string\|ReactNode |  |  |
+| minuteStep | Minute option interval                                                                                                                                                                                                                        | number | 1 |
+| motion | Whether to display the pop-up layer animation                                                                                                                                                                                                 | boolean | true |  |
+| open | Controlled property of whether the panel is open                                                                                                                                                                                              | boolean |  |
+| panelFooter | Addon at the bottom of the panel                                                                                                                                                                                                              | ReactNode\|ReactNode[]\|string |  |
+| panelHeader | Panel head addon                                                                                                                                                                                                                              | ReactNode\|ReactNode[]\|string |  |
+| placeholder | What's displayed when it's not worth it.                                                                                                                                                                                                      | string | "Select time" |
+| popupClassName | Pop-up class name                                                                                                                                                                                                                             | string | '' |
+| popupStyle | Pop-up layer style object                                                                                                                                                                                                                     | object | - |
+| position | Floating position                                                                                                                                                                                                                             | string | type="timeRange" => "bottom"<br/>type="time" => "bottomLeft" |
+| prefix | Prefix content                                                                                                                                                                                                                                | string\|ReactNode |  |  |
+| preventScroll | Indicates whether the browser should scroll the document to display the newly focused element, acting on the focus method inside the component, excluding the component passed in by the user                                                 | boolean |  |  |
+| rangeSeparator | time range delimiter                                                                                                                                                                                                                          | string | "~" |
+| scrollItemProps | The props passed through to ScrollItem. The optional values are the same as [ScrollList#API](/zh-CN/show/scrolllist#ScrollItem)                                                                                                               | object |  | **0.31.0** |
+| secondStep | Second option interval                                                                                                                                                                                                                        | number | 1 |
+| showClear | Whether to show the clear button                                                                                                                                                                                                              | boolean | true | **0.35.0**|
+| size  | Size of input box, one of 'default', 'small' and 'large'                                                                                                                                                                                      | string                                                                   | 'default'                                                              |                    |
+| triggerRender | Custom trigger rendering method                                                                                                                                                                                                               | ({ placeholder: string }) => ReactNode |  | **0.34.0** |
+| type | type                                                                                                                                                                                                                                          | "time"\|"timeRange" | "time" |
+| use12Hours | Using a 12-hour system, `format` default to `h: mm: ssa` when true                                                                                                                                                                            | boolean | false |
+| value | Current time                                                                                                                                                                                                                                  | Date\|timeStamp\|string (array when type = "timeRange") |  |
+| onBlur | Callback when focus is lost                                                                                                                                                                                                                   | (e: domEvent) => void | () => {} | **1.0.0** |
+| onChange | A callback in time.                                                                                                                                                                                                                           | (time: Date\|Date[], timeString: string\|string[]) => void |  |
+| onChangeWithDateFirst | Set the order of parameter in `onChange`, `true`: (Date, string); `false`: (string, Date)                                                                                                                                                     | boolean | true | **2.4.0** |
+| onFocus | Callback when focus is obtained                                                                                                                                                                                                               | (e: domEvent) => void | () => {} | **1.0.0** |
+| onOpenChange | A callback when the panel is on / off                                                                                                                                                                                                         | (isOpen: boolean) => void |  |
 
 ## Methods
 Some internal methods provided by TimePicker can be accessed through ref:

content/input/timepicker/index.md

@@ -305,7 +305,7 @@ function Demo(props = {}) {
 | dropdownMargin      | 浮层算溢出时的增加的冗余值，详见[issue#549](https://github.com/DouyinFE/semi-design/issues/549)，作用同 Tooltip margin      | object\|number  |  | **2.25.0**
 | focusOnOpen         | 挂载时是否打开面板并focus输入框                         | boolean                                                                            | false                                                     |                    |
 | format              | 展示的时间格式                                         | string                                                                            | "HH:mm:ss"                                                        |                    |
-| getPopupContainer   | 指定容器，浮层将会渲染至该元素内，自定义需要设置 `position: relative`                       | Function(): HTMLElement                                                           | () => document.body                                               |                    |
+| getPopupContainer   | 指定容器，浮层将会渲染至该元素内，自定义需要设置 `position: relative`  这会改变浮层 DOM 树位置，但不会改变视图渲染位置。                      | Function(): HTMLElement                                                           | () => document.body                                               |                    |
 | hideDisabledOptions | 隐藏禁止选择的选项                                     | boolean                                                                           | false                                                             |                    |
 | hourStep            | 小时选项间隔                                           | number                                                                            | 1                                                                 |                    |
 | inputReadOnly       | 设置输入框为只读（避免在移动设备上打开虚拟键盘）       | boolean                                                                           | false                                                             |                    |

content/input/treeselect/index-en-US.md

@@ -1424,7 +1424,7 @@ function Demo() {
 | expandAll | Set whether to expand all nodes by default. If the data (`treeData`) changes, the default expansion will still be affected by this api | boolean | false | 1.30.0 |
 | expandedKeys        | （Controlled）Keys of expanded nodes. Direct child nodes will be displayed.  | string[]                    | -       | 0.32.0 |
 | filterTreeNode           | Toggle whether searchable or pass in a function to customize search behavior, data parameter provided since v2.28.0 | boolean\|(inputValue: string, treeNodeString: TreeNodeString, data?: TreeNodeData) => boolean | false       | -       |
-| getPopupContainer        | Container to render pop-up, you need to set 'position: relative`                                                    | function():HTMLElement                                            | -           | -       |
+| getPopupContainer        | Container to render pop-up, you need to set 'position: relative`  This will change the DOM tree position, but not the view's rendering position.                                                    | function():HTMLElement                                            | -           | -       |
 | insetLabel               | Prefix alias，used mainly in Form                                                   | ReactNode                                                         | -           | 0.28.0  |
 | labelEllipsis | Toggle whether to ellipsis label when overflow | boolean | false\|true(virtualized) | 1.8.0 |  
 | leafOnly | Toggle whether to display tags for leaf nodes only and for onChange callback params in multiple mode | boolean | false |0.32.0 |

content/input/treeselect/index.md

@@ -1379,79 +1379,79 @@ function Demo() {
 
 ### TreeSelect
 
-| 属性            | 说明         | 类型           | 默认值          |  版本  |
-|-------------   | ----------- | -------------- | -------------- |-------- |
-| arrowIcon|自定义右侧下拉箭头Icon，当showClear开关打开且当前有选中值时，hover会优先显示clear icon| ReactNode | | 1.15.0|
-| autoAdjustOverflow|浮层被遮挡时是否自动调整方向（暂时仅支持竖直方向，且插入的父级为 body）|boolean | true| 0.34.0|
-| autoExpandParent | 是否自动展开父节点 | boolean | false | 0.34.0 |
-| borderless        | 无边框模式  >=2.33.0                                                                                                                                     | boolean                         |           |
-| checkRelation | 多选时，节点之间选中状态的关系，可选：'related'、'unRelated' | string | 'related' | 2.5.0 |
-| className | 选择框的 `className` 属性 | string | - | - |
-| clearIcon | 可用于自定义清除按钮, showClear为true时有效 | ReactNode | |2.25.0  |
-| clickToHide  | 选择后是否自动关闭下拉弹层，仅单选模式有效  | boolean    | true | 1.5.0      |
-| clickTriggerToHide  | 面板打开状态下，点击 Trigger 后是否关闭面板  | boolean    | true | 2.32.0      |
-| defaultExpandAll | 设置在初始化时是否展开所有节点。而如果后续数据(`treeData`)发生改变，这个 api 是无法影响节点的展开情况的，如果有这个需要可以使用 `expandAll` | boolean | false | 0.32.0 |
-| defaultExpandedKeys | 默认展开的节点，显示其直接子级 | string\[] | - | 0.32.0 |
-| defaultOpen | 默认展开下拉菜单 | boolean | false | 0.32.0 |
-| defaultValue | 指定默认选中的条目 | <ApiType detail='string \| number \| TreeNodeData \| (string \| number \| TreeNodeData)[]'>ValueType</ApiType> | - | - |
-| disabled | 是否禁用 | boolean | false | - |
-| disableStrictly | 是否严格禁用 | boolean | false | 1.30.0 |
-| dropdownClassName | 下拉菜单的 `className` 属性 | string | - | - |
-| dropdownMatchSelectWidth | 下拉菜单最小宽度是否等于Select |    boolean        | true | - |
-| dropdownMargin | 下拉菜单计算溢出时的增加的冗余值，详见[issue#549](https://github.com/DouyinFE/semi-design/issues/549)，作用同 Tooltip margin      | object\|number  |  | 2.25.0
-| dropdownStyle | 下拉菜单的样式 | CSSProperties | - | - |
-| emptyContent | 当搜索无结果时展示的内容 | ReactNode | `暂无数据` | - |
-| expandAction             | 展开逻辑，可选 false, 'click', 'doubleClick'。默认值为 false，即仅当点击展开按钮时才会展开  | boolean \| string   | false | 1.4.0      |
-| expandAll | 设置是否默认展开所有节点，若后续数据(`treeData`)发生改变，默认的展开情况也是会受到这个 api 影响的 | boolean | false | 1.30.0 |
-| expandedKeys | （受控）展开的节点，默认展开节点显示其直接子级 | string[] | - | 0.32.0 |
-| filterTreeNode | 是否根据输入项进行筛选，默认用 `treeNodeFilterProp` 的值作为要筛选的 `TreeNodeData` 的属性值, data 参数自 v2.28.0 开始提供 | boolean\| <ApiType detail='(inputValue: string, treeNodeString: string, data?: TreeNodeData) => boolean'>Function</ApiType> | false | - |
-| getPopupContainer  | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 `position: relative`     | function():HTMLElement | - | - |
-| insetLabel | 前缀标签别名，主要用于 Form | ReactNode | - |0.28.0 |
-| labelEllipsis | 是否开启label的超出省略，默认虚拟化状态下开启 | boolean | false\|true | 1.8.0 | 
-| leafOnly | 多选模式下是否开启 onChange 回调入参及展示标签只有叶子节点 | boolean | false |0.32.0 |
-| loadData | 异步加载数据，需要返回一个Promise | (treeNode: TreeNodeData) => Promise |- |  1.32.0|
-| loadedKeys | （受控）已经加载的节点，配合 loadData 使用 | Set< string > | - | 1.32.0|
-| maxTagCount | 最多显示多少个 tag | number | - | - |
-| motionExpand | 是否开启选项树节点动画 | boolean | true | - |
-| multiple | 是否支持多选 | boolean | false | - |
-| optionListStyle | optionList的样式 | CSSProperties | - | 1.8.0 |
-| outerBottomSlot          | 渲染在弹出层底部，与 optionList 平级的自定义 slot   | ReactNode  |  - | 1.1.0|
-| outerTopSlot| 渲染在弹出层顶部，与 optionList 平级的自定义 slot，注意如果开启了 filterTreeNode 会取代搜索框，可以通过 search 方法来自行处理 |  ReactNode  |  - | 1.9.0|
-| placeholder | 选择框默认文字 | string | - | - |
-| position | 下拉菜单位置，可选值参考 Tooltip position | string | bottomLeft | 2.25.0 |
-| prefix | 前缀标签 | ReactNode | - |0.28.0 |
-| preventScroll | 指示浏览器是否应滚动文档以显示新聚焦的元素，作用于组件内的 focus 方法 | boolean |  |  |
-| renderFullLabel | 完全自定义label的渲染函数，[入参及用法详见](/zh-CN/navigation/tree#高级定制) | (obj) => ReactNode | - | 1.7.0 | 
-| renderLabel | 自定义label的渲染函数，[入参及用法详见](/zh-CN/navigation/tree#自定义节点内容)  | <ApiType detail='(label:ReactNode, data:TreeNodeData) => ReactNode'>(label, data) => ReactNode</ApiType> | - | 1.6.0 | 
-| renderSelectedItem | 自定义渲染已选项 | Function | - | 1.26.0 | 
-| restTagsPopoverProps | Popover 的配置属性，可以控制 position、zIndex、trigger 等，具体参考[Popover](/zh-CN/show/popover#API%20%E5%8F%82%E8%80%83) | PopoverProps     | {} | 2.22.0 |
-| searchAutoFocus | 搜索框自动聚焦 | boolean | false | 1.27.0 |
-| searchPlaceholder | 搜索框默认文字 | string | - | - |
-| searchPosition | 设置搜索框的位置，可选: `dropdown`、`trigger` | string | `dropdown` | 1.29.0 |
-| showClear | 当值不为空时，trigger 是否展示清除按钮  | boolean | false |  |
-| showFilteredOnly | 搜索状态下是否只展示过滤后的结果 | boolean | false | 0.32.0 |
-| showRestTagsPopover | 当超过 maxTagCount，hover 到 +N 时，是否通过 Popover 显示剩余内容 | boolean | false | 2.22.0 |
-| showSearchClear | 是否显示搜索框的清除按钮 | boolean | true | 0.35.0 |
-| size | 选择框大小，可选 `large`，`small`，`default` | string | `default` | - |
-| style | 选择框的样式  | CSSProperties | - | - |
-| suffix | 后缀标签 | ReactNode | - |0.28.0|
-| treeData | `treeNodes` 数据，如果设置则不需要手动构造 `TreeNode` 节点（`key` 值在整个树范围内唯一） | TreeNodeData[] | \[] | - |
-| treeNodeFilterProp | 搜索时输入项过滤对应的 `TreeNodeData` 属性 | string | `label` | - |
-| treeNodeLabelProp | 作为显示的 `prop` 设置 | string | `label` | - |
-| triggerRender | 自定义触发器渲染方法  | (props: TriggerRenderProps) => ReactNode | - | 0.34.0 |
-| validateStatus | 校验结果，可选 `warning`、`error`、 `default`（只影响样式背景色） | string | - | 0.32.0 |
-| value | 当前选中的节点的value值，传入该值时将作为受控组件 | <ApiType detail='string \| number \| TreeNodeData \| (string \| number \| TreeNodeData)[]'>ValueType</ApiType>| - | - |
-| virtualize | 列表虚拟化，用于大量树节点的情况，由 height, width, itemSize 组成，参考 Tree - Virtualize Object。开启后将关闭动画效果。 | object | - | 0.32.0 |
-| zIndex | treeSelect下拉菜单的zIndex | number | 1030 | 0.30.0 |
-| onBlur | 失去焦点时的回调 | function(event) | - | - |
-| onChange | 选中树节点时调用此函数，默认返回值为当前所有选中项的value值及节点属性；如果是通过tag关闭，event参数为null | Function | - | - |
-| onChangeWithObject | 是否将选中项 option 的其他属性作为回调。设为 true 时，onChange 的入参类型Function(node\|node[], e) 此时如果是受控，也需要把 value 设置成 object，且必须含有 value 的键值；defaultValue同理。 | boolean | false | 1.0.0 |
-| onExpand | 展示节点时调用 | <ApiType detail='(expandedKeys:array, {expanded: bool, node}) => void'>(expandedKeys, object) => void</ApiType> | - | - |
-| onFocus | 聚焦时的回调 | function(event) | - | - |
-| onLoad | 节点加载完毕时触发的回调 | <ApiType detail='(loadedKeys: Set<string\>, treeNode: TreeNodeData) => void'>(loadedKeys, treeNode) => void</ApiType> |- |  1.32.0|
+| 属性            | 说明                                                                                                                                         | 类型           | 默认值          |  版本  |
+|-------------   |--------------------------------------------------------------------------------------------------------------------------------------------| -------------- | -------------- |-------- |
+| arrowIcon| 自定义右侧下拉箭头Icon，当showClear开关打开且当前有选中值时，hover会优先显示clear icon                                                                                  | ReactNode | | 1.15.0|
+| autoAdjustOverflow| 浮层被遮挡时是否自动调整方向（暂时仅支持竖直方向，且插入的父级为 body）                                                                                                     |boolean | true| 0.34.0|
+| autoExpandParent | 是否自动展开父节点                                                                                                                                  | boolean | false | 0.34.0 |
+| borderless        | 无边框模式  >=2.33.0                                                                                                                            | boolean                         |           |
+| checkRelation | 多选时，节点之间选中状态的关系，可选：'related'、'unRelated'                                                                                                   | string | 'related' | 2.5.0 |
+| className | 选择框的 `className` 属性                                                                                                                        | string | - | - |
+| clearIcon | 可用于自定义清除按钮, showClear为true时有效                                                                                                              | ReactNode | |2.25.0  |
+| clickToHide  | 选择后是否自动关闭下拉弹层，仅单选模式有效                                                                                                                      | boolean    | true | 1.5.0      |
+| clickTriggerToHide  | 面板打开状态下，点击 Trigger 后是否关闭面板                                                                                                                 | boolean    | true | 2.32.0      |
+| defaultExpandAll | 设置在初始化时是否展开所有节点。而如果后续数据(`treeData`)发生改变，这个 api 是无法影响节点的展开情况的，如果有这个需要可以使用 `expandAll`                                                       | boolean | false | 0.32.0 |
+| defaultExpandedKeys | 默认展开的节点，显示其直接子级                                                                                                                            | string\[] | - | 0.32.0 |
+| defaultOpen | 默认展开下拉菜单                                                                                                                                   | boolean | false | 0.32.0 |
+| defaultValue | 指定默认选中的条目                                                                                                                                  | <ApiType detail='string \| number \| TreeNodeData \| (string \| number \| TreeNodeData)[]'>ValueType</ApiType> | - | - |
+| disabled | 是否禁用                                                                                                                                       | boolean | false | - |
+| disableStrictly | 是否严格禁用                                                                                                                                     | boolean | false | 1.30.0 |
+| dropdownClassName | 下拉菜单的 `className` 属性                                                                                                                       | string | - | - |
+| dropdownMatchSelectWidth | 下拉菜单最小宽度是否等于Select                                                                                                                         |    boolean        | true | - |
+| dropdownMargin | 下拉菜单计算溢出时的增加的冗余值，详见[issue#549](https://github.com/DouyinFE/semi-design/issues/549)，作用同 Tooltip margin                                      | object\|number  |  | 2.25.0
+| dropdownStyle | 下拉菜单的样式                                                                                                                                    | CSSProperties | - | - |
+| emptyContent | 当搜索无结果时展示的内容                                                                                                                               | ReactNode | `暂无数据` | - |
+| expandAction             | 展开逻辑，可选 false, 'click', 'doubleClick'。默认值为 false，即仅当点击展开按钮时才会展开                                                                            | boolean \| string   | false | 1.4.0      |
+| expandAll | 设置是否默认展开所有节点，若后续数据(`treeData`)发生改变，默认的展开情况也是会受到这个 api 影响的                                                                                  | boolean | false | 1.30.0 |
+| expandedKeys | （受控）展开的节点，默认展开节点显示其直接子级                                                                                                                    | string[] | - | 0.32.0 |
+| filterTreeNode | 是否根据输入项进行筛选，默认用 `treeNodeFilterProp` 的值作为要筛选的 `TreeNodeData` 的属性值, data 参数自 v2.28.0 开始提供                                                   | boolean\| <ApiType detail='(inputValue: string, treeNodeString: string, data?: TreeNodeData) => boolean'>Function</ApiType> | false | - |
+| getPopupContainer  | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 `position: relative` 这会改变浮层 DOM 树位置，但不会改变视图渲染位置。                                                                                       | function():HTMLElement | - | - |
+| insetLabel | 前缀标签别名，主要用于 Form                                                                                                                           | ReactNode | - |0.28.0 |
+| labelEllipsis | 是否开启label的超出省略，默认虚拟化状态下开启                                                                                                                  | boolean | false\|true | 1.8.0 | 
+| leafOnly | 多选模式下是否开启 onChange 回调入参及展示标签只有叶子节点                                                                                                         | boolean | false |0.32.0 |
+| loadData | 异步加载数据，需要返回一个Promise                                                                                                                       | (treeNode: TreeNodeData) => Promise |- |  1.32.0|
+| loadedKeys | （受控）已经加载的节点，配合 loadData 使用                                                                                                                 | Set< string > | - | 1.32.0|
+| maxTagCount | 最多显示多少个 tag                                                                                                                                | number | - | - |
+| motionExpand | 是否开启选项树节点动画                                                                                                                                | boolean | true | - |
+| multiple | 是否支持多选                                                                                                                                     | boolean | false | - |
+| optionListStyle | optionList的样式                                                                                                                              | CSSProperties | - | 1.8.0 |
+| outerBottomSlot          | 渲染在弹出层底部，与 optionList 平级的自定义 slot                                                                                                          | ReactNode  |  - | 1.1.0|
+| outerTopSlot| 渲染在弹出层顶部，与 optionList 平级的自定义 slot，注意如果开启了 filterTreeNode 会取代搜索框，可以通过 search 方法来自行处理                                                        |  ReactNode  |  - | 1.9.0|
+| placeholder | 选择框默认文字                                                                                                                                    | string | - | - |
+| position | 下拉菜单位置，可选值参考 Tooltip position                                                                                                              | string | bottomLeft | 2.25.0 |
+| prefix | 前缀标签                                                                                                                                       | ReactNode | - |0.28.0 |
+| preventScroll | 指示浏览器是否应滚动文档以显示新聚焦的元素，作用于组件内的 focus 方法                                                                                                     | boolean |  |  |
+| renderFullLabel | 完全自定义label的渲染函数，[入参及用法详见](/zh-CN/navigation/tree#高级定制)                                                                                     | (obj) => ReactNode | - | 1.7.0 | 
+| renderLabel | 自定义label的渲染函数，[入参及用法详见](/zh-CN/navigation/tree#自定义节点内容)                                                                                    | <ApiType detail='(label:ReactNode, data:TreeNodeData) => ReactNode'>(label, data) => ReactNode</ApiType> | - | 1.6.0 | 
+| renderSelectedItem | 自定义渲染已选项                                                                                                                                   | Function | - | 1.26.0 | 
+| restTagsPopoverProps | Popover 的配置属性，可以控制 position、zIndex、trigger 等，具体参考[Popover](/zh-CN/show/popover#API%20%E5%8F%82%E8%80%83)                                   | PopoverProps     | {} | 2.22.0 |
+| searchAutoFocus | 搜索框自动聚焦                                                                                                                                    | boolean | false | 1.27.0 |
+| searchPlaceholder | 搜索框默认文字                                                                                                                                    | string | - | - |
+| searchPosition | 设置搜索框的位置，可选: `dropdown`、`trigger`                                                                                                          | string | `dropdown` | 1.29.0 |
+| showClear | 当值不为空时，trigger 是否展示清除按钮                                                                                                                    | boolean | false |  |
+| showFilteredOnly | 搜索状态下是否只展示过滤后的结果                                                                                                                           | boolean | false | 0.32.0 |
+| showRestTagsPopover | 当超过 maxTagCount，hover 到 +N 时，是否通过 Popover 显示剩余内容                                                                                           | boolean | false | 2.22.0 |
+| showSearchClear | 是否显示搜索框的清除按钮                                                                                                                               | boolean | true | 0.35.0 |
+| size | 选择框大小，可选 `large`，`small`，`default`                                                                                                         | string | `default` | - |
+| style | 选择框的样式                                                                                                                                     | CSSProperties | - | - |
+| suffix | 后缀标签                                                                                                                                       | ReactNode | - |0.28.0|
+| treeData | `treeNodes` 数据，如果设置则不需要手动构造 `TreeNode` 节点（`key` 值在整个树范围内唯一）                                                                                | TreeNodeData[] | \[] | - |
+| treeNodeFilterProp | 搜索时输入项过滤对应的 `TreeNodeData` 属性                                                                                                              | string | `label` | - |
+| treeNodeLabelProp | 作为显示的 `prop` 设置                                                                                                                            | string | `label` | - |
+| triggerRender | 自定义触发器渲染方法                                                                                                                                 | (props: TriggerRenderProps) => ReactNode | - | 0.34.0 |
+| validateStatus | 校验结果，可选 `warning`、`error`、 `default`（只影响样式背景色）                                                                                             | string | - | 0.32.0 |
+| value | 当前选中的节点的value值，传入该值时将作为受控组件                                                                                                                | <ApiType detail='string \| number \| TreeNodeData \| (string \| number \| TreeNodeData)[]'>ValueType</ApiType>| - | - |
+| virtualize | 列表虚拟化，用于大量树节点的情况，由 height, width, itemSize 组成，参考 Tree - Virtualize Object。开启后将关闭动画效果。                                                      | object | - | 0.32.0 |
+| zIndex | treeSelect下拉菜单的zIndex                                                                                                                      | number | 1030 | 0.30.0 |
+| onBlur | 失去焦点时的回调                                                                                                                                   | function(event) | - | - |
+| onChange | 选中树节点时调用此函数，默认返回值为当前所有选中项的value值及节点属性；如果是通过tag关闭，event参数为null                                                                              | Function | - | - |
+| onChangeWithObject | 是否将选中项 option 的其他属性作为回调。设为 true 时，onChange 的入参类型Function(node\|node[], e) 此时如果是受控，也需要把 value 设置成 object，且必须含有 value 的键值；defaultValue同理。    | boolean | false | 1.0.0 |
+| onExpand | 展示节点时调用                                                                                                                                    | <ApiType detail='(expandedKeys:array, {expanded: bool, node}) => void'>(expandedKeys, object) => void</ApiType> | - | - |
+| onFocus | 聚焦时的回调                                                                                                                                     | function(event) | - | - |
+| onLoad | 节点加载完毕时触发的回调                                                                                                                               | <ApiType detail='(loadedKeys: Set<string\>, treeNode: TreeNodeData) => void'>(loadedKeys, treeNode) => void</ApiType> |- |  1.32.0|
 | onSearch | 文本框值变化时回调。 入参 filteredExpandedKeys 表示因为搜索或 value / defaultValue 而展开的节点的 key, <br/>可以配合 expandedKeys 受控时使用。filteredExpandedKeys 在 2.6.0 中新增 |  <ApiType detail='function(sugInput: string, filteredExpandedKeys: string[])'>(sugInput, filteredExpandedKeys)=>void</ApiType>  |  |  |
-| onSelect | 被选中时调用，返回值为当前事件选项的key值 | <ApiType detail='(selectedKey:string, selected: bool, selectedNode: TreeNodeData) => void'>(selectedKey, selected, selectedNode)=>void</ApiType> | - | - |
-| onVisibleChange     | 弹出层展示/隐藏时触发的回调   | function(isVisible:boolean) |     |   1.4.0  |
+| onSelect | 被选中时调用，返回值为当前事件选项的key值                                                                                                                     | <ApiType detail='(selectedKey:string, selected: bool, selectedNode: TreeNodeData) => void'>(selectedKey, selected, selectedNode)=>void</ApiType> | - | - |
+| onVisibleChange     | 弹出层展示/隐藏时触发的回调                                                                                                                             | function(isVisible:boolean) |     |   1.4.0  |
 
 ### TreeNodeData
 

content/navigation/navigation/index.md

@@ -744,9 +744,9 @@ function NavApp (props = {}) {
 | defaultIsCollapsed  | 默认是否处于收起状态，仅 `mode = "vertical"` 时有效                                                    | boolean                                                                                                                                                             | false                   |
 | defaultOpenKeys     | 初始打开的子导航 `itemKey` 数组，仅 `mode = "vertical"` 且侧边栏处于展开状态时有效                               | string[]                                                                                                                                                            | []                      |
 | defaultSelectedKeys | 初始选中的导航项 `itemKey` 数组                                                                   | string[]                                                                                                                                                            | []                      |
-| expandIcon          | 默认下拉箭头Icon, v>=2.36                                                                 | ReactNode                                                                                                                                                     |                       |
+| expandIcon          | 默认下拉箭头Icon, v>=2.36                                                                     | ReactNode                                                                                                                                                     |                       |
 | footer              | 底部区域配置对象或元素，详见 [Nav.Footer](#Nav.Footer)                                                | object\                                                                                                                                                             | ReactNode               |                      |
-| getPopupContainer   | 垂直 Nav 折叠或 水平 Nav中 Dropdown 的 getPopupContainer 配置，可指定弹出层容器, v>=2.24.0                        | Function |                      |
+| getPopupContainer   | 垂直 Nav 折叠或 水平 Nav中 Dropdown 的 getPopupContainer 配置，可指定弹出层容器 这会改变浮层 DOM 树位置，但不会改变视图渲染位置。 , v>=2.24.0                 | Function |                      |
 | header              | 头部区域配置对象或元素，详见 [Nav.Header](#Nav.Header)                                                | object\                                                                                                                                                             | ReactNode               |                      |
 | isCollapsed         | 是否处于收起状态的受控属性，仅 `mode = "vertical"` 时有效                                                 | boolean                                                                                                                                                             |                         |
 | items               | 导航项目列表，每一项可以继续带有 items 属性。如果为 string 数组，则会取每一项作为 text 和 itemKey                         | object\| string[]\| [Item](#Nav.Item)[] \| [Sub](#Nav.Sub)[] |  |
@@ -760,13 +760,13 @@ function NavApp (props = {}) {
 | subNavCloseDelay    | 子导航浮层关闭的延迟。collapse 为 true 或 mode 为 "horizontal" 时有效，单位为 ms                             | number                                                                                                                                                              | 100                     |
 | subNavMotion        | 子导航折叠动画                                                                                 | boolean                                                                                                                                                             | true                    |
 | subNavOpenDelay     | 子导航浮层显示的延迟。collapse 为 true 或 mode 为 "horizontal" 时有效，单位为 ms                             | number                                                                                                                                                              | 0                       |
-| toggleIconPosition  | 带有子导航项的的父级导航项箭头位置 v>=1.27.0                                                              | 'left' \                                                                                                                                                            | 'right'                 | 'right'              |
+| toggleIconPosition  | 带有子导航项的的父级导航项箭头位置 v>=1.27.0                                                             | 'left' \                                                                                                                                                            | 'right'                 | 'right'              |
 | tooltipHideDelay    | tooltip 隐藏的延迟，collapse 为 true 时有效，单位为 ms                                                | number                                                                                                                                                              | 100                     |
 | tooltipShowDelay    | tooltip 显示的延迟，collapse 为 true 时有效，单位为 ms                                                | number                                                                                                                                                              | 0                       |
 | onClick             | 点击任意导航项时触发                                                                              | <ApiType detail='({ itemKey: string, domEvent: MouseEvent, isOpen: boolean }) => void'>(itemKey, event, isOpen) => void</ApiType>                                   | () => {}                |
 | onCollapseChange    | 收起状态变化时的回调                                                                              | <ApiType detail='(isCollapsed: boolean) => void'>(isCollapsed)=> void </ApiType>                                                                                       | () => {}                |
-| onOpenChange        | 切换某个子导航项目显隐状态时触发                                                                    | <ApiType detail='({ itemKey: string, openKeys: string[], domEvent: MouseEvent, isOpen: boolean }) => void'> ({itemKey, openKeys, event, isOpen})=>{}</ApiType>      | () => {}                |
-| onSelect            | 第一次选中某个可选中导航项目时触发                                                                   | <ApiType detail='({ itemKey: string, selectedKeys: string[], selectedItems: Item[], domEvent: MouseEvent, isOpen: boolean }) => void'>(onSelectProps)=>{}</ApiType> | () => {}                |
+| onOpenChange        | 切换某个子导航项目显隐状态时触发                                                                        | <ApiType detail='({ itemKey: string, openKeys: string[], domEvent: MouseEvent, isOpen: boolean }) => void'> ({itemKey, openKeys, event, isOpen})=>{}</ApiType>      | () => {}                |
+| onSelect            | 第一次选中某个可选中导航项目时触发                                                                       | <ApiType detail='({ itemKey: string, selectedKeys: string[], selectedItems: Item[], domEvent: MouseEvent, isOpen: boolean }) => void'>(onSelectProps)=>{}</ApiType> | () => {}                |
 
 ### Nav.Item
 

content/navigation/tree/index-en-US.md

@@ -991,6 +991,68 @@ import { Tree, Button } from '@douyinfe/semi-ui';
 
 ```
 
+### Controlled Expansion with Search
+When `expandedKeys` is passed in, it is the expanded controlled component, which can be used with `onExpand`. When the expansion is controlled, if you enable `filterTreeNode` and search, the node will not be automatically expanded. At this time, the expansion of the node is completely controlled by `expandedKeys`. You can use the input parameter `filteredExpandedKeys` (version: >= 2.38.0) of `onSearch` to realize the search expansion effect when the expansion is controlled.
+
+```jsx live=true hideInDSM
+import React, { useState } from 'react';
+import { Tree } from '@douyinfe/semi-ui';
+
+() => {
+    const [expandedKeys, setExpandedKeys] = useState([]);
+    const treeData = [
+        {
+            label: 'Asia',
+            value: 'Asia',
+            key: '0',
+            children: [
+                {
+                    label: 'China',
+                    value: 'China',
+                    key: '0-0',
+                    children: [
+                        {
+                            label: 'Beijing',
+                            value: 'Beijing',
+                            key: '0-0-0',
+                        },
+                        {
+                            label: 'Shanghai',
+                            value: 'Shanghai',
+                            key: '0-0-1',
+                        },
+                    ],
+                },
+                {
+                    label: 'Japan',
+                    value: 'Japan',
+                    key: '0-1',
+                },
+            ],
+        },
+        {
+            label: 'North America',
+            value: 'North America',
+            key: '1',
+        }
+    ];
+    return (
+        <Tree
+            style={{ width: 300 }}
+            treeData={treeData}
+            filterTreeNode
+            expandedKeys={expandedKeys}
+            onExpand={expandedKeys => {
+                setExpandedKeys(expandedKeys);
+            }}
+            onSearch={(inputValue, filteredExpandedKeys) => {
+                setExpandedKeys([...filteredExpandedKeys]);
+            }}
+        />
+    );
+};
+```
+
 ### Controlled Component
 
 You can use `value` along with `onChange` property if you want to use Tree as a controlled component.
@@ -2165,7 +2227,7 @@ import { IconFixedStroked, IconSectionStroked, IconAbsoluteStroked, IconInnerSec
 | onExpand            | Callback function when expand or collapse a node | (expandedKeys: string[], {expanded: boolean, node: TreeNodeData}) => void               | -       | - |
 | onLoad | Callback function when a node is loaded | (loadedKeys: Set< string >, treeNode: TreeNodeData) => void | - | 1.0.0|
 | onContextMenu | Callback function when right click on an item | (e: MouseEvent, node: TreeNodeData) => void | - | 0.35.0 |
-| onSearch            | Callback function when the values for search input changes                | (sunInput: string) => void  | -       | - |
+| onSearch                 | Callback function when search value changes. `filteredExpandedKeys` represents the key of the node expanded due to search or value/defaultValue, which can be used when expandedKeys is controlled<br/> **filteredExpandedKeys is supported in 2.38.0**      | function(input: string, filteredExpandedKeys: string[])  
 | onSelect            | Callback function when selected, return the key property of data          | (selectedKey:string, selected: bool, selectedNode: TreeNodeData) => void | -       | - |
 
 ### TreeNodeData

content/navigation/tree/index.md

@@ -1039,6 +1039,68 @@ import { Tree, Button } from '@douyinfe/semi-ui';
 
 ```
 
+### 开启搜索的展开受控
+传入 `expandedKeys` 时即为展开受控组件，可以配合 `onExpand` 使用。当展开受控时，如果开启 `filterTreeNode` 并进行搜索是不会再自动展开节点的，此时，节点的展开完全由 `expandedKeys` 来控制。你可以利用 `onSearch` 的入参 `filteredExpandedKeys`（version: >= 2.38.0） 来实现展开受控时的搜索展开效果。
+
+```jsx live=true hideInDSM
+import React, { useState } from 'react';
+import { Tree } from '@douyinfe/semi-ui';
+
+() => {
+    const [expandedKeys, setExpandedKeys] = useState([]);
+    const treeData = [
+        {
+            label: '亚洲',
+            value: 'Asia',
+            key: '0',
+            children: [
+                {
+                    label: '中国',
+                    value: 'China',
+                    key: '0-0',
+                    children: [
+                        {
+                            label: '北京',
+                            value: 'Beijing',
+                            key: '0-0-0',
+                        },
+                        {
+                            label: '上海',
+                            value: 'Shanghai',
+                            key: '0-0-1',
+                        },
+                    ],
+                },
+                {
+                    label: '日本',
+                    value: 'Japan',
+                    key: '0-1',
+                },
+            ],
+        },
+        {
+            label: '北美洲',
+            value: 'North America',
+            key: '1',
+        }
+    ];
+    return (
+        <Tree
+            style={{ width: 300 }}
+            treeData={treeData}
+            filterTreeNode
+            expandedKeys={expandedKeys}
+            onExpand={expandedKeys => {
+                setExpandedKeys(expandedKeys);
+            }}
+            onSearch={(inputValue, filteredExpandedKeys) => {
+                setExpandedKeys([...filteredExpandedKeys]);
+            }}
+        />
+    );
+};
+```
+
 ### 受控
 
 传入 `value` 时即为受控组件，可以配合 `onChange` 使用。
@@ -2157,7 +2219,7 @@ import { IconFixedStroked, IconSectionStroked, IconAbsoluteStroked, IconInnerSec
 | onExpand | 展示节点时调用 | (expandedKeys: string[], {expanded: boolean, node: TreeNodeData}) => void | - | - |
 | onLoad | 节点加载完毕时触发的回调 | (loadedKeys: Set<string/>, treeNode: TreeNodeData) => void |- |  1.0.0|
 | onContextMenu | 右键点击的回调 | (e: MouseEvent, node: TreeNodeData) => void | - | 0.35.0 |
-| onSearch | 文本框值变化时回调 | (sunInput: string) => void | - | - |
+| onSearch | 文本框值变化时回调, 入参 filteredExpandedKeys 表示因为搜索或 value / defaultValue 而展开的节点的 key, <br/>可以配合 expandedKeys 受控时使用。filteredExpandedKeys 在 2.38.0 中新增 | (sunInput: string, filteredExpandedKeys: string[]) => void | - | - |
 | onSelect | 被选中时调用，返回值为当前事件选项的key值 | (selectedKey:string, selected: bool, selectedNode: TreeNodeData) => void | - | - |
 
 ### TreeNodeData

content/other/configprovider/index-en-US.md

@@ -379,12 +379,12 @@ function Demo(props = {}) {
 
 ## API Reference
 
-| Properties | Instructions                   | type          | Default |
-|------------|--------------------------------|---------------|---------|
-| direction  | Sets the direction of the text | `ltr`\| `rtl` | `ltr`   |
-| getPopupContainer | Specifies the parent DOM, and the bullet layer will be rendered to the DOM, you need to set 'position: relative` | function():HTMLElement | () => document.body    |
-| locale     | Multi-language configuration, same as the [usage](/en-US/other/locale) of `locale` parameter in `LocaleProvider` | object         |         |
-| timeZone   | [Time zone identifier](#Time_Zone_Identifier)                                                                         | string\|number |         |
+| Properties | Instructions                                                                                                      | type          | Default |
+|------------|-------------------------------------------------------------------------------------------------------------------|---------------|---------|
+| direction  | Sets the direction of the text                                                                                    | `ltr`\| `rtl` | `ltr`   |
+| getPopupContainer | Specifies the parent DOM, and the bullet layer will be rendered to the DOM, you need to set 'position: relative`  This will change the DOM tree position, but not the view's rendering position.  | function():HTMLElement | () => document.body    |
+| locale     | Multi-language configuration, same as the [usage](/en-US/other/locale) of `locale` parameter in `LocaleProvider`  | object         |         |
+| timeZone   | [Time zone identifier](#Time_Zone_Identifier)                                                                     | string\|number |         |
 
 
 ### Time Zone Identifier

content/other/configprovider/index.md

@@ -381,12 +381,12 @@ function Demo(props = {}) {
 
 ## API 参考
 
-| 属性              | 说明                                                                          | 类型                   | 默认值              |
-|-------------------|-----------------------------------------------------------------------------|------------------------|---------------------|
-| direction         | 设置文本的方向                                                                | `ltr`\| `rtl`          | `ltr`               |
-| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 `position: relative`      | function():HTMLElement | () => document.body |
+| 属性              | 说明                                                              | 类型                   | 默认值              |
+|-------------------|-----------------------------------------------------------------|------------------------|---------------------|
+| direction         | 设置文本的方向                                                         | `ltr`\| `rtl`          | `ltr`               |
+| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 `position: relative` 这会改变浮层 DOM 树位置，但不会改变视图渲染位置。            | function():HTMLElement | () => document.body |
 | locale            | 多语言配置，同`LocaleProvider`中`locale`参数的[用法](/zh-CN/other/locale#使用) | object                 |                     |
-| timeZone          | [时区标识](#时区标识)                                                         | string\|number         |                     |
+| timeZone          | [时区标识](#时区标识)                                                   | string\|number         |                     |
 
 
 ### 时区标识

content/show/badge/index-en-US.md

@@ -265,7 +265,7 @@ import { Badge } from '@douyinfe/semi-ui';
         <br/>
         <span><Badge dot type='tertiary' /> info</span>
         <br/>
-        <span><Badge dot style={{ backgroundColor: 'var(--semi-color-success)' }} /> success</span>
+        <span><Badge dot type='success' /> success</span>
         <br/>
         <span><Badge dot type='warning' /> warning</span>
         <br/>
@@ -285,7 +285,7 @@ import { Badge } from '@douyinfe/semi-ui';
 | position      | Badge position, optional `left Top`, `left Bottom`, `right Top`, `right Bottom` | string     | `rightTop` |
 | style         | style                                                                           | CSSProperties     | -          |
 | theme         | Badge theme, one of `solid`, `light`, `inverted`                                | string     | `solid`    |
-| type          | Badge type, one of `primary`, `secondary`, `sense`, `danger`, `warning`         | string     | `primary`  |
+| type          | Badge type, one of `primary`, `secondary`, `tertiary`, `danger`, `warning`,`success`,         | string     | `primary`  |
 
 ## Content Guidelines
 

content/show/badge/index.md

@@ -263,7 +263,7 @@ import { Badge } from '@douyinfe/semi-ui';
         <br/>
         <span><Badge dot type='tertiary' /> 信息 info</span>
         <br/>
-        <span><Badge dot style={{ backgroundColor: 'var(--semi-color-success)' }} /> 成功 success</span>
+        <span><Badge dot type='success' /> 成功 success</span>
         <br/>
         <span><Badge dot type='warning' /> 提醒 warning</span>
         <br/>
@@ -283,7 +283,7 @@ import { Badge } from '@douyinfe/semi-ui';
 | position | 徽章位置，可选 `leftTop`、 `leftBottom`、 `rightTop`、 `rightBottom` | string | `rightTop`  |
 | style | 徽章的样式 | CSSProperties | 无 | 
 | theme | 徽章主题，可选 `solid`、 `light`、 `inverted` | string | `solid` |
-| type | 徽章类型，可选 `primary`、 `secondary`、 `tertiary`、 `danger`、 `warning` | string | `primary`  |
+| type | 徽章类型，可选 `primary`、 `secondary`、 `tertiary`、 `danger`、 `warning`、 `success` | string | `primary`  |
 
 
 ## 文案规范

content/show/dropdown/index-en-US.md

@@ -426,32 +426,32 @@ function DropdownEvents() {
 
 ### Dropdown
 
-| Properties | Instructions | Type | Default | Version |
-| --- | --- | --- | --- | --- |
-| autoAdjustOverflow | Whether the pop-up layer automatically adjusts its direction when it is blocked | boolean | true |  |
-| className | classname of the outer style of the pop-up layer | string |  |  |
-| closeOnEsc | Whether to close the panel by pressing the Esc key in the trigger or popup layer. It does not take effect when visible is under controlled | boolean | true | **2.13.0** |
-| children | Child elements wrapped by the drop layer | ReactNode |  |  |
-| clickToHide | Whether to close the drop-down layer automatically when clicking on the drop-down layer | boolean |  | **0.24.0** |
-| contentClassName | Drop-down menu root element class name | string |  |  |
-| getPopupContainer | Specifies the parent DOM, and the bullet layer will be rendered to the DOM, you need to set 'position: relative` | function():HTMLElement | () => document.body |
+| Properties | Instructions                                                                                                                                                                                                                                  | Type | Default | Version |
+| --- |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| --- | --- | --- |
+| autoAdjustOverflow | Whether the pop-up layer automatically adjusts its direction when it is blocked                                                                                                                                                               | boolean | true |  |
+| className | classname of the outer style of the pop-up layer                                                                                                                                                                                              | string |  |  |
+| closeOnEsc | Whether to close the panel by pressing the Esc key in the trigger or popup layer. It does not take effect when visible is under controlled                                                                                                    | boolean | true | **2.13.0** |
+| children | Child elements wrapped by the drop layer                                                                                                                                                                                                      | ReactNode |  |  |
+| clickToHide | Whether to close the drop-down layer automatically when clicking on the drop-down layer                                                                                                                                                       | boolean |  | **0.24.0** |
+| contentClassName | Drop-down menu root element class name                                                                                                                                                                                                        | string |  |  |
+| getPopupContainer | Specifies the parent DOM, and the bullet layer will be rendered to the DOM, you need to set 'position: relative`  This will change the DOM tree position, but not the view's rendering position.                                                                                                                              | function():HTMLElement | () => document.body |
 | margin | Popup layer calculates the size of the safe area when the current direction overflows, used in scenes covered by fixed elements, more detail refer to [issue#549](https://github.com/DouyinFE/semi-design/issues/549), same as Tooltip margin | object\|number |  | 2.25.0 |
-| mouseEnterDelay | After the mouse is moved into the Trigger, the display time is delayed, in milliseconds (only effective when the trigger is hover/focus) | number | 50 |  |
-| mouseLeaveDelay | The time for the delay to disappear after the mouse moves out of the pop-up layer, in milliseconds (only effective when the trigger is hover/focus) | number | 50 |  |
-| menu | Menu content config | Array<DropdownMenuItem\> | [] | **1.12.0** |
-| position | The position of the pop-up menu, commonly used: 'bottom', 'bottomLeft', 'bottomRight', for more details, see [Tooltip Position](https://semi.design/en-US/show/tooltip#Position) | string | 'bottom' |  |
-| render | Content of pop-up layer，include `Dropdown.Menu` `Dropdown.Item`、`Dropdown.Title` | ReactNode |  |  |
-| rePosKey | You can update the value of this item to manually trigger the repositioning of the pop-up layer | string \| number |  |  |
-| spacing | The distance between the pop-up layer and the `children` element, in px | number | 4 |  |
-| style | Pop-up layer inline style | object |  |  |
-| showTick | Whether to automatically display the checked tick on the left of the active Dropdown.Item item | boolean | false | **0.26.0** |
-| stopPropagation | Whether to prevent the click event on the pop-up layer from bubbling | boolean | false | **0.34.0** |
-| trigger | The act of triggering a drop-down, optional 'hover', 'focus', 'click', 'custom' | string | 'hover' |  |
-| visible | Display the menu or not, need to be used with trigger custom | boolean |  |  |
-| zIndex | Pop-up layer z-index value | number | 1050 |  |
-| onClickOutSide  | Callback when the pop-up layer is in the display state and the non-Children, non-floating layer inner area is clicked (only valid when trigger is custom, click)  | (e:event) => void | | **2.1.0** |
-| onEscKeyDown | Called when Esc key is pressed in trigger or popup layer | function(e:event) | | **2.13.0** |
-| onVisibleChange | Callback when the pop-up layer display state changes | function |  |  |
+| mouseEnterDelay | After the mouse is moved into the Trigger, the display time is delayed, in milliseconds (only effective when the trigger is hover/focus)                                                                                                      | number | 50 |  |
+| mouseLeaveDelay | The time for the delay to disappear after the mouse moves out of the pop-up layer, in milliseconds (only effective when the trigger is hover/focus)                                                                                           | number | 50 |  |
+| menu | Menu content config                                                                                                                                                                                                                           | Array<DropdownMenuItem\> | [] | **1.12.0** |
+| position | The position of the pop-up menu, commonly used: 'bottom', 'bottomLeft', 'bottomRight', for more details, see [Tooltip Position](https://semi.design/en-US/show/tooltip#Position)                                                              | string | 'bottom' |  |
+| render | Content of pop-up layer，include `Dropdown.Menu` `Dropdown.Item`、`Dropdown.Title`                                                                                                                                                              | ReactNode |  |  |
+| rePosKey | You can update the value of this item to manually trigger the repositioning of the pop-up layer                                                                                                                                               | string \| number |  |  |
+| spacing | The distance between the pop-up layer and the `children` element, in px                                                                                                                                                                       | number | 4 |  |
+| style | Pop-up layer inline style                                                                                                                                                                                                                     | object |  |  |
+| showTick | Whether to automatically display the checked tick on the left of the active Dropdown.Item item                                                                                                                                                | boolean | false | **0.26.0** |
+| stopPropagation | Whether to prevent the click event on the pop-up layer from bubbling                                                                                                                                                                          | boolean | false | **0.34.0** |
+| trigger | The act of triggering a drop-down, optional 'hover', 'focus', 'click', 'custom'                                                                                                                                                               | string | 'hover' |  |
+| visible | Display the menu or not, need to be used with trigger custom                                                                                                                                                                                  | boolean |  |  |
+| zIndex | Pop-up layer z-index value                                                                                                                                                                                                                    | number | 1050 |  |
+| onClickOutSide  | Callback when the pop-up layer is in the display state and the non-Children, non-floating layer inner area is clicked (only valid when trigger is custom, click)                                                                              | (e:event) => void | | **2.1.0** |
+| onEscKeyDown | Called when Esc key is pressed in trigger or popup layer                                                                                                                                                                                      | function(e:event) | | **2.13.0** |
+| onVisibleChange | Callback when the pop-up layer display state changes                                                                                                                                                                                          | function |  |  |
 
 ### Dropdown.Menu
 

content/show/dropdown/index.md

@@ -423,32 +423,32 @@ function DropdownEvents() {
 
 ### Dropdown
 
-| 属性 | 说明 | 类型 | 默认值 | 版本 |
-| --- | --- | --- | --- | --- |
-| autoAdjustOverflow | 弹出层被遮挡时是否自动调整方向 | boolean | true |  |
-| closeOnEsc | 在 trigger 或 弹出层按 Esc 键是否关闭面板，受控时不生效 | boolean | true ｜ **2.13.0** |
-| className | 下拉弹层外层样式类名 | string |  |  |
-| children | 触发弹出层的 Trigger 元素 | ReactNode |  |  |
-| clickToHide | 在弹出层内点击时是否自动关闭弹出层 | boolean |  | **0.24.0** |
-| contentClassName | 下拉菜单根元素类名 | string |  |  |
-| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 `position: relative` | function():HTMLElement | () => document.body |  |
-| margin| 弹出层计算溢出时的增加的冗余值，详见[issue#549](https://github.com/DouyinFE/semi-design/issues/549)，作用同 Tooltip margin  | number\|object  |  |  **2.25.0**   |
-| mouseEnterDelay | 鼠标移入 Trigger 后，延迟显示的时间，单位毫秒（仅当 trigger 为 hover/focus 时生效） | number | 50 |  |
-| mouseLeaveDelay | 鼠标移出弹出层后，延迟消失的时间，单位毫秒（仅当 trigger 为 hover/focus 时生效） | number | 50 |  |
-| menu | 通过传入 JSON Array 来快速配置 Dropdown 内容 | Array<DropdownMenuItem\> | [] | **1.12.0** |
+| 属性 | 说明                                                                                                                           | 类型 | 默认值 | 版本 |
+| --- |------------------------------------------------------------------------------------------------------------------------------| --- | --- | --- |
+| autoAdjustOverflow | 弹出层被遮挡时是否自动调整方向                                                                                                              | boolean | true |  |
+| closeOnEsc | 在 trigger 或 弹出层按 Esc 键是否关闭面板，受控时不生效                                                                                          | boolean | true ｜ **2.13.0** |
+| className | 下拉弹层外层样式类名                                                                                                                   | string |  |  |
+| children | 触发弹出层的 Trigger 元素                                                                                                            | ReactNode |  |  |
+| clickToHide | 在弹出层内点击时是否自动关闭弹出层                                                                                                            | boolean |  | **0.24.0** |
+| contentClassName | 下拉菜单根元素类名                                                                                                                    | string |  |  |
+| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 `position: relative` 这会改变浮层 DOM 树位置，但不会改变视图渲染位置。                                                                         | function():HTMLElement | () => document.body |  |
+| margin| 弹出层计算溢出时的增加的冗余值，详见[issue#549](https://github.com/DouyinFE/semi-design/issues/549)，作用同 Tooltip margin                         | number\|object  |  |  **2.25.0**   |
+| mouseEnterDelay | 鼠标移入 Trigger 后，延迟显示的时间，单位毫秒（仅当 trigger 为 hover/focus 时生效）                                                                    | number | 50 |  |
+| mouseLeaveDelay | 鼠标移出弹出层后，延迟消失的时间，单位毫秒（仅当 trigger 为 hover/focus 时生效）                                                                          | number | 50 |  |
+| menu | 通过传入 JSON Array 来快速配置 Dropdown 内容                                                                                            | Array<DropdownMenuItem\> | [] | **1.12.0** |
 | position | 弹出菜单的位置，常用："bottom", "bottomLeft", "bottomRight"，更多详见[Tooltip 位置](https://semi.design/zh-CN/show/tooltip#%E4%BD%8D%E7%BD%AE) | string | "bottom" |  |
-| render | 弹出层的内容，由 `Dropdown.Menu` 及 `Dropdown.Item`、`Dropdown.Title` 构成 | ReactNode |  |  |
-| rePosKey | 可以更新该项值手动触发弹出层的重新定位 | string \| number |  |  |
-| spacing | 弹出层与 Trigger 元素（即 Dropdown children）的距离，单位 px | number | 4 |  |
-| style | 弹出层内联样式 | object |  |  |
-| showTick | 是否自动在 active 的 Dropdown.Item 项左侧展示表示选中的勾 | boolean | false | **0.26.0** |
-| stopPropagation | 是否阻止弹出层上的点击事件冒泡 | boolean | false | **0.34.0** |
-| trigger | 触发下拉的行为，可选 "hover", "focus", "click", "custom" | string | "hover" |  |
-| visible | 是否显示菜单，需配合 trigger custom 使用 | boolean | 无 |  |
-| zIndex | 弹出层 z-index 值 | number | 1050 |  |
-| onClickOutSide | 当弹出层处于展示状态，点击非Children、非弹出层内部区域时的回调（仅trigger为custom、click时有效）| function(e:event) |  | **2.1.0** |
-| onEscKeyDown |  在 trigger 或 弹出层按 Esc 键时调用 |  function(e:event) |  |  **2.13.0** | 
-| onVisibleChange | 弹出层显示状态改变时的回调 | function(visible: boolean) |  |  |
+| render | 弹出层的内容，由 `Dropdown.Menu` 及 `Dropdown.Item`、`Dropdown.Title` 构成                                                               | ReactNode |  |  |
+| rePosKey | 可以更新该项值手动触发弹出层的重新定位                                                                                                          | string \| number |  |  |
+| spacing | 弹出层与 Trigger 元素（即 Dropdown children）的距离，单位 px                                                                                | number | 4 |  |
+| style | 弹出层内联样式                                                                                                                      | object |  |  |
+| showTick | 是否自动在 active 的 Dropdown.Item 项左侧展示表示选中的勾                                                                                     | boolean | false | **0.26.0** |
+| stopPropagation | 是否阻止弹出层上的点击事件冒泡                                                                                                              | boolean | false | **0.34.0** |
+| trigger | 触发下拉的行为，可选 "hover", "focus", "click", "custom"                                                                               | string | "hover" |  |
+| visible | 是否显示菜单，需配合 trigger custom 使用                                                                                                 | boolean | 无 |  |
+| zIndex | 弹出层 z-index 值                                                                                                                | number | 1050 |  |
+| onClickOutSide | 当弹出层处于展示状态，点击非Children、非弹出层内部区域时的回调（仅trigger为custom、click时有效）                                                                | function(e:event) |  | **2.1.0** |
+| onEscKeyDown | 在 trigger 或 弹出层按 Esc 键时调用                                                                                                    |  function(e:event) |  |  **2.13.0** | 
+| onVisibleChange | 弹出层显示状态改变时的回调                                                                                                                | function(visible: boolean) |  |  |
 
 ### Dropdown.Menu
 

content/show/image/index-en-US.md

@@ -212,7 +212,7 @@ import { ImagePreview, Button } from '@douyinfe/semi-ui';
 
 ### Render in the specified container
 
-You can specify the parent DOM of the preview component through `getPopupContainer` (you need to specify `position: relative`), and the image preview will be rendered into this DOM
+You can specify the parent DOM of the preview component through `getPopupContainer` (you need to specify `position: relative`), and the image preview will be rendered into this DOM.  This will change the DOM tree position, but not the view's rendering position.
 
 ```jsx live=true dir="column"
 import React, { useMemo } from 'react';
@@ -438,49 +438,49 @@ import { Image, ImagePreview } from '@douyinfe/semi-ui';
 
 ### ImagePreview
 
-| Properties       | Instructions            | Type            | Default | Version |
-|------------------|-------------------------|-----------------|---------|---------|
-| adaptiveTip      | Adapt to page action button prompts |string  | "Adapt to the page" | |
-| className        | Custom style class name | string          | - | |
-| closable         | Whether to show the close button   | Boolean | true | |
-| closeOnEsc       | Hit esc to close the preview | boolean        | true | |
-| currentIndex     | Controlled property, the current preview image subscript | number | - | |
-| defaultCurrentIndex | First display image subscript | number | - | |
-| defaultVisible   | Whether to open the preview for the first time | boolean | - | |
-| disableDownload  | Disable downloads        | boolean        | false | |
-| downloadTip      | Download action button prompt | string  | "Download" | |
-| getPopupContainer | Specify the parent DOM, and the pop-up layer will be rendered into the DOM. For customization, you need to set container `position: relative`|() => HTMLElement;  | () => document.body | |
-| infinite         | Whether to loop infinitely  | boolean        | false | |
-| lazyLoad         | Whether to enable lazy loading | boolean      | true | |
+| Properties       | Instructions                                                                                                                                                             | Type            | Default | Version |
+|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------|---------|---------|
+| adaptiveTip      | Adapt to page action button prompts                                                                                                                                      |string  | "Adapt to the page" | |
+| className        | Custom style class name                                                                                                                                                  | string          | - | |
+| closable         | Whether to show the close button                                                                                                                                         | Boolean | true | |
+| closeOnEsc       | Hit esc to close the preview                                                                                                                                             | boolean        | true | |
+| currentIndex     | Controlled property, the current preview image subscript                                                                                                                 | number | - | |
+| defaultCurrentIndex | First display image subscript                                                                                                                                            | number | - | |
+| defaultVisible   | Whether to open the preview for the first time                                                                                                                           | boolean | - | |
+| disableDownload  | Disable downloads                                                                                                                                                        | boolean        | false | |
+| downloadTip      | Download action button prompt                                                                                                                                            | string  | "Download" | |
+| getPopupContainer | Specify the parent DOM, and the pop-up layer will be rendered into the DOM. For customization, you need to set container `position: relative`  This will change the DOM tree position, but not the view's rendering position.                            |() => HTMLElement;  | () => document.body | |
+| infinite         | Whether to loop infinitely                                                                                                                                               | boolean        | false | |
+| lazyLoad         | Whether to enable lazy loading                                                                                                                                           | boolean      | true | |
 | lazyLoadMargin   | Pass to the rootMargin parameter in options, refer to [Intersection Observer API](https://developer.mozilla.org/zh-CN/docs/Web/API/Intersection_Observer_API#interfaces) | string | "0px 100px 100px 0px" | |
-| maskClosable     | Whether the mask can be closed by clicking | Boolean  | true | |
-| nextTip          | Next action button prompt   | string  | "Next" | |
-| originTip        | Original size action button tips |string  | "Original size" | |
-| onChange         | Event triggered by switching pictures  | (index: number) => void | - | |
-| onClose          | The callback function when the close button is clicked  | () => void | - | |
-| onDownload       | Image download callback function  | (src: string, index: number) => void | - | |
-| onRotateLeft     | Callback for rotating the image     | (angle: number) => void | - | |
-| onNext           | Callback for switching pictures backwards   | (index: number) => void | - | |
-| onPrev           | Callback for switching the picture forward  | (index: number) => void | - | |
-| onZoomIn         | The callback function when the image is zoomed in  | (zoom: number) => void | - | |
-| onZoomOut        | The callback function when the image is zoomed out  | (zoom: number) => void | - | |
-| onVisibleChange  | Callback triggered by toggle visible state   | (visible: boolean) => void  | - | |
-| preLoad          | Whether to enable preloading | boolean | true | |
-| preLoadGap       | Preloaded step size      | number         | 2 | |
-| previewTitle     | Custom preview title     | ReactNode      | - | |
-| prevTip          | Previous operation button prompt   | string  | "Previous" | |
-| renderHeader     | Custom render preview top info  |(info: reactNode) => ReactNode  | - | |
-| renderPreviewMenu | Custom render preview bottom menu information | (props: MenuProps) => ReactNode; | - | |
-| rotateTip        | Tips for rotating action buttons  |string        | "Rotate" | |
-| showTooltip      | Whether to display the bottom operation area prompt | boolean | false | |
-| src              | Image list information  | string \| string[] | - | |
-| style            | Custom style            | CSSProperties   | - | |
-| viewerVisibleDelay | The length of time of inactivity before hiding the preview action button | number | 10000 | |
-| visible          | Controlled property, whether to preview  | boolean | - | |
-| zIndex           | Preview layer hierarchy  | number        | 1070 | |
-| zoomInTip        | Zoom in action button tips | string | "Zoom in" | |
-| zoomOutTip       | Zoom out action button prompt | string | "Zoom out" | |
-| zoomStep         | Image reduction/enlargement ratio each time | number | 0.1 | |
+| maskClosable     | Whether the mask can be closed by clicking                                                                                                                               | Boolean  | true | |
+| nextTip          | Next action button prompt                                                                                                                                                | string  | "Next" | |
+| originTip        | Original size action button tips                                                                                                                                         |string  | "Original size" | |
+| onChange         | Event triggered by switching pictures                                                                                                                                    | (index: number) => void | - | |
+| onClose          | The callback function when the close button is clicked                                                                                                                   | () => void | - | |
+| onDownload       | Image download callback function                                                                                                                                         | (src: string, index: number) => void | - | |
+| onRotateLeft     | Callback for rotating the image                                                                                                                                          | (angle: number) => void | - | |
+| onNext           | Callback for switching pictures backwards                                                                                                                                | (index: number) => void | - | |
+| onPrev           | Callback for switching the picture forward                                                                                                                               | (index: number) => void | - | |
+| onZoomIn         | The callback function when the image is zoomed in                                                                                                                        | (zoom: number) => void | - | |
+| onZoomOut        | The callback function when the image is zoomed out                                                                                                                       | (zoom: number) => void | - | |
+| onVisibleChange  | Callback triggered by toggle visible state                                                                                                                               | (visible: boolean) => void  | - | |
+| preLoad          | Whether to enable preloading                                                                                                                                             | boolean | true | |
+| preLoadGap       | Preloaded step size                                                                                                                                                      | number         | 2 | |
+| previewTitle     | Custom preview title                                                                                                                                                     | ReactNode      | - | |
+| prevTip          | Previous operation button prompt                                                                                                                                         | string  | "Previous" | |
+| renderHeader     | Custom render preview top info                                                                                                                                           |(info: reactNode) => ReactNode  | - | |
+| renderPreviewMenu | Custom render preview bottom menu information                                                                                                                            | (props: MenuProps) => ReactNode; | - | |
+| rotateTip        | Tips for rotating action buttons                                                                                                                                         |string        | "Rotate" | |
+| showTooltip      | Whether to display the bottom operation area prompt                                                                                                                      | boolean | false | |
+| src              | Image list information                                                                                                                                                   | string \| string[] | - | |
+| style            | Custom style                                                                                                                                                             | CSSProperties   | - | |
+| viewerVisibleDelay | The length of time of inactivity before hiding the preview action button                                                                                                 | number | 10000 | |
+| visible          | Controlled property, whether to preview                                                                                                                                  | boolean | - | |
+| zIndex           | Preview layer hierarchy                                                                                                                                                  | number        | 1070 | |
+| zoomInTip        | Zoom in action button tips                                                                                                                                               | string | "Zoom in" | |
+| zoomOutTip       | Zoom out action button prompt                                                                                                                                            | string | "Zoom out" | |
+| zoomStep         | Image reduction/enlargement ratio each time                                                                                                                              | number | 0.1 | |
 
 ### MenuProps
 

content/show/image/index.md

@@ -212,7 +212,7 @@ import { ImagePreview, Button } from '@douyinfe/semi-ui';
 
 ### 渲染在指定容器
 
-可以通过 `getPopupContainer` 指定预览组件的父级 DOM（需要指定 `position: relative`)，图片预览将会渲染至该 DOM 中
+可以通过 `getPopupContainer` 指定预览组件的父级 DOM（需要指定 `position: relative`)，图片预览将会渲染至该 DOM 中。这会改变浮层 DOM 树位置，但不会改变视图渲染位置。
 
 ```jsx live=true dir="column"
 import React, { useMemo } from 'react';
@@ -438,50 +438,50 @@ import { Image, ImagePreview } from '@douyinfe/semi-ui';
 
 ### ImagePreview
 
-| 属性               | 说明                    | 类型              | 默认值 | 版本 |
-|-------------------|-------------------------|------------------|-------|-----|
-| adaptiveTip       | 适应页面操作按钮提示       | string        | "适应页面" | |
-| className         | 自定义样式类名            | string           | - | |
-| closable          | 是否显示关闭按钮           | boolean        | true | |
-| closeOnEsc        | 点击 esc 关闭预览         | boolean        | true | |
-| crossOrigin       | 透传给预览图片的原生 img 标签的 crossorigin  | 'anonymous'｜'use-credentials'| - | |
-| currentIndex      | 受控属性，当前预览图片下标  | number               | - | |
-| defaultCurrentIndex | 首次展示图片下标        | number             | - | |
-| defaultVisible    | 首次是否开启预览           | boolean         | - | |
-| disableDownload   | 禁用下载                  | boolean        | false | |
-| downloadTip       | 下载操作按钮提示          | string         | "下载" | |
-| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 container `position: relative` | () => HTMLElement  | () => document.body | |
-| infinite          | 是否无限循环              | boolean       | false | |
-| lazyLoad          | 是否开启懒加载             | boolean      | true | |
+| 属性               | 说明                                                                                                                                               | 类型              | 默认值 | 版本 |
+|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|------------------|-------|-----|
+| adaptiveTip       | 适应页面操作按钮提示                                                                                                                                       | string        | "适应页面" | |
+| className         | 自定义样式类名                                                                                                                                          | string           | - | |
+| closable          | 是否显示关闭按钮                                                                                                                                         | boolean        | true | |
+| closeOnEsc        | 点击 esc 关闭预览                                                                                                                                      | boolean        | true | |
+| crossOrigin       | 透传给预览图片的原生 img 标签的 crossorigin                                                                                                                   | 'anonymous'｜'use-credentials'| - | |
+| currentIndex      | 受控属性，当前预览图片下标                                                                                                                                    | number               | - | |
+| defaultCurrentIndex | 首次展示图片下标                                                                                                                                         | number             | - | |
+| defaultVisible    | 首次是否开启预览                                                                                                                                         | boolean         | - | |
+| disableDownload   | 禁用下载                                                                                                                                             | boolean        | false | |
+| downloadTip       | 下载操作按钮提示                                                                                                                                         | string         | "下载" | |
+| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 container `position: relative` 这会改变浮层 DOM 树位置，但不会改变视图渲染位置。                                                       | () => HTMLElement  | () => document.body | |
+| infinite          | 是否无限循环                                                                                                                                           | boolean       | false | |
+| lazyLoad          | 是否开启懒加载                                                                                                                                          | boolean      | true | |
 | lazyLoadMargin    | 传给 options 中的rootMargin 参数，参考 [Intersection Observer API](https://developer.mozilla.org/zh-CN/docs/Web/API/Intersection_Observer_API#interfaces) | string | "0px 100px 100px 0px" | |
-| maskClosable      | 点击遮罩是否可关闭         | boolean        | true | |
-| nextTip           | 下一步操作按钮提示         | string         | "下一步" | |
-| originTip         | 原始尺寸操作按钮提示       | string        | "原始尺寸" | |
-| onChange          | 切换图片触发的事件  | (index: number) => void | - | |
-| onClose           | 点击关闭按钮时的回调函数  | () => void | - | |
-| onDownload        | 图片下载回调函数     | (src: string, index: number) => void | - | |
-| onRotateLeft      | 旋转图片的回调      | (angle: number) => void | - | |
-| onNext            | 向后切换图片的回调   | (index: number) => void | - | |
-| onPrev            | 向前切换图片的回调   | (index: number) => void | - | |
-| onZoomIn          | 图片放大时的回调函数  | (zoom: number) => void | - | |
-| onZoomOut         | 图片缩小时的回调函数  | (zoom: number) => void | - | |
-| onVisibleChange   | 切换可见状态触发的回调   | (visible: boolean) => void | - | |
-| preLoad           | 是否开启预加载             | boolean        | true | |
-| preLoadGap        | 预加载的步长               | number         | 2 | |
-| previewTitle      | 自定义预览 title          | ReactNode      | - | |
-| prevTip           | 上一步操作按钮提示         | string         | "上一步" | |
-| renderHeader      | 自定义渲染预览顶部信息     | (info: ReactNode) => ReactNode  | - | |
-| renderPreviewMenu | 自定义渲染预览底部菜单信息  | (props: MenuProps) => ReactNode;| - | |
-| rotateTip         | 旋转操作按钮提示                    | string         | "旋转" | |
-| showTooltip       | 是否展示底部操作区提示      | boolean        | false | |
-| src               | 图片列表信息              | string \| string[] | - | |
-| style             | 自定义样式               | CSSProperties    | - | |
-| viewerVisibleDelay | 隐藏预览操作按钮前的无操作时长 | number         | 10000 | |
-| visible           | 受控属性，是否预览         | boolean         | - | |
-| zIndex            | 预览层层级                | number        | 1070 | |
-| zoomInTip         | 放大操作按钮提示           | string         | "放大" | |
-| zoomOutTip        | 缩小操作按钮提示           | string        | "缩小" | |
-| zoomStep          | 图片每次缩小/放大比例       | number        | 0.1 | |
+| maskClosable      | 点击遮罩是否可关闭                                                                                                                                        | boolean        | true | |
+| nextTip           | 下一步操作按钮提示                                                                                                                                        | string         | "下一步" | |
+| originTip         | 原始尺寸操作按钮提示                                                                                                                                       | string        | "原始尺寸" | |
+| onChange          | 切换图片触发的事件                                                                                                                                        | (index: number) => void | - | |
+| onClose           | 点击关闭按钮时的回调函数                                                                                                                                     | () => void | - | |
+| onDownload        | 图片下载回调函数                                                                                                                                         | (src: string, index: number) => void | - | |
+| onRotateLeft      | 旋转图片的回调                                                                                                                                          | (angle: number) => void | - | |
+| onNext            | 向后切换图片的回调                                                                                                                                        | (index: number) => void | - | |
+| onPrev            | 向前切换图片的回调                                                                                                                                        | (index: number) => void | - | |
+| onZoomIn          | 图片放大时的回调函数                                                                                                                                       | (zoom: number) => void | - | |
+| onZoomOut         | 图片缩小时的回调函数                                                                                                                                       | (zoom: number) => void | - | |
+| onVisibleChange   | 切换可见状态触发的回调                                                                                                                                      | (visible: boolean) => void | - | |
+| preLoad           | 是否开启预加载                                                                                                                                          | boolean        | true | |
+| preLoadGap        | 预加载的步长                                                                                                                                           | number         | 2 | |
+| previewTitle      | 自定义预览 title                                                                                                                                      | ReactNode      | - | |
+| prevTip           | 上一步操作按钮提示                                                                                                                                        | string         | "上一步" | |
+| renderHeader      | 自定义渲染预览顶部信息                                                                                                                                      | (info: ReactNode) => ReactNode  | - | |
+| renderPreviewMenu | 自定义渲染预览底部菜单信息                                                                                                                                    | (props: MenuProps) => ReactNode;| - | |
+| rotateTip         | 旋转操作按钮提示                                                                                                                                         | string         | "旋转" | |
+| showTooltip       | 是否展示底部操作区提示                                                                                                                                      | boolean        | false | |
+| src               | 图片列表信息                                                                                                                                           | string \| string[] | - | |
+| style             | 自定义样式                                                                                                                                            | CSSProperties    | - | |
+| viewerVisibleDelay | 隐藏预览操作按钮前的无操作时长                                                                                                                                  | number         | 10000 | |
+| visible           | 受控属性，是否预览                                                                                                                                        | boolean         | - | |
+| zIndex            | 预览层层级                                                                                                                                            | number        | 1070 | |
+| zoomInTip         | 放大操作按钮提示                                                                                                                                         | string         | "放大" | |
+| zoomOutTip        | 缩小操作按钮提示                                                                                                                                         | string        | "缩小" | |
+| zoomStep          | 图片每次缩小/放大比例                                                                                                                                      | number        | 0.1 | |
 
 ### MenuProps
 

content/show/modal/index-en-US.md

@@ -561,43 +561,43 @@ function Demo(props = {}) {
 
 ### Modal
 
-| Properties        | Instructions                                       | type | Default |
-| ----------------- | -------------------------------------------------- | -- | ------- |
-| afterClose             | Callback function when modal closed completely   <br/>**>= v1.16.0**           | () => void | -    |
-| bodyStyle         | Content style                                      | CSSProperties | -       |
-| cancelButtonProps | Properties for cancel button                       | [ButtonProps](/en-US/input/button#API-reference) | -       |
-| cancelText        | Text for cancel button                             | string | -       |
-| centered          | Toggle whether to center modal                     | boolean | false   |
-| closable          | Toggle whether to show close button                | boolean | true    |
-| closeIcon         | Icon for close button  <br/>**>= v1.0.0** | ReactNode | <IconClose /\>    |
-| closeOnEsc        | Toggle whether to allow close modal by keyboard event Esc  <br/>**>= v1.0.0** | boolean | true       | 
-| confirmLoading    | Toggle loading state of confirm button             | boolean | false   |
-| content            | Content            | ReactNode  | -      |
-| footer            | Footer                                             | ReactNode | -       |
-| fullScreen        | Is modal FullScreen（will override width and height） <br/>**>= v1.18.0**      | boolean     | false      |
-| getPopupContainer | Specifies the parent DOM, and the bullet layer will be rendered to the DOM, you need to set 'position: relative` <br/>** >= v0.33.0 **  | () => HTMLElement |() => document.body |   
-| hasCancel        | Toggle whether to show cancal button               | boolean | true      |
-| header            | Header                                             | ReactNode | -       |
-| height            | Height                                             | number | -       |
-| icon              | Custom icon       <br/>**v1.1.0**                                          | ReactNode | -       |
-| keepDOM | Keep dom tree when close modal <br/>**>= v1.0.0**  | boolean | false |
-| lazyRender | Lazy render modal, used with `keepDOM` <br/>**>=v1.0.0**  | boolean | true |      
-| mask              | Toggle whether to show mask                        | boolean | true    |
-| maskClosable      | Toggle whether to allow closing when clicking mask | boolean | true    |
-| maskStyle         | Mask style                                         | CSSProperties | -       |
-| motion            | animation switch           | boolean | true    |
-| okButtonProps     | Properties for confirm button                      | [ButtonProps](/en-US/input/button#API-reference) | -       |
-| okText            | Text for confirm button                            | string | -       |
-| okType            | Type for confirm button, optional: 'primary'、'secondary'、'tertiary'、'warning'、'danger'                            | string | primary |
+| Properties        | Instructions                                                                                                                                                                                  | type | Default |
+| ----------------- |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -- | ------- |
+| afterClose             | Callback function when modal closed completely   <br/>**>= v1.16.0**                                                                                                                          | () => void | -    |
+| bodyStyle         | Content style                                                                                                                                                                                 | CSSProperties | -       |
+| cancelButtonProps | Properties for cancel button                                                                                                                                                                  | [ButtonProps](/en-US/input/button#API-reference) | -       |
+| cancelText        | Text for cancel button                                                                                                                                                                        | string | -       |
+| centered          | Toggle whether to center modal                                                                                                                                                                | boolean | false   |
+| closable          | Toggle whether to show close button                                                                                                                                                           | boolean | true    |
+| closeIcon         | Icon for close button  <br/>**>= v1.0.0**                                                                                                                                                     | ReactNode | <IconClose /\>    |
+| closeOnEsc        | Toggle whether to allow close modal by keyboard event Esc  <br/>**>= v1.0.0**                                                                                                                 | boolean | true       | 
+| confirmLoading    | Toggle loading state of confirm button                                                                                                                                                        | boolean | false   |
+| content            | Content                                                                                                                                                                                       | ReactNode  | -      |
+| footer            | Footer                                                                                                                                                                                        | ReactNode | -       |
+| fullScreen        | Is modal FullScreen（will override width and height） <br/>**>= v1.18.0**                                                                                                                       | boolean     | false      |
+| getPopupContainer | Specifies the parent DOM, and the bullet layer will be rendered to the DOM, you need to set 'position: relative`  This will change the DOM tree position, but not the view's rendering position.  <br/>** >= v0.33.0 **                                                       | () => HTMLElement |() => document.body |   
+| hasCancel        | Toggle whether to show cancal button                                                                                                                                                          | boolean | true      |
+| header            | Header                                                                                                                                                                                        | ReactNode | -       |
+| height            | Height                                                                                                                                                                                        | number | -       |
+| icon              | Custom icon       <br/>**v1.1.0**                                                                                                                                                             | ReactNode | -       |
+| keepDOM | Keep dom tree when close modal <br/>**>= v1.0.0**                                                                                                                                             | boolean | false |
+| lazyRender | Lazy render modal, used with `keepDOM` <br/>**>=v1.0.0**                                                                                                                                      | boolean | true |      
+| mask              | Toggle whether to show mask                                                                                                                                                                   | boolean | true    |
+| maskClosable      | Toggle whether to allow closing when clicking mask                                                                                                                                            | boolean | true    |
+| maskStyle         | Mask style                                                                                                                                                                                    | CSSProperties | -       |
+| motion            | animation switch                                                                                                                                                                              | boolean | true    |
+| okButtonProps     | Properties for confirm button                                                                                                                                                                 | [ButtonProps](/en-US/input/button#API-reference) | -       |
+| okText            | Text for confirm button                                                                                                                                                                       | string | -       |
+| okType            | Type for confirm button, optional: 'primary'、'secondary'、'tertiary'、'warning'、'danger'                                                                                                        | string | primary |
 | preventScroll | Indicates whether the browser should scroll the document to display the newly focused element, acting on the focus method inside the component, excluding the component passed in by the user | boolean |  |  |
-| size | Size of modal, one of `small`(448px), `medium`(684px), `large`(920px), `full-width`(100vw - 64px) <br/>**>= v1.0.0**  | string | 'small' |
-| style             | Inline style                                       | CSSProperties | -       |
-| title             | Title                                              | ReactNode | -       |
-| visible           | Toggle visibility of the modal                     | boolean | false   |
-| width             | Width                                              | number | 448     |
-| zIndex            | Z-index value for mask                             | number | 1000    |
-| onCancel          | Callback function when clicking cancel button      | (e: any) => void \| Promise<any\>  | -       |
-| onOk              | Callback function when clicking confirm button     | (e: any) => void \| Promise<any\>  | -       |
+| size | Size of modal, one of `small`(448px), `medium`(684px), `large`(920px), `full-width`(100vw - 64px) <br/>**>= v1.0.0**                                                                          | string | 'small' |
+| style             | Inline style                                                                                                                                                                                  | CSSProperties | -       |
+| title             | Title                                                                                                                                                                                         | ReactNode | -       |
+| visible           | Toggle visibility of the modal                                                                                                                                                                | boolean | false   |
+| width             | Width                                                                                                                                                                                         | number | 448     |
+| zIndex            | Z-index value for mask                                                                                                                                                                        | number | 1000    |
+| onCancel          | Callback function when clicking cancel button                                                                                                                                                 | (e: any) => void \| Promise<any\>  | -       |
+| onOk              | Callback function when clicking confirm button                                                                                                                                                | (e: any) => void \| Promise<any\>  | -       |
 
 ### Static Method
 

content/show/modal/index.md

@@ -584,12 +584,12 @@ function Demo(props = {}) {
 | content | 对话框内容                                                                                                     | ReactNode | 无 |
 | footer | 对话框底部                                                                                                     | ReactNode | 无 |
 | fullScreen | 对话是否是全屏（会覆盖 width height） <br/>**v1.18.0 后提供**                                                            | boolean | false |
-| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 `position: relative` <br/>**v0.33.0 后提供**                                 | () => HTMLElement | () => document.body |
+| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 `position: relative` 这会改变浮层 DOM 树位置，但不会改变视图渲染位置。  <br/>**v0.33.0 后提供**                                | () => HTMLElement | () => document.body |
 | hasCancel | 是否显示取消按钮                                                                                                  | boolean | true |
 | header | 对话框头部                                                                                                     | ReactNode | 无 |
 | height | 高度                                                                                                        | number | 无 |
 | icon | 自定义 icon <br/>**v1.1.0 后提供**                                                                              | ReactNode | - |
-| keepDOM | 关闭对话框时是否保留内部组件不销毁 <br/>**v1.0.0 后提供**                                                                            | boolean | false |
+| keepDOM | 关闭对话框时是否保留内部组件不销毁 <br/>**v1.0.0 后提供**                                                                     | boolean | false |
 | lazyRender | 配合 keepDOM 使用，为 true 时挂载时不会渲染对话框组件 <br/>**v1.0.0 后提供**                                                    | boolean | true |
 | mask | 是否显示遮罩                                                                                                    | boolean | true |
 | maskClosable | 是否允许通过点击遮罩来关闭对话框                                                                                          | boolean | true |

content/show/popover/index-en-US.md

@@ -539,9 +539,9 @@ Please refer to [Use with Tooltip/Popconfirm](/en-US/show/tooltip#%E6%90%AD%E9%8
 | content | Content displayed                                                                                                                                                                                                                             | string \| ReactNode |  |
 | clickToHide | Whether to automatically close the elastic layer when clicking on the floating layer and any element inside                                                                                                                                   | boolean | false | **0.24.0** |
 | disableFocusListener | When trigger is `hover`, does not respond to the keyboard focus popup event, see details at [issue#977](https://github.com/DouyinFE/semi-design/issues/977)                                                                                   | boolean | true | **2.17.0** |
-| getPopupContainer | Specifies the parent DOM, and the bullet layer will be rendered to the DOM, you need to set 'position: relative`                                                                                                                              | () => HTMLElement | () => document.body |
+| getPopupContainer | Specifies the parent DOM, and the bullet layer will be rendered to the DOM, you need to set 'position: relative`  This will change the DOM tree position, but not the view's rendering position.                                                                                                                              | () => HTMLElement | () => document.body |
 | guardFocus | When the focus is in the popup layer, toggle whether the Tab makes the focus loop in the popup layer                                                                                                                                          | boolean | true | **2.8.0** |
-| keepDOM | Whether to keep internal components from being destroyed when closing                                          | boolean | false | **2.31.0** |
+| keepDOM | Whether to keep internal components from being destroyed when closing                                                                                                                                                                         | boolean | false | **2.31.0** |
 | margin | Popup layer calculates the size of the safe area when the current direction overflows, used in scenes covered by fixed elements, more detail refer to [issue#549](https://github.com/DouyinFE/semi-design/issues/549), same as Tooltip margin | object\|number |  | 2.25.0 |
 | mouseEnterDelay | After the mouse is moved in, the display delay time, in milliseconds (only effective when the trigger is hover/focus)                                                                                                                         | number | 50 |  |
 | mouseLeaveDelay | The time for the delay to disappear after the mouse is moved out, in milliseconds (only effective when the trigger is hover/focus)                                                                                                            | number | 50 |  |

content/show/popover/index.md

@@ -536,7 +536,7 @@ import { Button, Input, Popover, Space } from '@douyinfe/semi-ui';
 | content            | 显示的内容（函数类型，2.8.0 版本支持）                                                                                                                                  | ReactNode \| ({ initialFocusRef }) => ReactNode          |            |            |
 | clickToHide        | 点击弹出层及内部任一元素时是否自动关闭弹层                                                                                                  | boolean                    | false                                       | **0.24.0** |
 | disableFocusListener | trigger为`hover`时，不响应键盘聚焦弹出浮层事件，详见[issue#977](https://github.com/DouyinFE/semi-design/issues/977) | boolean | true | **2.17.0** |
-| getPopupContainer  | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 `position: relative`                                                                  | function():HTMLElement     | () => document.body                         |            |
+| getPopupContainer  | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 `position: relative`  这会改变浮层 DOM 树位置，但不会改变视图渲染位置。                                                                 | function():HTMLElement     | () => document.body                         |            |
 | guardFocus         | 当焦点处于弹出层内时，切换 Tab 是否让焦点在弹出层内循环 | boolean | true | **2.8.0**  |
 | keepDOM | 关闭时是否保留内部组件不销毁 | boolean | false | **2.31.0** |
 | margin     |  弹出层计算溢出时的增加的冗余值，详见[issue#549](https://github.com/DouyinFE/semi-design/issues/549)，作用同 Tooltip margin                        | number\|object                     |            |  **2.25.0**   |

content/show/sidesheet/index-en-US.md

@@ -143,7 +143,7 @@ import { SideSheet, Button, TextArea } from '@douyinfe/semi-ui';
 
 ### Rendered Inside Container
 
-After `v0.29.0`, you could use `getPopupContainer` to render SideSheet in targeted DOM.
+After `v0.29.0`, you could use `getPopupContainer` to render SideSheet in targeted DOM. 
 
 <Notice title='Tips'>
   The container must have `overflow: hidden` to avoid animated SideSheet overflows.
@@ -297,31 +297,31 @@ class Demo extends React.Component {
 
 ## API Reference
 
-| Properties | Instructions | type | Default | Version |
-| --- | --- | --- | --- | --- |
-| afterVisibleChange | Callback function when animation of SideSheet ends | (isVisble: boolean) => void | - | 1.0.0 |
-| bodyStyle | Content style | CSSProperties | - | - |
-| className | Class name | string | - | - |
-| closable | Toggle whether to show close button | boolean | true | - |
-| closeOnEsc | oggle whether to allow close modal by keyboard event Esc | boolean | false | 1.0.0 |
-| disableScroll | Toggle whether to add `overflow: hidden` to document.body element. Only works when not setting `getPopupContainer` | boolean | true | - |
-| footer | Footer | ReactNode | null | 1.3.0 |
-| getPopupContainer | Container where to render SideSheet inside, you need to set 'position: relative` | () => HTMLElement | - | 0.29.0 |
-| headerStyle | Header style | CSSProperties | - | 1.0.0 |
-| height | Height, takes effect when `placement` is set to `top` or `bottom` | number \| string | 400 | - |
-| keepDOM | Keep components inside when closing sideSheet<br/>**v1.18.0 provided** | boolean | false |
-| mask | Toggle whether to show mask. After `v0.29.0`, when `mask={false}`, you could continue operations outside SideSheet | boolean | true | - |
-| maskClosable | Toggle whether to allow closing when clicking mask | boolean | true | - |
-| maskStyle | Mask style | CSSProperties | - | - |
-| motion | Toggle whether to turn on animation | boolean | true | - |
-| placement | Sliding position, one of `top`, `bottom`, `left`, `right` | string | `right` | - |
+| Properties | Instructions                                                                                                               | type | Default | Version |
+| --- |----------------------------------------------------------------------------------------------------------------------------| --- | --- | --- |
+| afterVisibleChange | Callback function when animation of SideSheet ends                                                                         | (isVisble: boolean) => void | - | 1.0.0 |
+| bodyStyle | Content style                                                                                                              | CSSProperties | - | - |
+| className | Class name                                                                                                                 | string | - | - |
+| closable | Toggle whether to show close button                                                                                        | boolean | true | - |
+| closeOnEsc | oggle whether to allow close modal by keyboard event Esc                                                                   | boolean | false | 1.0.0 |
+| disableScroll | Toggle whether to add `overflow: hidden` to document.body element. Only works when not setting `getPopupContainer`         | boolean | true | - |
+| footer | Footer                                                                                                                     | ReactNode | null | 1.3.0 |
+| getPopupContainer | Container where to render SideSheet inside, you need to set 'position: relative`  This will change the DOM tree position, but not the view's rendering position.                                           | () => HTMLElement | - | 0.29.0 |
+| headerStyle | Header style                                                                                                               | CSSProperties | - | 1.0.0 |
+| height | Height, takes effect when `placement` is set to `top` or `bottom`                                                          | number \| string | 400 | - |
+| keepDOM | Keep components inside when closing sideSheet<br/>**v1.18.0 provided**                                                     | boolean | false |
+| mask | Toggle whether to show mask. After `v0.29.0`, when `mask={false}`, you could continue operations outside SideSheet         | boolean | true | - |
+| maskClosable | Toggle whether to allow closing when clicking mask                                                                         | boolean | true | - |
+| maskStyle | Mask style                                                                                                                 | CSSProperties | - | - |
+| motion | Toggle whether to turn on animation                                                                                        | boolean | true | - |
+| placement | Sliding position, one of `top`, `bottom`, `left`, `right`                                                                  | string | `right` | - |
 | size | Size, one of `small`(400px)， `medium`(684px), `large`(920px), only take effects when placement is set to `left` or `right` | string | `small` | 0.29.0 |
-| style | Inline style | CSSProperties | - | - |
-| title | Title | ReactNode | - | - |
-| visible | Toggle visibility of the SideSheet | boolean | false | - |
-| width | Width, takes effect when `placement` is set to `left` or `right` | number \| string | 448 | - |
-| zIndex | Z-index value for SideSheet | number | 1000 | 0.29.0 |
-| onCancel | Callback function when clicking cancel button | (e: MouseEvent) => void | - | - |
+| style | Inline style                                                                                                               | CSSProperties | - | - |
+| title | Title                                                                                                                      | ReactNode | - | - |
+| visible | Toggle visibility of the SideSheet                                                                                         | boolean | false | - |
+| width | Width, takes effect when `placement` is set to `left` or `right`                                                           | number \| string | 448 | - |
+| zIndex | Z-index value for SideSheet                                                                                                | number | 1000 | 0.29.0 |
+| onCancel | Callback function when clicking cancel button                                                                              | (e: MouseEvent) => void | - | - |
 
 ## Accessibility
 

content/show/sidesheet/index.md

@@ -302,31 +302,31 @@ class Demo extends React.Component {
 
 ## API 参考
 
-| 属性 | 说明 | 类型 | 默认值 | 版本 |
-| --- | --- | --- | --- | --- |
-| afterVisibleChange | 面板展示/隐藏时动画结束触发的回调 | (isVisble: boolean) => void | - | 1.0.0 |
-| bodyStyle | 面板内容的样式 | CSSProperties | - | - |
-| className | 类名 | string | - | - |
-| closable | 是否允许通过右上角的关闭按钮关闭 | boolean | true | - |
-| closeOnEsc | 允许通过键盘事件 Esc 触发关闭 | boolean | false | 1.0.0 |
-| disableScroll | 默认渲染在 document.body 层时是否禁止 body 的滚动，即给 body 添加 `overflow: hidden` | boolean | true | - |
-| footer | 侧边栏底部 | ReactNode | null | 1.3.0 |
-| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 `position: relative` | () => HTMLElement | - | 0.29.0 |
-| headerStyle | 面板头部的样式 | CSSProperties | - | 1.0.0 |
-| height | 高度，位置为 `top` 或 `bottom` 时生效 | number \| string | 400 | - |
-| keepDOM | 关闭 SideSheet 时是否保留内部组件不销毁 | boolean | false | 1.18.0|
-| mask | 是否显示遮罩，在 `0.29.0` 版本之后，当 `mask={false}` 时允许对外部区域进行操作 | boolean | true | - |
-| maskClosable | 是否允许通过点击遮罩来关闭面板 | boolean | true | - |
-| maskStyle | 遮罩的样式 | CSSProperties | - | - |
-| motion | 是否允许动画 | boolean | true | - |
-| placement | 侧边栏滑出位置，支持`top`, `bottom`, `left`, `right` | string | `right` | - |
+| 属性 | 说明                                                                            | 类型 | 默认值 | 版本 |
+| --- |-------------------------------------------------------------------------------| --- | --- | --- |
+| afterVisibleChange | 面板展示/隐藏时动画结束触发的回调                                                             | (isVisble: boolean) => void | - | 1.0.0 |
+| bodyStyle | 面板内容的样式                                                                       | CSSProperties | - | - |
+| className | 类名                                                                            | string | - | - |
+| closable | 是否允许通过右上角的关闭按钮关闭                                                              | boolean | true | - |
+| closeOnEsc | 允许通过键盘事件 Esc 触发关闭                                                             | boolean | false | 1.0.0 |
+| disableScroll | 默认渲染在 document.body 层时是否禁止 body 的滚动，即给 body 添加 `overflow: hidden`             | boolean | true | - |
+| footer | 侧边栏底部                                                                         | ReactNode | null | 1.3.0 |
+| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 `position: relative` 这会改变浮层 DOM 树位置，但不会改变视图渲染位置。                          | () => HTMLElement | - | 0.29.0 |
+| headerStyle | 面板头部的样式                                                                       | CSSProperties | - | 1.0.0 |
+| height | 高度，位置为 `top` 或 `bottom` 时生效                                                   | number \| string | 400 | - |
+| keepDOM | 关闭 SideSheet 时是否保留内部组件不销毁                                                     | boolean | false | 1.18.0|
+| mask | 是否显示遮罩，在 `0.29.0` 版本之后，当 `mask={false}` 时允许对外部区域进行操作                          | boolean | true | - |
+| maskClosable | 是否允许通过点击遮罩来关闭面板                                                               | boolean | true | - |
+| maskStyle | 遮罩的样式                                                                         | CSSProperties | - | - |
+| motion | 是否允许动画                                                                        | boolean | true | - |
+| placement | 侧边栏滑出位置，支持`top`, `bottom`, `left`, `right`                                    | string | `right` | - |
 | size | 尺寸，支持 `small`(448px)， `medium`(684px), `large`(920px)，仅在 `left` 或 `right` 时生效 | string | `small` | 0.29.0 |
-| style | 可用于设置样式 | CSSProperties | - | - |
-| title | 面板的标题 | ReactNode | - | - |
-| visible | 面板是否可见 | boolean | false | - |
-| width | 宽度，位置为 `left` 或 `right` 时生效 | number \| string | 448 | - |
-| zIndex | 弹层 z-index 值 | number | 1000 | 0.29.0 |
-| onCancel | 取消面板时的回调函数 | (e: MouseEvent) => void | - | - |
+| style | 可用于设置样式                                                                       | CSSProperties | - | - |
+| title | 面板的标题                                                                         | ReactNode | - | - |
+| visible | 面板是否可见                                                                        | boolean | false | - |
+| width | 宽度，位置为 `left` 或 `right` 时生效                                                   | number \| string | 448 | - |
+| zIndex | 弹层 z-index 值                                                                  | number | 1000 | 0.29.0 |
+| onCancel | 取消面板时的回调函数                                                                    | (e: MouseEvent) => void | - | - |
 
 ## Accessibility
 

content/show/tooltip/index-en-US.md

@@ -330,36 +330,36 @@ import { Popconfirm, Tooltip, Button } from '@douyinfe/semi-ui';
 
 ---
 
-| Properties | Instructions | Type | Default | Version |
-| --- | --- | --- | --- | --- |
-| autoAdjustOverflow | Whether the floating layer automatically adjusts its direction when it is blocked | boolean | true |  |
-| arrowPointAtCenter | Whether the "small triangle" points to the center of the element, you need to pass in "showArrow = true" at the same time | boolean | true | **0.34.0** |
-| className | Pop-up layer classname | string |  |  |
-| content | Pop-up layer content | string | ReactNode |  |
-| clickToHide | Whether to automatically close the elastic layer when clicking on the floating layer and any element inside | boolean | false | **0.24.0** |
-| disableFocusListener | When trigger is `hover`, does not respond to the keyboard focus popup event, see details at [issue#977](https://github.com/DouyinFE/semi-design/issues/977) | boolean | false | **2.17.0** |
-| getPopupContainer | Specifies the parent DOM, and the bullet layer will be rendered to the DOM | () => HTMLElement | () => document.body |
-| keepDOM | Whether to keep internal components from being destroyed when closing                                          | boolean | false | **2.31.0** |
-| margin | Calculate the added redundancy value when overflowing, see [issue#549](https://github.com/DouyinFE/semi-design/issues/549) | number ｜ { marginLeft: number; marginTop: number; marginRight: number; marginBottom: number } | 0 |  **2.23.0**|
-| mouseEnterDelay | After the mouse is moved in, the display delay time, in milliseconds (only effective when the trigger is hover/focus) | number | 50 |  |
-| mouseLeaveDelay | The time for the delay to disappear after the mouse is moved out, in milliseconds (only effective when the trigger is hover/focus), and is not less than mouseEnterDelay | number | 50 |  |
-| motion | Whether to show the pop-up motion | boolean | true |  |
-| position | Pop-up layer display position, optional value: `top`, `topLeft`, `topRight`, `left`, `leftTop`, `leftBottom`, `right`, `rightTop`, `rightBottom`, `bottom`, `bottomLeft`, `bottomRight` | string | 'top' |  |
-| prefixCls | The `className` prefix of the pop-up layer wrapper div. When this item is set, the pop-up layer will no longer have the style of Tooltip. | string | 'semi-tooltip ' |  |
-| preventScroll | Indicates whether the browser should scroll the document to display the newly focused element, acting on the focus method inside the component, excluding the component passed in by the user | boolean |  |  |
-| rePosKey | This value can be updated to manually trigger the repositioning of the pop-up layer. | string | number |  |
-| style | Pop-up layer inline style | object |  |  |
-| spacing | The distance between the pop-up layer and the `children` element | number |  |  |
-| showArrow | Does it show an arrow triangle? | boolean | true |  |
-| stopPropagation | Whether to prevent click events on the bomb layer from bubbling | boolean | false | **0.34.0** |
+| Properties | Instructions                                                                                                                                                                                                                | Type | Default | Version |
+| --- |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| --- | --- | --- |
+| autoAdjustOverflow | Whether the floating layer automatically adjusts its direction when it is blocked                                                                                                                                           | boolean | true |  |
+| arrowPointAtCenter | Whether the "small triangle" points to the center of the element, you need to pass in "showArrow = true" at the same time                                                                                                   | boolean | true | **0.34.0** |
+| className | Pop-up layer classname                                                                                                                                                                                                      | string |  |  |
+| content | Pop-up layer content                                                                                                                                                                                                        | string | ReactNode |  |
+| clickToHide | Whether to automatically close the elastic layer when clicking on the floating layer and any element inside                                                                                                                 | boolean | false | **0.24.0** |
+| disableFocusListener | When trigger is `hover`, does not respond to the keyboard focus popup event, see details at [issue#977](https://github.com/DouyinFE/semi-design/issues/977)                                                                 | boolean | false | **2.17.0** |
+| getPopupContainer | Specifies the parent DOM, and the bullet layer will be rendered to the DOM  This will change the DOM tree position, but not the view's rendering position.                                                                                                                                                  | () => HTMLElement | () => document.body |
+| keepDOM | Whether to keep internal components from being destroyed when closing                                                                                                                                                       | boolean | false | **2.31.0** |
+| margin | Calculate the added redundancy value when overflowing, see [issue#549](https://github.com/DouyinFE/semi-design/issues/549)                                                                                                  | number ｜ { marginLeft: number; marginTop: number; marginRight: number; marginBottom: number } | 0 |  **2.23.0**|
+| mouseEnterDelay | After the mouse is moved in, the display delay time, in milliseconds (only effective when the trigger is hover/focus)                                                                                                       | number | 50 |  |
+| mouseLeaveDelay | The time for the delay to disappear after the mouse is moved out, in milliseconds (only effective when the trigger is hover/focus), and is not less than mouseEnterDelay                                                    | number | 50 |  |
+| motion | Whether to show the pop-up motion                                                                                                                                                                                           | boolean | true |  |
+| position | Pop-up layer display position, optional value: `top`, `topLeft`, `topRight`, `left`, `leftTop`, `leftBottom`, `right`, `rightTop`, `rightBottom`, `bottom`, `bottomLeft`, `bottomRight`                                     | string | 'top' |  |
+| prefixCls | The `className` prefix of the pop-up layer wrapper div. When this item is set, the pop-up layer will no longer have the style of Tooltip.                                                                                   | string | 'semi-tooltip ' |  |
+| preventScroll | Indicates whether the browser should scroll the document to display the newly focused element, acting on the focus method inside the component, excluding the component passed in by the user                               | boolean |  |  |
+| rePosKey | This value can be updated to manually trigger the repositioning of the pop-up layer.                                                                                                                                        | string | number |  |
+| style | Pop-up layer inline style                                                                                                                                                                                                   | object |  |  |
+| spacing | The distance between the pop-up layer and the `children` element                                                                                                                                                            | number |  |  |
+| showArrow | Does it show an arrow triangle?                                                                                                                                                                                             | boolean | true |  |
+| stopPropagation | Whether to prevent click events on the bomb layer from bubbling                                                                                                                                                             | boolean | false | **0.34.0** |
 | transformFromCenter | Whether to transform from the horizontal or vertical center of the element of the package, this parameter affects only the `tansform-origin 'of the dynamic effect transformation and generally does not need to be changed | boolean | true |
-| trigger | Timing of triggering display, optional value: `hover`/`focus`/`click`/`custom` | string | 'hover' |  |
-| visible | Whether to show the pop-up layer | boolean |  |  |
-| wrapperClassName | When children are disabled or children are multiple elements, the outer layer will wrap a layer of span elements, and the api is used to set the style class name of this span | string |  | 1.32.0 |
-| wrapperId | The id of the wrapper node of the popup layer. The aria attribute of the trigger points to this id. | string |  | 2.11.0  |
-| zIndex              | Bullet levels.           | number                      | 1060                |            |
-| onVisibleChange     | A callback triggered when the pop-up layer is displayed/hidden                                                                                                                                                                               | (isVisible: boolean) => void |                     |            |
-| onClickOutSide      | Callback when the pop-up layer is in the display state and the non-Children, non-floating layer inner area is clicked (only valid when trigger is custom, click)                                                                             | (e:event) => void           |                     | **2.1.0** |
+| trigger | Timing of triggering display, optional value: `hover`/`focus`/`click`/`custom`                                                                                                                                              | string | 'hover' |  |
+| visible | Whether to show the pop-up layer                                                                                                                                                                                            | boolean |  |  |
+| wrapperClassName | When children are disabled or children are multiple elements, the outer layer will wrap a layer of span elements, and the api is used to set the style class name of this span                                              | string |  | 1.32.0 |
+| wrapperId | The id of the wrapper node of the popup layer. The aria attribute of the trigger points to this id.                                                                                                                         | string |  | 2.11.0  |
+| zIndex              | Bullet levels.                                                                                                                                                                                                              | number                      | 1060                |            |
+| onVisibleChange     | A callback triggered when the pop-up layer is displayed/hidden                                                                                                                                                              | (isVisible: boolean) => void |                     |            |
+| onClickOutSide      | Callback when the pop-up layer is in the display state and the non-Children, non-floating layer inner area is clicked (only valid when trigger is custom, click)                                                            | (e:event) => void           |                     | **2.1.0** |
 
 
 ## Accessibility

content/show/tooltip/index.md

@@ -278,7 +278,7 @@ import { Tooltip, Tag } from '@douyinfe/semi-ui';
 ```
 ### 渲染至指定 DOM
 
-传入 `getPopupContainer`，弹层将会渲染至该函数返回的 DOM 中。
+传入 `getPopupContainer`，弹层将会渲染至该函数返回的 DOM 中。 这会改变浮层 DOM 树位置，但不会改变视图渲染位置。
 
 **需要注意的是：** 返回的容器如果不是 `document.body`，**`position` 需要设为 `"relative"`**（版本 >= 0.18.0）。
 
@@ -361,36 +361,36 @@ function Demo() {
 
 ---
 
-| 属性 | 说明 | 类型 | 默认值 | 版本 |
-| --- | --- | --- | --- | --- |
-| autoAdjustOverflow | 弹出层被遮挡时是否自动调整方向 | boolean | true |  |
-| arrowPointAtCenter | “小三角”是否指向元素中心，需要同时传入"showArrow=true" | boolean | true | **0.34.0** |
-| content | 弹出层内容 | string\|ReactNode |  |  |
-| className | 弹出层的样式名 | string |  |  |
-| clickToHide | 点击弹出层及内部任一元素时是否自动关闭弹层 | boolean | false | **0.24.0** |
-| disableFocusListener | trigger为`hover`时，不响应键盘聚焦弹出浮层事件，详见[issue#977](https://github.com/DouyinFE/semi-design/issues/977) | boolean | false | **2.17.0** |
-| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 `position: relative` | function():HTMLElement | () => document.body |  |
-| keepDOM | 关闭时是否保留内部组件不销毁 | boolean | false | **2.31.0** |
-| margin | 计算溢出时的增加的冗余值，详见[issue#549](https://github.com/DouyinFE/semi-design/issues/549) | number ｜ <ApiType detail='{ marginLeft: number; marginTop: number; marginRight: number; marginBottom: number }'>MarginObject</ApiType> | 0 |  **2.23.0**|
-| mouseEnterDelay | 鼠标移入后，延迟显示的时间，单位毫秒（仅当 trigger 为 hover/focus 时生效） | number | 50 |  |
-| mouseLeaveDelay | 鼠标移出后，延迟消失的时间，单位毫秒（仅当 trigger 为 hove/focus 时生效），不小于 mouseEnterDelay | number | 50 |  |
-| motion | 是否展示弹出层动画 | boolean | true |  |
+| 属性 | 说明                                                                                                                                                   | 类型 | 默认值 | 版本 |
+| --- |------------------------------------------------------------------------------------------------------------------------------------------------------| --- | --- | --- |
+| autoAdjustOverflow | 弹出层被遮挡时是否自动调整方向                                                                                                                                      | boolean | true |  |
+| arrowPointAtCenter | “小三角”是否指向元素中心，需要同时传入"showArrow=true"                                                                                                                 | boolean | true | **0.34.0** |
+| content | 弹出层内容                                                                                                                                                | string\|ReactNode |  |  |
+| className | 弹出层的样式名                                                                                                                                              | string |  |  |
+| clickToHide | 点击弹出层及内部任一元素时是否自动关闭弹层                                                                                                                                | boolean | false | **0.24.0** |
+| disableFocusListener | trigger为`hover`时，不响应键盘聚焦弹出浮层事件，详见[issue#977](https://github.com/DouyinFE/semi-design/issues/977)                                                     | boolean | false | **2.17.0** |
+| getPopupContainer | 指定父级 DOM，弹层将会渲染至该 DOM 中，自定义需要设置 `position: relative` 这会改变浮层 DOM 树位置，但不会改变视图渲染位置。                                                                                                 | function():HTMLElement | () => document.body |  |
+| keepDOM | 关闭时是否保留内部组件不销毁                                                                                                                                       | boolean | false | **2.31.0** |
+| margin | 计算溢出时的增加的冗余值，详见[issue#549](https://github.com/DouyinFE/semi-design/issues/549)                                                                       | number ｜ <ApiType detail='{ marginLeft: number; marginTop: number; marginRight: number; marginBottom: number }'>MarginObject</ApiType> | 0 |  **2.23.0**|
+| mouseEnterDelay | 鼠标移入后，延迟显示的时间，单位毫秒（仅当 trigger 为 hover/focus 时生效）                                                                                                     | number | 50 |  |
+| mouseLeaveDelay | 鼠标移出后，延迟消失的时间，单位毫秒（仅当 trigger 为 hove/focus 时生效），不小于 mouseEnterDelay                                                                                  | number | 50 |  |
+| motion | 是否展示弹出层动画                                                                                                                                            | boolean | true |  |
 | position | 弹出层展示位置，可选值：`top`, `topLeft`, `topRight`, `left`, `leftTop`, `leftBottom`, `right`, `rightTop`, `rightBottom`, `bottom`, `bottomLeft`, `bottomRight` | string | 'top' |  |
-| prefixCls | 弹出层 wrapper div 的 `className` 前缀，设置该项时，弹出层将不再带 Tooltip 的样式 | string | 'semi-tooltip' |  |
-| preventScroll | 指示浏览器是否应滚动文档以显示新聚焦的元素，作用于组件内的 focus 方法 | boolean |  |  |
-| rePosKey | 可以更新该项值手动触发弹出层的重新定位 | string\|number |  |  |
-| style    | 弹出层的内联样式 | object |  |  |
-| spacing | 弹出层与 `children` 元素的距离，单位 px | number | 8 |  |
-| showArrow | 是否显示箭头三角形 | boolean | true |  |
-| stopPropagation | 是否阻止弹层上的点击事件冒泡 | boolean | false | **0.34.0** |
-| transformFromCenter | 是否从包裹的元素水平或垂直中心处变换，该参数仅影响动效变换的 `transform-origin`，一般无需改动 | boolean | true |  |
-| trigger | 触发展示的时机，可选值：`hover` / `focus` / `click` / `custom` | string | 'hover' |  |
-| visible | 是否展示弹出层 | boolean |  |  |
-| wrapperClassName | 当 children 为 disabled ，或者 children 为多个元素时，外层将会包裹一层 span 元素，该 api 用于设置此 span 的样式类名 | string |  | **1.32.0** |
-| wrapperId | 弹出层 wrapper 节点的 id，trigger 的 aria 属性指向此 id，若不设置组件会随机生成一个 id | string |  | 2.11.0  |
-| zIndex | 弹层层级 | number | 1060 |  |
-| onVisibleChange | 弹出层展示/隐藏时触发的回调 | function(isVisible:boolean) |  |  |
-| onClickOutSide | 当弹出层处于展示状态，点击非Children、非浮层内部区域时的回调（仅trigger为custom、click时有效）| function(e:event) |  | **2.1.0** |
+| prefixCls | 弹出层 wrapper div 的 `className` 前缀，设置该项时，弹出层将不再带 Tooltip 的样式                                                                                           | string | 'semi-tooltip' |  |
+| preventScroll | 指示浏览器是否应滚动文档以显示新聚焦的元素，作用于组件内的 focus 方法                                                                                                               | boolean |  |  |
+| rePosKey | 可以更新该项值手动触发弹出层的重新定位                                                                                                                                  | string\|number |  |  |
+| style    | 弹出层的内联样式                                                                                                                                             | object |  |  |
+| spacing | 弹出层与 `children` 元素的距离，单位 px                                                                                                                          | number | 8 |  |
+| showArrow | 是否显示箭头三角形                                                                                                                                            | boolean | true |  |
+| stopPropagation | 是否阻止弹层上的点击事件冒泡                                                                                                                                       | boolean | false | **0.34.0** |
+| transformFromCenter | 是否从包裹的元素水平或垂直中心处变换，该参数仅影响动效变换的 `transform-origin`，一般无需改动                                                                                             | boolean | true |  |
+| trigger | 触发展示的时机，可选值：`hover` / `focus` / `click` / `custom`                                                                                                   | string | 'hover' |  |
+| visible | 是否展示弹出层                                                                                                                                              | boolean |  |  |
+| wrapperClassName | 当 children 为 disabled ，或者 children 为多个元素时，外层将会包裹一层 span 元素，该 api 用于设置此 span 的样式类名                                                                    | string |  | **1.32.0** |
+| wrapperId | 弹出层 wrapper 节点的 id，trigger 的 aria 属性指向此 id，若不设置组件会随机生成一个 id                                                                                          | string |  | 2.11.0  |
+| zIndex | 弹层层级                                                                                                                                                 | number | 1060 |  |
+| onVisibleChange | 弹出层展示/隐藏时触发的回调                                                                                                                                       | function(isVisible:boolean) |  |  |
+| onClickOutSide | 当弹出层处于展示状态，点击非Children、非浮层内部区域时的回调（仅trigger为custom、click时有效）                                                                                         | function(e:event) |  | **2.1.0** |
 
 ## Accessibility
 

content/start/changelog/index-en-US.md

@@ -16,6 +16,20 @@ Version：Major.Minor.Patch (follow the **Semver** specification)
 
 ---
 
+
+#### 🎉 2.38.0-beta.0 (2023-06-26)
+- 【Feat】
+  - Tree add filterExpandedKeys parameter for onSearch
+  - Badge add succss type
+- 【Fix】
+  - fix toast useToast return value no effect when user function component re render.
+  - Fix the problem that the disabled Cascader cannot display redundant Tags by hovering the +N part
+  - Fix the problem that className does not take effect in ImagePreview  [#1657](https://github.com/DouyinFE/semi-design/issues/1657)
+- 【Chore】
+  - fix formApi.reset params type define error
+- 【Style】
+  - In the disabled case, clicking the Cascader does not trigger the focus style
+
 #### 🎉 2.37.0 (2023-06-09)
 - 【Fix】
     - Fix the problem that preventScroll of TreeSelect searchAutoFocus does not take effect

content/start/changelog/index.md

@@ -13,6 +13,21 @@ Semi 版本号遵循 **Semver** 规范（主版本号-次版本号-修订版本
 -   修订版本号（patch）：仅会进行 bugfix，发布时间不限
 -   不同版本间的详细关系，可查阅 [FAQ](/zh-CN/start/faq)
 
+
+#### 🎉 2.38.0-beta.0 (2023-06-26)
+- 【Feat】
+  - Tree 的 onSearch 新增 filterExpandedKeys 参数
+  - Badge 新增 success 类型
+- 【Fix】
+  - 修复 toast useToast 返回值在用户函数 re render 后失效的问题
+  - 修复 disabled 的 Cascader 无法通过 hover +N 部分显示多余 Tag 问题
+  - 修复 ImagePreview 中 className 不生效问题  [#1657](https://github.com/DouyinFE/semi-design/issues/1657)
+- 【Chore】
+  - 更正 Form formApi.reset 入参类型的问题
+- 【Style】
+  - 在 disabled 情况下，点击 Cascader 不触发 focus 样式
+
+
 #### 🎉 2.37.0 (2023-06-09)
 - 【Fix】
     - 修复 TreeSelect searchAutoFocus 的 preventScroll 未生效问题

packages/semi-foundation/badge/badge.scss

@@ -163,6 +163,19 @@ $module: #{$prefix}-badge;
         }
     }
 
+    &-success {
+        &.#{$module}-solid {
+            background-color: $color-badge_success_solid-bg-default;
+        }
+        &.#{$module}-light {
+            background-color: $color-badge_success_light-bg-default;
+            color: $color-badge_success_light-text-default;
+        }
+        &.#{$module}-inverted {
+            color: $color-badge_success_inverted-text-default;
+        }
+    }
+
 }
 
 @import "./rtl.scss";

packages/semi-foundation/badge/variables.scss

@@ -29,6 +29,10 @@ $color-badge_warning_light-bg-default: var(--semi-color-warning-light-default);
 $color-badge_warning_light-text-default: var(--semi-color-warning); // 文字颜色 - 浅版危险
 $color-badge_warning_inverted-text-default: var(--semi-color-warning); // 文字颜色 - 白底
 
+$color-badge_success_solid-bg-default: var(--semi-color-success); // 背景颜色 - 成功
+$color-badge_success_light-bg-default: var(--semi-color-success-light-default); // 背景颜色 - 浅版成功
+$color-badge_success_light-text-default: var(--semi-color-success); // 文字颜色 - 浅版成功
+$color-badge_success_inverted-text-default: var(--semi-color-success); // 文字颜色 - 白底
 
 $width-badge_dot: 8px; // 点状徽标宽度
 $height-badge_dot: 8px; // 点状徽标高度

packages/semi-foundation/form/interface.ts

@@ -58,7 +58,7 @@ export interface BaseFormApi<T extends object = any> {
     /** submit form manual */
     submitForm: () => void;
     /** reset form manual */
-    reset: () => void;
+    reset: (fields?: Array<string>) => void;
     /** trigger validate  manual */
     validate: <K extends keyof T, Params extends Array<K>, V extends Params[number]>(fields?: Params) => Promise<{ [R in V]: T[R] }>;
     getInitValue: <K extends keyof T>(field: K) => any;

packages/semi-foundation/tree/foundation.ts

@@ -217,7 +217,7 @@ export interface BasicTreeProps {
     onExpand?: (expandedKeys: string[], expandedOtherProps: BasicExpandedOtherProps) => void;
     onLoad?: (loadedKeys?: Set<string>, treeNode?: BasicTreeNodeData) => void;
     onContextMenu?: (e: any, node: BasicTreeNodeData) => void;
-    onSearch?: (sunInput: string) => void;
+    onSearch?: (sunInput: string, filteredExpandedKeys: string[]) => void;
     onSelect?: (selectedKeys: string, selected: boolean, selectedNode: BasicTreeNodeData) => void;
     preventScroll?: boolean;
     renderDraggingNode?: (nodeInstance: HTMLElement, node: BasicTreeNodeData) => HTMLElement;
@@ -303,7 +303,7 @@ export interface TreeAdapter extends DefaultAdapter<BasicTreeProps, BasicTreeInn
     notifyExpand: (expandedKeys: Set<string>, { expanded, node }: BasicExpandedOtherProps) => void;
     notifySelect: (selectKey: string, bool: boolean, node: BasicTreeNodeData) => void;
     notifyChange: (value: BasicValue) => void;
-    notifySearch: (input: string) => void;
+    notifySearch: (input: string, filteredExpandedKeys: string[]) => void;
     notifyRightClick: (e: any, node: BasicTreeNodeData) => void;
     notifyDoubleClick: (e: any, node: BasicTreeNodeData) => void;
     cacheFlattenNodes: (bool: boolean) => void;
@@ -483,13 +483,14 @@ export default class TreeFoundation extends BaseFoundation<TreeAdapter, BasicTre
                 showFilteredOnly && filteredShownKeys
             );
         }
-        this._adapter.notifySearch(sugInput);
+        const newFilteredExpandedKeys = new Set(expandedOptsKeys);
+        this._adapter.notifySearch(sugInput, Array.from(newFilteredExpandedKeys));
         this._adapter.updateState({
             expandedKeys,
             flattenNodes,
             motionKeys: new Set([]),
             filteredKeys: new Set(filteredOptsKeys),
-            filteredExpandedKeys: new Set(expandedOptsKeys),
+            filteredExpandedKeys: newFilteredExpandedKeys,
             filteredShownKeys,
         });
     }

packages/semi-ui/badge/_story/badge.stories.jsx

@@ -46,7 +46,7 @@ export const MaxCount = () => (
 );
 
 export const Type = () => (
-  <div>
+  <div style={{ marginTop: 20}}>
     <Badge count={5} type="primary">
       <a style={style}></a>
     </Badge>
@@ -65,6 +65,9 @@ export const Type = () => (
     <Badge dot type="primary">
       <a style={style}></a>
     </Badge>
+    <Badge dot type="success">
+      <a style={style}></a>
+    </Badge>
   </div>
 );
 

packages/semi-ui/badge/index.tsx

@@ -8,7 +8,7 @@ import '@douyinfe/semi-foundation/badge/badge.scss';
 
 const prefixCls = cssClasses.PREFIX;
 
-export type BadgeType = 'primary' | 'secondary' | 'tertiary' | 'danger' | 'warning';
+export type BadgeType = 'primary' | 'secondary' | 'tertiary' | 'danger' | 'warning' | 'success';
 export type BadgeTheme = 'solid' | 'light' | 'inverted';
 export type BadgePosition = 'leftTop' | 'leftBottom' | 'rightTop' | 'rightBottom';
 

packages/semi-ui/toast/useToast/index.tsx

@@ -1,7 +1,8 @@
-import React, { ReactElement } from 'react';
+import React, { ReactElement, useRef } from 'react';
 import getUuid from '@douyinfe/semi-foundation/utils/uuid';
 import HookToast from './HookToast';
 import { ToastInstance, ToastProps } from '@douyinfe/semi-foundation/toast/toastFoundation';
+import { noop } from "lodash";
 
 // const ref = null;
 // TODO: toast larger than N bars, automatic folding, allowing expansion, N configurable
@@ -29,7 +30,7 @@ function usePatchElement(): [any, typeof patchElement] {
 
 export default function useToast() {
     const [elements, patchElement] = usePatchElement();
-    const toastRef = new Map<string, { close: () => void } & ReactElement>();
+    const toastRef = useRef(new Map<string, { close: () => void }>());
 
     const addToast = (config: ToastProps) => {
         const id = getUuid('semi_toast_');
@@ -39,15 +40,15 @@ export default function useToast() {
         };
         // eslint-disable-next-line prefer-const
         let closeFunc: ReturnType<typeof patchElement>;
-        const ref = (ele: { close: () => void } & ReactElement) => {
-            toastRef.set(id, ele);
-        };
+
         const toast = (
             <HookToast
                 {...mergeConfig}
                 key={id}
                 afterClose={instanceId => closeFunc(instanceId)}
-                ref={ref}
+                ref={(data: { close: () => void }) => {
+                    toastRef.current.set(id, { close: data?.close ?? noop }); 
+                }}
             />
         );
         closeFunc = patchElement(toast, { ...mergeConfig });
@@ -55,8 +56,8 @@ export default function useToast() {
     };
 
     const removeElement = (id: string) => {
-        const ele = toastRef.get(id);
-        ele && ele.close();
+        const { close } = toastRef.current.get(id) ?? {};
+        close?.(); 
     };
 
     return [

packages/semi-ui/tree/_story/tree.stories.jsx

@@ -3,10 +3,11 @@ import { cloneDeep, difference, isEqual } from 'lodash';
 import { IconEdit, IconMapPin, IconMore } from '@douyinfe/semi-icons';
 import Tree from '../index';
 import AutoSizer from '../autoSizer';
-import { Button, ButtonGroup, Input, Popover, Toast, Space, Select, Switch } from '../../index';
+import { Button, ButtonGroup, Input, Popover, Toast, Space, Select, Switch, Typography} from '../../index';
 import BigTree from './BigData';
 import testData from './data';
 const TreeNode = Tree.TreeNode;
+const { Title } = Typography;
 
 export default {
   title: 'Tree'
@@ -2622,3 +2623,74 @@ export const virtualizeTree = () => <DemoV />;
 virtualizeTree.story = {
   name: 'virtualize tree',
 };
+
+export const SearchableAndExpandedKeys = () => {
+  const [expandedKeys1, setExpandedKeys1] = useState([]);
+  const [expandedKeys2, setExpandedKeys2] = useState([]);
+  const [expandedKeys3, setExpandedKeys3] = useState([]);
+  const [expandedKeys4, setExpandedKeys4] = useState([]);
+  return (
+      <>
+          <Title heading={6}>expandedKeys 受控</Title>
+          <Tree
+              style={{ width: 300, marginBottom: 30 }}
+              dropdownStyle={{ maxHeight: 400, overflow: 'auto' }}
+              treeData={treeData1}
+              expandedKeys={expandedKeys1}
+              defaultValue='beijing'
+              onExpand={v => {
+                  console.log('onExpand value: ', v);
+                  setExpandedKeys1(v);
+              }}
+          />
+          <Title heading={6}>expandedKeys 受控 + 开启搜索</Title>
+          <Tree
+              style={{ width: 300, marginBottom: 30 }}
+              dropdownStyle={{ maxHeight: 400, overflow: 'auto' }}
+              treeData={treeData1}
+              filterTreeNode
+              defaultValue='beijing'
+              expandedKeys={expandedKeys2}
+              onExpand={v => {
+                  console.log('onExpand value: ', v);
+                  setExpandedKeys2(v);
+              }}
+          />
+          <Title heading={6}>expandedKeys 受控 + 开启搜索 + 搜索时更新 expandedKeys</Title>
+          <Tree
+              style={{ width: 300, marginBottom: 30 }}
+              dropdownStyle={{ maxHeight: 400, overflow: 'auto' }}
+              treeData={treeData1}
+              filterTreeNode
+              expandedKeys={expandedKeys3}
+              defaultValue='beijing'
+              onExpand={v => {
+                  console.log('onExpand value: ', v);
+                  setExpandedKeys3(v)
+              }}
+              onSearch={(input, filterExpandedKeys) => {
+                  console.log('onExpand filterExpandedKeys: ', filterExpandedKeys);
+                  setExpandedKeys3(filterExpandedKeys);
+              }}
+          />
+          <Title heading={6}>expandedKeys 受控 + 开启搜索 + showFilteredOnly + 搜索时更新 expandedKeys</Title>
+          <Tree
+              style={{ width: 300, marginBottom: 30 }}
+              dropdownStyle={{ maxHeight: 400, overflow: 'auto' }}
+              treeData={treeData1}
+              filterTreeNode
+              showFilteredOnly
+              expandedKeys={expandedKeys4}
+              defaultValue='beijing'
+              onExpand={v => {
+                  console.log('onExpand value: ', v);
+                  setExpandedKeys4(v)
+              }}
+              onSearch={(input, filterExpandedKeys) => {
+                  console.log('onExpand filterExpandedKeys: ', filterExpandedKeys);
+                  setExpandedKeys4(filterExpandedKeys);
+              }}
+          />
+      </>
+  )
+}

packages/semi-ui/tree/index.tsx

@@ -489,8 +489,8 @@ class Tree extends BaseComponent<TreeProps, TreeState> {
             notifyChange: value => {
                 this.props.onChange && this.props.onChange(value);
             },
-            notifySearch: input => {
-                this.props.onSearch && this.props.onSearch(input);
+            notifySearch: (input: string, filteredExpandedKeys: string[]) => {
+                this.props.onSearch && this.props.onSearch(input, filteredExpandedKeys);
             },
             notifyRightClick: (e, node) => {
                 this.props.onContextMenu && this.props.onContextMenu(e, node);