docs(DropdownMenu): update api docs (#803)

anlyyao · github-actions[bot] · web-flow · commit cb6b6e9b3e6a · 2026-01-21T19:18:35.000+08:00
Co-authored-by: github-actions[bot] &lt;github-actions[bot]@users.noreply.github.com&gt;
diff --git a/db/TDesign.db b/db/TDesign.db
diff --git a/packages/products/tdesign-miniprogram/packages/components/dropdown-menu/README.en-US.md b/packages/products/tdesign-miniprogram/packages/components/dropdown-menu/README.en-US.md
@@ -44,23 +44,26 @@ name | type | default | description | required
 style | Object | - | CSS(Cascading Style Sheets) | N
 custom-style | Object | - | CSS(Cascading Style Sheets)，used to set style on virtual component | N
 disabled | Boolean | false | \- | N
-keys | Object | - | Typescript：`KeysType`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/common/common.ts) | N
+keys | Object | - | Typescript: `KeysType`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/common/common.ts) | N
 label | String | - | \- | N
 multiple | Boolean | false | \- | N
-options | Array | [] | Typescript：`Array<DropdownOption>` `interface DropdownOption { label: string; disabled: boolean; value: DropdownValue; }`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/dropdown-item/type.ts) | N
+options | Array | [] | Typescript: `Array<DropdownOption>` `interface DropdownOption { label: string; disabled: boolean; value: DropdownValue; }`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/dropdown-item/type.ts) | N
 options-columns | String / Number | 1 | \- | N
 options-layout | String | columns | `deprecated` | N
 placement | String | left | options: left/right | N
-value | String / Number / Array | undefined | Typescript：`DropdownValue ` `type DropdownValue = string \| number \| Array<DropdownValue>;`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/dropdown-item/type.ts) | N
-default-value | String / Number / Array | undefined | uncontrolled property。Typescript：`DropdownValue ` `type DropdownValue = string \| number \| Array<DropdownValue>;`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/dropdown-item/type.ts) | N
+value | String / Number / Array | undefined | Typescript: `DropdownValue ` `type DropdownValue = string \| number \| Array<DropdownValue>;`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/dropdown-item/type.ts) | N
+default-value | String / Number / Array | undefined | uncontrolled property。Typescript: `DropdownValue ` `type DropdownValue = string \| number \| Array<DropdownValue>;`。[see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/packages/components/dropdown-item/type.ts) | N
 
 ### DropdownItem Events
 
 name | params | description
 -- | -- | --
 change | `(value: DropdownValue)` | \-
 close | \- | \-
+closed | \- | \-
 confirm | `(value: DropdownValue)` | \-
+open | \- | \-
+opened | \- | \-
 reset | \- | \-
 
 ### DropdownItem Slots
diff --git a/packages/products/tdesign-miniprogram/packages/components/dropdown-menu/README.md b/packages/products/tdesign-miniprogram/packages/components/dropdown-menu/README.md
@@ -60,7 +60,10 @@ default-value | String / Number / Array | undefined | 选中值。非受控属
 -- | -- | --
 change | `(value: DropdownValue)` | 值改变时触发
 close | \- | 关闭时触发
+closed | \- | 关闭且动画结束后触发
 confirm | `(value: DropdownValue)` | 点击确认时触发
+open | \- | 打开时触发
+opened | \- | 打开且动画结束后触发
 reset | \- | 点击重置时触发
 
 ### DropdownItem Slots
diff --git a/packages/products/tdesign-mobile-react/src/dropdown-menu/dropdown-menu.en-US.md b/packages/products/tdesign-mobile-react/src/dropdown-menu/dropdown-menu.en-US.md
@@ -33,5 +33,9 @@ placement | String | left | options: left/right | N
 value | String / Number / Array | undefined | Typescript: `DropdownValue ` `type DropdownValue = string \| number \| Array<DropdownValue>;`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/tree/develop/src/dropdown-menu/type.ts) | N
 defaultValue | String / Number / Array | undefined | uncontrolled property。Typescript: `DropdownValue ` `type DropdownValue = string \| number \| Array<DropdownValue>;`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-react/tree/develop/src/dropdown-menu/type.ts) | N
 onChange | Function |  | Typescript: `(value: DropdownValue) => void`<br/> | N
+onClose | Function |  | Typescript: `() => void`<br/>`0.21.2` | N
+onClosed | Function |  | Typescript: `() => void`<br/>`0.21.2` | N
 onConfirm | Function |  | Typescript: `(value: DropdownValue) => void`<br/> | N
+onOpen | Function |  | Typescript: `() => void`<br/>`0.21.2` | N
+onOpened | Function |  | Typescript: `() => void`<br/>`0.21.2` | N
 onReset | Function |  | Typescript: `(value: DropdownValue) => void`<br/> | N
