From 8c9be3bcc0f66221a2dc5f777f97a144274fd5ab Mon Sep 17 00:00:00 2001 From: i-am-a-little-bird Date: Tue, 3 Jan 2023 14:57:58 +0800 Subject: [PATCH] add context menu docs Signed-off-by: i-am-a-little-bird --- .../arkui-ts/ts-basic-components-web.md | 133 +++++++++++++++++- 1 file changed, 132 insertions(+), 1 deletion(-) diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md index 7863ff594e..77e94d4f2b 100755 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md @@ -2186,7 +2186,7 @@ onPermissionRequest(callback: (event?: { request: PermissionRequest }) => void) onContextMenuShow(callback: (event?: { param: WebContextMenuParam, result: WebContextMenuResult }) => boolean) -长按特定元素(例如图片,链接),跳出菜单。 +长按特定元素(例如图片,链接)或鼠标右键,跳出菜单。 **参数:** @@ -3235,6 +3235,41 @@ grant(resources: Array\): void | --------- | --------------- | ---- | ---- | ------------- | | resources | Array\ | 是 | - | 网页所请求的权限资源列表。 | +## ContextMenuSourceType9+枚举说明 +| 名称 | 描述 | +| -------------------- | ---------- | +| None | 其他事件来源。 | +| Mouse | 鼠标事件。 | +| LongPress | 长按事件。 | + +## ContextMenuMediaType9+枚举说明 + +| 名称 | 描述 | +| ------------ | ----------- | +| None | 非特殊媒体或其他媒体类型。 | +| Image | 图片。 | + +## ContextMenuInputFieldType9+枚举说明 + +| 名称 | 描述 | +| ------------ | ----------- | +| None | 非输入框。 | +| PlainText | 纯文本类型,包括text、search、email等。 | +| Password | 密码类型。 | +| Number | 数字类型。 | +| Telephone | 电话号码类型。 | +| Other | 其他类型。 | + +## ContextMenuEditStateFlags9+枚举说明 + +| 名称 | 描述 | +| ------------ | ----------- | +| NONE | 不可编辑。 | +| CAN_CUT | 支持剪切。 | +| CAN_COPY | 支持拷贝。 | +| CAN_PASTE | 支持粘贴。 | +| CAN_SELECT_ALL | 支持全选。 | + ## WebContextMenuParam9+ 实现长按页面元素跳出来的菜单信息。示例代码参考[onContextMenuShow事件](#oncontextmenushow9)。 @@ -3311,6 +3346,78 @@ existsImageContents(): boolean | ------- | ------------------------- | | boolean | 长按位置中有图片返回true,否则返回false。 | +### getMediaType9+ + +getMediaType(): ContextMenuMediaType; + +获取网页元素媒体类型。 + +**返回值:** + +| 类型 | 说明 | +| ---------------------------------------- | ----------- | +| [ContextMenuMediaType](#contextmenumediatype枚举说明) | 网页元素媒体类型。 | + +### getSelectionText9+ + +getSelectionText(): string; + +获取选中文本。 + +**返回值:** + +| 类型 | 说明 | +| ------- | ------------------------- | +| string | 菜单上下文选中文本内容,不存在则返回空。 | + +### getSourceType9+ + +getSourceType(): ContextMenuSourceType; + +获取菜单事件来源。 + +**返回值:** + +| 类型 | 说明 | +| ---------------------------------------- | ----------- | +| [ContextMenuSourceType](#contextmenumsourcetype枚举说明) | 菜单事件来源。 | + +### getInputFieldType9+ + +getInputFieldType(): ContextMenuInputFieldType; + +获取网页元素输入框类型。 + +**返回值:** + +| 类型 | 说明 | +| ---------------------------------------- | ----------- | +| [ContextMenuInputFieldType](#contextmenuinputfieldtype枚举说明) | 输入框类型。 | + +### isEditable9+ + +isEditable(): boolean; + +获取网页元素是否可编辑标识。 + +**返回值:** + +| 类型 | 说明 | +| ------- | ------------------------- | +| boolean | 网页元素可编辑返回true,否则返回false。 | + +### getEditStateFlags9+ + +getEditStateFlags(): number; + +获取网页元素可编辑标识。 + +**返回值:** + +| 类型 | 说明 | +| ------- | ------------------------- | +| number | 网页元素可编辑标识 [ContextMenuEditStateFlags](contextmenueditstateflags枚举说明)。 | + ## WebContextMenuResult9+ 实现长按页面元素跳出来的菜单所执行的响应事件。示例代码参考[onContextMenuShow事件](#oncontextmenushow9)。 @@ -3327,6 +3434,30 @@ copyImage(): void WebContextMenuParam有图片内容则复制图片。 +### copy9+ + +copy(): void; + +执行与此上下文菜单相关的拷贝操作。 + +### paste9+ + +paste(): void + +执行与此上下文菜单相关的粘贴操作。 + +### cut9+ + +cut(): void + +执行与此上下文菜单相关的剪切操作。 + +### selectAll9+ + +selectAll(): void + +执行与此上下文菜单相关的全选操作。 + ## JsGeolocation Web组件返回授权或拒绝权限功能的对象。示例代码参考[onGeolocationShow事件](#ongeolocationshow)。 -- GitLab