From 1fcbc7d468eb40deaf6178811b7b2a1f0c1b5807 Mon Sep 17 00:00:00 2001 From: "wudefeng@huawei.com" Date: Tue, 5 Aug 2025 15:05:00 +0800 Subject: [PATCH 1/7] web rotate effect api Signed-off-by: wudefeng@huawei.com --- api/@internal/component/ets/web.d.ts | 35 ++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/api/@internal/component/ets/web.d.ts b/api/@internal/component/ets/web.d.ts index 33f6824f2c..93a3f40021 100644 --- a/api/@internal/component/ets/web.d.ts +++ b/api/@internal/component/ets/web.d.ts @@ -7344,6 +7344,31 @@ declare interface SelectionMenuOptionsExt { previewMenuOptions?: PreviewMenuOptions; } +/** + * Enum type supplied to {@link rotateRenderEffect} for setting the effect of rotation. + * + * @enum { number } + * @syscap SystemCapability.Web.Webview.Core + * @since 21 + */ +declare enum WebRotateEffect { + /** + * The content area is drawn in top-left of the node. + * + * @syscap SystemCapability.Web.Webview.Core + * @since 21 + */ + TOPLEFT_EFFECT = 0, + + /** + * Scale the content area to fill the node. + * + * @syscap SystemCapability.Web.Webview.Core + * @since 21 + */ + FILL_EFFECT = 1 +} + /** * Defines the Web attribute functions. * @@ -10461,6 +10486,16 @@ declare class WebAttribute extends CommonMethod { * @since 20 */ gestureFocusMode(mode: GestureFocusMode): WebAttribute; + + /** + * Set up the effect of web roation + * + * @param { WebRotateEffect } effect - The effect of roation. + * @returns { WebAttribute } + * @syscap SystemCapability.Web.Webview.Core + * @since 21 + */ + rotateRenderEffect(effect: WebRotateEffect): WebAttribute; } /** -- Gitee From b52a7adc16dbe6e85b280506e9603fbf5bb3b14a Mon Sep 17 00:00:00 2001 From: "wudefeng@huawei.com" Date: Tue, 5 Aug 2025 21:20:04 +0800 Subject: [PATCH 2/7] param Signed-off-by: wudefeng@huawei.com --- api/@internal/component/ets/web.d.ts | 133 +++++++++++++++++++++++++++ 1 file changed, 133 insertions(+) diff --git a/api/@internal/component/ets/web.d.ts b/api/@internal/component/ets/web.d.ts index 93a3f40021..166a228408 100644 --- a/api/@internal/component/ets/web.d.ts +++ b/api/@internal/component/ets/web.d.ts @@ -1355,6 +1355,16 @@ type OnFullScreenEnterCallback = (event: FullScreenEnterEvent) => void; */ type MouseInfoCallback = (event: NativeEmbedMouseInfo) => void; +/** + * The callback when the param element which is a child item of the object element has changed. + * + * @typedef { function } ObjectParamChangeCallback + * @param { NativeEmbedParamDataInfo } event - callback information of param element. + * @syscap SystemCapability.Web.Webview.Core + * @since 21 + */ +type ObjectParamChangeCallback = (event: NativeEmbedParamDataInfo) => void; + /** * Enum type supplied to {@link renderExitReason} when onRenderExited being called. * @@ -5478,6 +5488,119 @@ declare interface NativeEmbedMouseInfo { result?: EventResult; } +/** + * Enum type supplied to {@link NativeEmbedParamItem} when onNativeEmbedObjectParamChange being called. + * + * @enum { number } + * @syscap SystemCapability.Web.Webview.Core + * @atomicservice + * @since 21 + */ +declare enum NativeEmbedParamStatus { + /** + * The param element is created. + * + * @syscap SystemCapability.Web.Webview.Core + * @atomicservice + * @since 21 + */ + ADD = 0, + + /** + * The param element is updated. + * + * @syscap SystemCapability.Web.Webview.Core + * @atomicservice + * @since 21 + */ + UPDATE = 1, + + /** + *The param element is deleted. + * + * @syscap SystemCapability.Web.Webview.Core + * @atomicservice + * @since 21 + */ + DELETE = 2, +} + +/** + * Defines the information of param element. + * + * @typedef NativeEmbedParamItem + * @syscap SystemCapability.Web.Webview.Core + * @atomicservice + * @since 21 + */ +declare interface NativeEmbedParamItem { + /** + * The status of the param. + * + * @syscap SystemCapability.Web.Webview.Core + * @atomicservice + * @since 21 + */ + status?: NativeEmbedParamStatus; + + /** + * The id of the param element. + * + * @syscap SystemCapability.Web.Webview.Core + * @atomicservice + * @since 21 + */ + id?: string; + + /** + * The name attribute of the param element. + * + * @syscap SystemCapability.Web.Webview.Core + * @atomicservice + * @since 21 + */ + name?: string; + + /** + * The value attribute of the param element. + * + * @syscap SystemCapability.Web.Webview.Core + * @atomicservice + * @since 21 + */ + value?: string; +} + +/** + * Defines the param data info. + * + * @typedef NativeEmbedParamDataInfo + * @syscap SystemCapability.Web.Webview.Core + * @atomicservice + * @since 21 + */ +declare interface NativeEmbedParamDataInfo { + /** + * The embed id. + * + * @type { ?string } + * @syscap SystemCapability.Web.Webview.Core + * @atomicservice + * @since 21 + */ + embedId?: string; + + /** + * The param element array + * + * @type { ?Array } + * @syscap SystemCapability.Web.Webview.Core + * @atomicservice + * @since 21 + */ + paramItems?: Array; +} + /** * Defines the first content paint rendering of web page. * @@ -10159,6 +10282,16 @@ declare class WebAttribute extends CommonMethod { */ onNativeEmbedMouseEvent(callback: MouseInfoCallback): WebAttribute; + /** + * Triggered when the param element which is a child item of the object element has changed. + * + * @param { ObjectParamChangeCallback } callback - callback Triggered when the param element has changed. + * @returns { WebAttribute } + * @syscap SystemCapability.Web.Webview.Core + * @since 21 + */ + onNativeEmbedObjectParamChange(callback: ObjectParamChangeCallback): WebAttribute; + /** * Called to set copy option * -- Gitee From 59134161d72d6249349757aede9da0af7bc3c537 Mon Sep 17 00:00:00 2001 From: "wudefeng@huawei.com" Date: Thu, 7 Aug 2025 21:46:22 +0800 Subject: [PATCH 3/7] update param Signed-off-by: wudefeng@huawei.com --- api/@internal/component/ets/web.d.ts | 28 +++++++++++++++++++--------- 1 file changed, 19 insertions(+), 9 deletions(-) diff --git a/api/@internal/component/ets/web.d.ts b/api/@internal/component/ets/web.d.ts index 166a228408..4579df9393 100644 --- a/api/@internal/component/ets/web.d.ts +++ b/api/@internal/component/ets/web.d.ts @@ -1358,12 +1358,12 @@ type MouseInfoCallback = (event: NativeEmbedMouseInfo) => void; /** * The callback when the param element which is a child item of the object element has changed. * - * @typedef { function } ObjectParamChangeCallback + * @typedef { function } OnNativeEmbedObjectParamChangeCallback * @param { NativeEmbedParamDataInfo } event - callback information of param element. * @syscap SystemCapability.Web.Webview.Core * @since 21 */ -type ObjectParamChangeCallback = (event: NativeEmbedParamDataInfo) => void; +type OnNativeEmbedObjectParamChangeCallback = (event: NativeEmbedParamDataInfo) => void; /** * Enum type supplied to {@link renderExitReason} when onRenderExited being called. @@ -5541,16 +5541,16 @@ declare interface NativeEmbedParamItem { * @atomicservice * @since 21 */ - status?: NativeEmbedParamStatus; + status: NativeEmbedParamStatus; /** - * The id of the param element. + * The id attribute of the param element. * * @syscap SystemCapability.Web.Webview.Core * @atomicservice * @since 21 */ - id?: string; + id: string; /** * The name attribute of the param element. @@ -5581,14 +5581,24 @@ declare interface NativeEmbedParamItem { */ declare interface NativeEmbedParamDataInfo { /** - * The embed id. + * The native embed id. * * @type { ?string } * @syscap SystemCapability.Web.Webview.Core * @atomicservice * @since 21 */ - embedId?: string; + embedId: string; + + /** + * The id attribute of the object element. + * + * @type { ?string } + * @syscap SystemCapability.Web.Webview.Core + * @atomicservice + * @since 21 + */ + objectAttributeId: string; /** * The param element array @@ -5598,7 +5608,7 @@ declare interface NativeEmbedParamDataInfo { * @atomicservice * @since 21 */ - paramItems?: Array; + paramItems: Array; } /** @@ -10290,7 +10300,7 @@ declare class WebAttribute extends CommonMethod { * @syscap SystemCapability.Web.Webview.Core * @since 21 */ - onNativeEmbedObjectParamChange(callback: ObjectParamChangeCallback): WebAttribute; + onNativeEmbedObjectParamChange(callback: OnNativeEmbedObjectParamChangeCallback): WebAttribute; /** * Called to set copy option -- Gitee From 87251f0aa3bae553dbbdd027ba0a97cf443f2456 Mon Sep 17 00:00:00 2001 From: "wudefeng@huawei.com" Date: Thu, 7 Aug 2025 21:51:53 +0800 Subject: [PATCH 4/7] update rotate Signed-off-by: wudefeng@huawei.com --- api/@internal/component/ets/web.d.ts | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/api/@internal/component/ets/web.d.ts b/api/@internal/component/ets/web.d.ts index 4579df9393..5fc0101813 100644 --- a/api/@internal/component/ets/web.d.ts +++ b/api/@internal/component/ets/web.d.ts @@ -7494,12 +7494,12 @@ declare enum WebRotateEffect { TOPLEFT_EFFECT = 0, /** - * Scale the content area to fill the node. + * Scale the content area to cover the node. * * @syscap SystemCapability.Web.Webview.Core * @since 21 */ - FILL_EFFECT = 1 + RESIZE_COVER_EFFECT = 1 } /** -- Gitee From 707d3447716b396be3534bcfaf3fc4a30fbde4ee Mon Sep 17 00:00:00 2001 From: "wudefeng@huawei.com" Date: Thu, 7 Aug 2025 22:00:22 +0800 Subject: [PATCH 5/7] update param Signed-off-by: wudefeng@huawei.com --- api/@internal/component/ets/web.d.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/api/@internal/component/ets/web.d.ts b/api/@internal/component/ets/web.d.ts index 5fc0101813..ae1d20e3ac 100644 --- a/api/@internal/component/ets/web.d.ts +++ b/api/@internal/component/ets/web.d.ts @@ -10295,7 +10295,7 @@ declare class WebAttribute extends CommonMethod { /** * Triggered when the param element which is a child item of the object element has changed. * - * @param { ObjectParamChangeCallback } callback - callback Triggered when the param element has changed. + * @param { OnNativeEmbedObjectParamChangeCallback } callback - callback Triggered when the param element has changed. * @returns { WebAttribute } * @syscap SystemCapability.Web.Webview.Core * @since 21 -- Gitee From 2c57c4bf572837e5c65e3a85e0d5528a287720a0 Mon Sep 17 00:00:00 2001 From: "wudefeng@huawei.com" Date: Mon, 11 Aug 2025 15:20:00 +0800 Subject: [PATCH 6/7] update param Signed-off-by: wudefeng@huawei.com --- api/@internal/component/ets/web.d.ts | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/api/@internal/component/ets/web.d.ts b/api/@internal/component/ets/web.d.ts index ae1d20e3ac..2a42f5a1bd 100644 --- a/api/@internal/component/ets/web.d.ts +++ b/api/@internal/component/ets/web.d.ts @@ -5537,6 +5537,7 @@ declare interface NativeEmbedParamItem { /** * The status of the param. * + * @type { NativeEmbedParamStatus } * @syscap SystemCapability.Web.Webview.Core * @atomicservice * @since 21 @@ -5546,6 +5547,7 @@ declare interface NativeEmbedParamItem { /** * The id attribute of the param element. * + * @type { string } * @syscap SystemCapability.Web.Webview.Core * @atomicservice * @since 21 @@ -5555,6 +5557,7 @@ declare interface NativeEmbedParamItem { /** * The name attribute of the param element. * + * @type { ?string } * @syscap SystemCapability.Web.Webview.Core * @atomicservice * @since 21 @@ -5564,6 +5567,7 @@ declare interface NativeEmbedParamItem { /** * The value attribute of the param element. * + * @type { ?string } * @syscap SystemCapability.Web.Webview.Core * @atomicservice * @since 21 @@ -5583,7 +5587,7 @@ declare interface NativeEmbedParamDataInfo { /** * The native embed id. * - * @type { ?string } + * @type { string } * @syscap SystemCapability.Web.Webview.Core * @atomicservice * @since 21 @@ -5598,7 +5602,7 @@ declare interface NativeEmbedParamDataInfo { * @atomicservice * @since 21 */ - objectAttributeId: string; + objectAttributeId?: string; /** * The param element array @@ -5608,7 +5612,7 @@ declare interface NativeEmbedParamDataInfo { * @atomicservice * @since 21 */ - paramItems: Array; + paramItems?: Array; } /** -- Gitee From e1f9719268d1a255e3576d1a5baa33888e47ce6a Mon Sep 17 00:00:00 2001 From: "wudefeng@huawei.com" Date: Mon, 11 Aug 2025 21:10:18 +0800 Subject: [PATCH 7/7] add arkts del atmoicserver Signed-off-by: wudefeng@huawei.com --- api/@internal/component/ets/web.d.ts | 32 +++++++++++++++++----------- 1 file changed, 19 insertions(+), 13 deletions(-) diff --git a/api/@internal/component/ets/web.d.ts b/api/@internal/component/ets/web.d.ts index 2a42f5a1bd..8166823391 100644 --- a/api/@internal/component/ets/web.d.ts +++ b/api/@internal/component/ets/web.d.ts @@ -1362,6 +1362,7 @@ type MouseInfoCallback = (event: NativeEmbedMouseInfo) => void; * @param { NativeEmbedParamDataInfo } event - callback information of param element. * @syscap SystemCapability.Web.Webview.Core * @since 21 + * @arkts 1.1&1.2 */ type OnNativeEmbedObjectParamChangeCallback = (event: NativeEmbedParamDataInfo) => void; @@ -5493,16 +5494,16 @@ declare interface NativeEmbedMouseInfo { * * @enum { number } * @syscap SystemCapability.Web.Webview.Core - * @atomicservice * @since 21 + * @arkts 1.1&1.2 */ declare enum NativeEmbedParamStatus { /** * The param element is created. * * @syscap SystemCapability.Web.Webview.Core - * @atomicservice * @since 21 + * @arkts 1.1&1.2 */ ADD = 0, @@ -5510,8 +5511,8 @@ declare enum NativeEmbedParamStatus { * The param element is updated. * * @syscap SystemCapability.Web.Webview.Core - * @atomicservice * @since 21 + * @arkts 1.1&1.2 */ UPDATE = 1, @@ -5519,8 +5520,8 @@ declare enum NativeEmbedParamStatus { *The param element is deleted. * * @syscap SystemCapability.Web.Webview.Core - * @atomicservice * @since 21 + * @arkts 1.1&1.2 */ DELETE = 2, } @@ -5530,8 +5531,8 @@ declare enum NativeEmbedParamStatus { * * @typedef NativeEmbedParamItem * @syscap SystemCapability.Web.Webview.Core - * @atomicservice * @since 21 + * @arkts 1.1&1.2 */ declare interface NativeEmbedParamItem { /** @@ -5539,8 +5540,8 @@ declare interface NativeEmbedParamItem { * * @type { NativeEmbedParamStatus } * @syscap SystemCapability.Web.Webview.Core - * @atomicservice * @since 21 + * @arkts 1.1&1.2 */ status: NativeEmbedParamStatus; @@ -5549,8 +5550,8 @@ declare interface NativeEmbedParamItem { * * @type { string } * @syscap SystemCapability.Web.Webview.Core - * @atomicservice * @since 21 + * @arkts 1.1&1.2 */ id: string; @@ -5559,8 +5560,8 @@ declare interface NativeEmbedParamItem { * * @type { ?string } * @syscap SystemCapability.Web.Webview.Core - * @atomicservice * @since 21 + * @arkts 1.1&1.2 */ name?: string; @@ -5569,8 +5570,8 @@ declare interface NativeEmbedParamItem { * * @type { ?string } * @syscap SystemCapability.Web.Webview.Core - * @atomicservice * @since 21 + * @arkts 1.1&1.2 */ value?: string; } @@ -5580,8 +5581,8 @@ declare interface NativeEmbedParamItem { * * @typedef NativeEmbedParamDataInfo * @syscap SystemCapability.Web.Webview.Core - * @atomicservice * @since 21 + * @arkts 1.1&1.2 */ declare interface NativeEmbedParamDataInfo { /** @@ -5589,8 +5590,8 @@ declare interface NativeEmbedParamDataInfo { * * @type { string } * @syscap SystemCapability.Web.Webview.Core - * @atomicservice * @since 21 + * @arkts 1.1&1.2 */ embedId: string; @@ -5599,8 +5600,8 @@ declare interface NativeEmbedParamDataInfo { * * @type { ?string } * @syscap SystemCapability.Web.Webview.Core - * @atomicservice * @since 21 + * @arkts 1.1&1.2 */ objectAttributeId?: string; @@ -5609,8 +5610,8 @@ declare interface NativeEmbedParamDataInfo { * * @type { ?Array } * @syscap SystemCapability.Web.Webview.Core - * @atomicservice * @since 21 + * @arkts 1.1&1.2 */ paramItems?: Array; } @@ -7487,6 +7488,7 @@ declare interface SelectionMenuOptionsExt { * @enum { number } * @syscap SystemCapability.Web.Webview.Core * @since 21 + * @arkts 1.1&1.2 */ declare enum WebRotateEffect { /** @@ -7494,6 +7496,7 @@ declare enum WebRotateEffect { * * @syscap SystemCapability.Web.Webview.Core * @since 21 + * @arkts 1.1&1.2 */ TOPLEFT_EFFECT = 0, @@ -7502,6 +7505,7 @@ declare enum WebRotateEffect { * * @syscap SystemCapability.Web.Webview.Core * @since 21 + * @arkts 1.1&1.2 */ RESIZE_COVER_EFFECT = 1 } @@ -10303,6 +10307,7 @@ declare class WebAttribute extends CommonMethod { * @returns { WebAttribute } * @syscap SystemCapability.Web.Webview.Core * @since 21 + * @arkts 1.1&1.2 */ onNativeEmbedObjectParamChange(callback: OnNativeEmbedObjectParamChangeCallback): WebAttribute; @@ -10641,6 +10646,7 @@ declare class WebAttribute extends CommonMethod { * @returns { WebAttribute } * @syscap SystemCapability.Web.Webview.Core * @since 21 + * @arkts 1.1&1.2 */ rotateRenderEffect(effect: WebRotateEffect): WebAttribute; } -- Gitee