diff --git a/packages/products/tdesign-mobile-react/src/dropdown-menu/dropdown-menu.md b/packages/products/tdesign-mobile-react/src/dropdown-menu/dropdown-menu.md
@@ -33,5 +33,9 @@ placement | String | left | 复选框和内容相对位置，仅单选菜单栏
 value | String / Number / Array | undefined | 选中值。TS 类型：`DropdownValue ` `type DropdownValue = string \| number \| Array<DropdownValue>;`。[详细类型定义](https://github.com/Tencent/tdesign-mobile-react/tree/develop/src/dropdown-menu/type.ts) | N
 defaultValue | String / Number / Array | undefined | 选中值。非受控属性。TS 类型：`DropdownValue ` `type DropdownValue = string \| number \| Array<DropdownValue>;`。[详细类型定义](https://github.com/Tencent/tdesign-mobile-react/tree/develop/src/dropdown-menu/type.ts) | N
 onChange | Function |  | TS 类型：`(value: DropdownValue) => void`<br/>值改变时触发 | N
+onClose | Function |  | TS 类型：`() => void`<br/>`0.21.2`。关闭时触发 | N
+onClosed | Function |  | TS 类型：`() => void`<br/>`0.21.2`。关闭且动画结束后触发 | N
 onConfirm | Function |  | TS 类型：`(value: DropdownValue) => void`<br/>点击确认时触发 | N
+onOpen | Function |  | TS 类型：`() => void`<br/>`0.21.2`。打开时触发 | N
+onOpened | Function |  | TS 类型：`() => void`<br/>`0.21.2`。打开且动画结束后触发 | N
 onReset | Function |  | TS 类型：`(value: DropdownValue) => void`<br/>点击重置时触发 | N
diff --git a/packages/products/tdesign-mobile-react/src/dropdown-menu/type.ts b/packages/products/tdesign-mobile-react/src/dropdown-menu/type.ts
@@ -89,10 +89,26 @@ export interface TdDropdownItemProps {
    * 值改变时触发
    */
   onChange?: (value: DropdownValue) => void;
+  /**
+   * 关闭时触发
+   */
+  onClose?: () => void;
+  /**
+   * 关闭且动画结束后触发
+   */
+  onClosed?: () => void;
   /**
    * 点击确认时触发
    */
   onConfirm?: (value: DropdownValue) => void;
+  /**
+   * 打开时触发
+   */
+  onOpen?: () => void;
+  /**
+   * 打开且动画结束后触发
+   */
+  onOpened?: () => void;
   /**
    * 点击重置时触发
    */
diff --git a/packages/products/tdesign-mobile-vue/src/dropdown-menu/dropdown-item-props.ts b/packages/products/tdesign-mobile-vue/src/dropdown-menu/dropdown-item-props.ts
@@ -65,8 +65,16 @@ export default {
   },
   /** 值改变时触发 */
   onChange: Function as PropType<TdDropdownItemProps['onChange']>,
+  /** 关闭时触发 */
+  onClose: Function as PropType<TdDropdownItemProps['onClose']>,
+  /** 关闭且动画结束后触发 */
+  onClosed: Function as PropType<TdDropdownItemProps['onClosed']>,
   /** 点击确认时触发 */
   onConfirm: Function as PropType<TdDropdownItemProps['onConfirm']>,
+  /** 打开时触发 */
+  onOpen: Function as PropType<TdDropdownItemProps['onOpen']>,
+  /** 打开且动画结束后触发 */
+  onOpened: Function as PropType<TdDropdownItemProps['onOpened']>,
   /** 点击重置时触发 */
   onReset: Function as PropType<TdDropdownItemProps['onReset']>,
 };
diff --git a/packages/products/tdesign-mobile-vue/src/dropdown-menu/dropdown-menu.en-US.md b/packages/products/tdesign-mobile-vue/src/dropdown-menu/dropdown-menu.en-US.md
@@ -29,13 +29,21 @@ placement | String | left | options: left/right | N
 value | String / Number / Array | undefined | `v-model` and `v-model:value` is supported。Typescript: `DropdownValue ` `type DropdownValue = string \| number \| Array<DropdownValue>;`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/dropdown-menu/type.ts) | N
 defaultValue | String / Number / Array | undefined | uncontrolled property。Typescript: `DropdownValue ` `type DropdownValue = string \| number \| Array<DropdownValue>;`。[see more ts definition](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/dropdown-menu/type.ts) | N
 onChange | Function |  | Typescript: `(value: DropdownValue) => void`<br/> | N
+onClose | Function |  | Typescript: `() => void`<br/> | N
+onClosed | Function |  | Typescript: `() => void`<br/> | N
 onConfirm | Function |  | Typescript: `(value: DropdownValue) => void`<br/> | N
+onOpen | Function |  | Typescript: `() => void`<br/> | N
+onOpened | Function |  | Typescript: `() => void`<br/> | N
 onReset | Function |  | Typescript: `(value: DropdownValue) => void`<br/> | N
 
 ### DropdownItem Events
 
 name | params | description
 -- | -- | --
 change | `(value: DropdownValue)` | \-
+close | \- | \-
+closed | \- | \-
 confirm | `(value: DropdownValue)` | \-
+open | \- | \-
+opened | \- | \-
 reset | `(value: DropdownValue)` | \-
diff --git a/packages/products/tdesign-mobile-vue/src/dropdown-menu/dropdown-menu.md b/packages/products/tdesign-mobile-vue/src/dropdown-menu/dropdown-menu.md
@@ -29,13 +29,21 @@ placement | String | left | 复选框和内容相对位置，仅单选菜单栏
 value | String / Number / Array | undefined | 选中值。支持语法糖 `v-model` 或 `v-model:value`。TS 类型：`DropdownValue ` `type DropdownValue = string \| number \| Array<DropdownValue>;`。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/dropdown-menu/type.ts) | N
 defaultValue | String / Number / Array | undefined | 选中值。非受控属性。TS 类型：`DropdownValue ` `type DropdownValue = string \| number \| Array<DropdownValue>;`。[详细类型定义](https://github.com/Tencent/tdesign-mobile-vue/tree/develop/src/dropdown-menu/type.ts) | N
 onChange | Function |  | TS 类型：`(value: DropdownValue) => void`<br/>值改变时触发 | N
+onClose | Function |  | TS 类型：`() => void`<br/>关闭时触发 | N
+onClosed | Function |  | TS 类型：`() => void`<br/>关闭且动画结束后触发 | N
 onConfirm | Function |  | TS 类型：`(value: DropdownValue) => void`<br/>点击确认时触发 | N
+onOpen | Function |  | TS 类型：`() => void`<br/>打开时触发 | N
+onOpened | Function |  | TS 类型：`() => void`<br/>打开且动画结束后触发 | N
 onReset | Function |  | TS 类型：`(value: DropdownValue) => void`<br/>点击重置时触发 | N
 
 ### DropdownItem Events
 
 名称 | 参数 | 描述
 -- | -- | --
 change | `(value: DropdownValue)` | 值改变时触发
+close | \- | 关闭时触发
+closed | \- | 关闭且动画结束后触发
 confirm | `(value: DropdownValue)` | 点击确认时触发
+open | \- | 打开时触发
+opened | \- | 打开且动画结束后触发
 reset | `(value: DropdownValue)` | 点击重置时触发
diff --git a/packages/products/tdesign-mobile-vue/src/dropdown-menu/type.ts b/packages/products/tdesign-mobile-vue/src/dropdown-menu/type.ts
@@ -93,10 +93,26 @@ export interface TdDropdownItemProps {
    * 值改变时触发
    */
   onChange?: (value: DropdownValue) => void;
+  /**
+   * 关闭时触发
+   */
+  onClose?: () => void;
+  /**
+   * 关闭且动画结束后触发
+   */
+  onClosed?: () => void;
   /**
    * 点击确认时触发
    */
   onConfirm?: (value: DropdownValue) => void;
+  /**
+   * 打开时触发
+   */
+  onOpen?: () => void;
+  /**
+   * 打开且动画结束后触发
+   */
+  onOpened?: () => void;
   /**
    * 点击重置时触发
    */
diff --git a/packages/scripts/api.json b/packages/scripts/api.json
@@ -52988,6 +52988,8 @@
     {
       "id": 1712056353,
       "platform_framework": [
+        "8",
+        "16",
         "64"
       ],
       "component": "DropdownItem",
@@ -53009,11 +53011,50 @@
       "html_attribute": 0,
       "trigger_elements": "",
       "deprecated": 0,
-      "version": "",
+      "version": "{\n\"React(Mobile)\": \"0.21.2\"\n}",
       "test_description": null,
       "support_default_value": 0,
       "field_category_text": "Events",
       "platform_framework_text": [
+        "Vue(Mobile)",
+        "React(Mobile)",
+        "Miniprogram"
+      ],
+      "field_type_text": []
+    },
+    {
+      "id": 1768815105,
+      "platform_framework": [
+        "8",
+        "16",
+        "64"
+      ],
+      "component": "DropdownItem",
+      "field_category": 2,
+      "field_name": "closed",
+      "field_type": [],
+      "field_default_value": "",
+      "field_enum": "",
+      "field_desc_zh": "关闭且动画结束后触发",
+      "field_desc_en": null,
+      "field_required": 0,
+      "event_input": "",
+      "create_time": "2026-01-19 09:31:45",
+      "update_time": "2026-01-19 09:31:45",
+      "event_output": null,
+      "custom_field_type": null,
+      "syntactic_sugar": null,
+      "readonly": 1,
+      "html_attribute": 0,
+      "trigger_elements": "",
+      "deprecated": 0,
+      "version": "{\n\"React(Mobile)\": \"0.21.2\"\n}",
+      "test_description": null,
+      "support_default_value": 0,
+      "field_category_text": "Events",
+      "platform_framework_text": [
+        "Vue(Mobile)",
+        "React(Mobile)",
         "Miniprogram"
       ],
       "field_type_text": []
@@ -53055,6 +53096,80 @@
       ],
       "field_type_text": []
     },
+    {
+      "id": 1768815124,
+      "platform_framework": [
+        "8",
+        "16",
+        "64"
+      ],
+      "component": "DropdownItem",
+      "field_category": 2,
+      "field_name": "open",
+      "field_type": [],
+      "field_default_value": "",
+      "field_enum": "",
+      "field_desc_zh": "打开时触发",
+      "field_desc_en": null,
+      "field_required": 0,
+      "event_input": "",
+      "create_time": "2026-01-19 09:32:04",
+      "update_time": "2026-01-19 09:32:04",
+      "event_output": null,
+      "custom_field_type": null,
+      "syntactic_sugar": null,
+      "readonly": 1,
+      "html_attribute": 0,
+      "trigger_elements": "",
+      "deprecated": 0,
+      "version": "{\n\"React(Mobile)\": \"0.21.2\"\n}",
+      "test_description": null,
+      "support_default_value": 0,
+      "field_category_text": "Events",
+      "platform_framework_text": [
+        "Vue(Mobile)",
+        "React(Mobile)",
+        "Miniprogram"
+      ],
+      "field_type_text": []
+    },
+    {
+      "id": 1768815143,
+      "platform_framework": [
+        "8",
+        "16",
+        "64"
+      ],
+      "component": "DropdownItem",
+      "field_category": 2,
+      "field_name": "opened",
+      "field_type": [],
+      "field_default_value": "",
+      "field_enum": "",
+      "field_desc_zh": "打开且动画结束后触发",
+      "field_desc_en": null,
+      "field_required": 0,
+      "event_input": "",
+      "create_time": "2026-01-19 09:32:23",
+      "update_time": "2026-01-19 09:32:23",
+      "event_output": null,
+      "custom_field_type": null,
+      "syntactic_sugar": null,
+      "readonly": 1,
+      "html_attribute": 0,
+      "trigger_elements": "",
+      "deprecated": 0,
+      "version": "{\n\"React(Mobile)\": \"0.21.2\"\n}",
+      "test_description": null,
+      "support_default_value": 0,
+      "field_category_text": "Events",
+      "platform_framework_text": [
+        "Vue(Mobile)",
+        "React(Mobile)",
+        "Miniprogram"
+      ],
+      "field_type_text": []
+    },
     {
       "id": 3495,
       "platform_framework": [
diff --git a/packages/scripts/config/files-combine.js b/packages/scripts/config/files-combine.js
@@ -224,7 +224,7 @@ const COMPONENT_API_MD_MAP = {
 // H5 特殊组件
 const MOBILE_COMPONENT_API_MD_MAP = {
     DropdownMenu: {
-        list:['DropdownMenu', 'DropdownItem'],
+        list: ['DropdownMenu', 'DropdownItem'],
     },
     Layout: {
         list: ['Layout', 'Row', 'Col'],
@@ -450,6 +450,10 @@ const TYPES_COMBINE_MAP = {
 };
 
 const MOBILE_TYPES_COMBINE_MAP = {
+    DropdownMenu: {
+        list: ['DropdownMenu', 'DropdownItem'],
+        excludes: ['Miniprogram'],
+    },
     Layout: {
         list: ['Layout', 'Row', 'Col'],
         excludes: ['Miniprogram'],
@@ -462,10 +466,6 @@ const MOBILE_TYPES_COMBINE_MAP = {
 };
 
 const MINIPROGRAM_TYPES_COMBINE_MAP = {
-    DropdownMenu: {
-        list: ['DropdownMenu', 'DropdownItem'],
-        excludes: ['Miniprogram'],
-    },
     Swiper: {
         list: ['Swiper', 'SwiperNav'],
         excludes: ['Miniprogram'],
