From 673be48d4261e852b10e9c007a1b85a980fce528 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=88=98=E6=B0=B8=E5=87=AF?=
 <liuyongkai2@huawei-partners.com>
Date: Wed, 2 Jul 2025 12:03:28 +0800
Subject: [PATCH] =?UTF-8?q?EditMenuOption=E9=80=82=E9=85=8D1.2=5F0603?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: 刘永凯 <liuyongkai2@huawei-partners.com>
---
 api/@internal/component/ets/text_common.d.ts | 59 ++++++++++++++++++--
 1 file changed, 55 insertions(+), 4 deletions(-)

diff --git a/api/@internal/component/ets/text_common.d.ts b/api/@internal/component/ets/text_common.d.ts
index bb0a8e515e..a48d13b895 100644
--- a/api/@internal/component/ets/text_common.d.ts
+++ b/api/@internal/component/ets/text_common.d.ts
@@ -1214,6 +1214,35 @@ declare interface TextMenuItem {
   labelInfo?: ResourceStr;
 }
 
+/**
+ * Callback function when the selection menu create.
+ *
+ * @typedef { function } OnCreateMenuCallback
+ * @param { Array<TextMenuItem> } menuItems - currently displayed menu items.
+ * @returns { Array<TextMenuItem> } Return the menu items will displayed after operations.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @crossplatform
+ * @atomicservice
+ * @since 20
+ * @arkts 1.2
+ */
+type OnCreateMenuCallback = (menuItems: Array<TextMenuItem>) => Array<TextMenuItem>;
+
+/**
+ * Invoke upon clicking an item, capable of intercepting the default system menu execution behavior.
+ *
+ * @typedef { function } OnMenuItemClickCallback
+ * @param { TextMenuItem } menuItem - current default menu.
+ * @param { TextRange } range - current selected range.
+ * @returns { boolean } - Return True, the event is consumed, false otherwise.
+ * @syscap SystemCapability.ArkUI.ArkUI.Full
+ * @crossplatform
+ * @atomicservice
+ * @since 20
+ * @arkts 1.2
+ */
+type OnMenuItemClickCallback = (menuItem: TextMenuItem, range: TextRange) => boolean
+
 /**
  * EditMenuOptions
  *
@@ -1233,8 +1262,7 @@ declare interface EditMenuOptions {
    * @syscap SystemCapability.ArkUI.ArkUI.Full
    * @crossplatform
    * @atomicservice
-   * @since arkts {'1.1':'12','1.2':'20'}
-   * @arkts 1.1&1.2
+   * @since 12
    */
   onCreateMenu(menuItems: Array<TextMenuItem>): Array<TextMenuItem>;
   /**
@@ -1246,10 +1274,33 @@ declare interface EditMenuOptions {
    * @syscap SystemCapability.ArkUI.ArkUI.Full
    * @crossplatform
    * @atomicservice
-   * @since arkts {'1.1':'12','1.2':'20'}
-   * @arkts 1.1&1.2
+   * @since 12
    */
   onMenuItemClick(menuItem: TextMenuItem, range: TextRange): boolean;
+
+  /**
+   * Passes the default menu, invokes before every display to generate a menu for triggering click events.
+   *
+   * @type { OnCreateMenuCallback }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @crossplatform
+   * @atomicservice
+   * @since 20
+   * @arkts 1.2
+   */
+  onCreateMenu: OnCreateMenuCallback;
+
+  /**
+   * Invoke upon clicking an item, capable of intercepting the default system menu execution behavior.
+   *
+   * @type { OnMenuItemClickCallback }
+   * @syscap SystemCapability.ArkUI.ArkUI.Full
+   * @crossplatform
+   * @atomicservice
+   * @since 20
+   * @arkts 1.2
+   */
+  onMenuItemClick: OnMenuItemClickCallback;
 }
 
 /**
-- 
Gitee