From cf46fcdfc22b8b8b25f13e7a4271f66f11f07aa2 Mon Sep 17 00:00:00 2001 From: yuhaoge Date: Tue, 31 Jan 2023 15:35:07 +0800 Subject: [PATCH] fix HeaderV9 and HitTestTypeV9 Signed-off-by: yuhaoge --- .../reference/apis/js-apis-webview.md | 14 +- .../OpenHarmony_3.2.10.7/changelog-web.md | 183 ++++++++++++++++++ .../OpenHarmony_4.0.3.2/changelog-web.md | 183 ++++++++++++++++++ 3 files changed, 373 insertions(+), 7 deletions(-) create mode 100644 zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.7/changelog-web.md create mode 100644 zh-cn/release-notes/changelogs/OpenHarmony_4.0.3.2/changelog-web.md diff --git a/zh-cn/application-dev/reference/apis/js-apis-webview.md b/zh-cn/application-dev/reference/apis/js-apis-webview.md index 05303a4103..45b88eae96 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-webview.md +++ b/zh-cn/application-dev/reference/apis/js-apis-webview.md @@ -305,7 +305,7 @@ struct WebComponent { ### loadUrl -loadUrl(url: string | Resource, headers?: Array\): void +loadUrl(url: string | Resource, headers?: Array\): void 加载指定的URL。 @@ -316,7 +316,7 @@ loadUrl(url: string | Resource, headers?: Array\): void | 参数名 | 类型 | 必填 | 说明 | | ------- | ---------------- | ---- | :-------------------- | | url | string \| Resource | 是 | 需要加载的 URL。 | -| headers | Array\<[HeaderV9](#headerv9)> | 否 | URL的附加HTTP请求头。 | +| headers | Array\<[WebHeader](#webheader)> | 否 | URL的附加HTTP请求头。 | **错误码:** @@ -829,7 +829,7 @@ struct WebComponent { ### getHitTest -getHitTest(): HitTestTypeV9 +getHitTest(): WebHitTestType 获取当前被点击区域的元素类型。 @@ -839,7 +839,7 @@ getHitTest(): HitTestTypeV9 | 类型 | 说明 | | ------------------------------------------------------------ | ---------------------- | -| [HitTestTypeV9](#hittesttypev9)| 被点击区域的元素类型。 | +| [WebHitTestType](#webhittesttype)| 被点击区域的元素类型。 | **错误码:** @@ -4686,7 +4686,7 @@ struct WebComponent { } } ``` -## HeaderV9 +## WebHeader Web组件返回的请求/响应头对象。 **系统能力:** SystemCapability.Web.Webview.Core @@ -4696,7 +4696,7 @@ Web组件返回的请求/响应头对象。 | headerKey | string | 是 | 是 | 请求/响应头的key。 | | headerValue | string | 是 | 是 | 请求/响应头的value。 | -## HitTestTypeV9 +## WebHitTestType **系统能力:** SystemCapability.Web.Webview.Core @@ -4719,7 +4719,7 @@ Web组件返回的请求/响应头对象。 | 名称 | 类型 | 可读 | 可写 | 说明| | ---- | ---- | ---- | ---- |---- | -| type | [HitTestTypeV9](#hittesttypev9) | 是 | 否 | 当前被点击区域的元素类型。| +| type | [WebHitTestType](#webhittesttype) | 是 | 否 | 当前被点击区域的元素类型。| | extra | string | 是 | 否 |点击区域的附加参数信息。若被点击区域为图片或链接,则附加参数信息为其url地址。 | ## WebMessage diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.7/changelog-web.md b/zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.7/changelog-web.md new file mode 100644 index 0000000000..3aec00351e --- /dev/null +++ b/zh-cn/release-notes/changelogs/OpenHarmony_3.2.10.7/changelog-web.md @@ -0,0 +1,183 @@ +# web子系统ChangeLog + +OpenHarmony 3.2.10.7 版本相较于OpenHarmony 之前的版本,web的API变更如下。 + +## cl.web.1 HitTestTypeV9命名变更 + +枚举类HitTestTypeV9由于命名规范问题,名称变更为WebHitTestType。 + +**变更影响** + +枚举类HitTestTypeV9,以及使用HitTestTypeV9作为参数或返回值的接口,在3.2.10.7版本及后续版本中无法继续正常使用。 + +**关键的接口/组件变更** + +- 涉及接口 + + enum HitTestTypeV9 + +- 变更前: + + ```ts + enum HitTestTypeV9 + ``` + +- 变更后: + + ```ts + enum WebHitTestType + ``` + +**适配指导** + +请使用WebHitTestType替换HitTestTypeV9。 + +## cl.web.2 HeaderV9命名变更 + +结构体HeaderV9由于命名规范问题,名称变更为WebHeader。 + +**变更影响** + +结构体HeaderV9,以及使用HeaderV9作为参数或返回值的接口,在3.2.10.7版本及后续版本中无法继续正常使用。 + +**关键的接口/组件变更** + +- 涉及接口 + + interface HeaderV9 + +- 变更前: + + ```ts + interface HeaderV9 + ``` + +- 变更后: + + ```ts + interface WebHeader + ``` + +**适配指导** + +请使用WebHeader替换HeaderV9。 + +## cl.web.3 HitTestValue结构体成员类型变更 + +结构体HitTestValue中的成员变量HitTestTypeV9由于命名规范问题,名称变更为WebHitTestType。 + +**变更影响** + +结构体HitTestValue,以及使用HitTestValue作为参数或返回值的接口,在3.2.10.7版本及后续版本中无法继续正常使用。 + +**关键的接口/组件变更** + +- 涉及接口 + + interface HitTestValue + +- 变更前: + + ```ts + interface HitTestValue { + + /** + * Get the hit test type. + * + * @since 9 + */ + type: HitTestTypeV9; + + /** + * Get the hit test extra data. + * + * @since 9 + */ + extra: string; + } + ``` + +- 变更后: + + ```ts + interface HitTestValue { + + /** + * Get the hit test type. + * + * @since 9 + */ + type: WebHitTestType; + + /** + * Get the hit test extra data. + * + * @since 9 + */ + extra: string; + } + ``` + +**适配指导** + +请使用WebHitTestType替换HitTestTypeV9。 + +## cl.web.4 loadUrl参数类型变更 + +loadUrl接口中的参数headers,由于其类型的命名规范问题,类型变更为WebHeader。 + +**变更影响** + +loadUrl接口若使用了headers参数,则在3.2.10.7版本及后续版本中无法继续正常使用。 + +**关键的接口/组件变更** + +- 涉及接口 + + loadUrl(url: string | Resource, headers?: Array): void + +- 变更前: + + ```ts + loadUrl(url: string | Resource, headers?: Array): void + ``` + +- 变更后: + + ```ts + loadUrl(url: string | Resource, headers?: Array): void + ``` + +**适配指导** + +在loadUrl中设置headers参数时,请使用WebHeader类型替换HeaderV9类型。 + +## cl.web.5 getHitTest返回值类型变更 + +getHitTest接口中的返回值,由于其类型的命名规范问题,变更为WebHitTest。 + +**变更影响** + +getHitTest接口,在3.2.10.7版本及后续版本中无法继续正常使用。 + +**关键的接口/组件变更** + +- 涉及接口 + + getHitTest(): HitTestTypeV9 + +- 变更前: + + ```ts + getHitTest(): HitTestTypeV9 + ``` + +- 变更后: + + ```ts + getHitTest(): WebHitTestType + ``` + +**适配指导** + +在使用getHitTest接口的返回值时,请使用WebHitTestType类型替换HitTestTypeV9类型。 \ No newline at end of file diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.3.2/changelog-web.md b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.3.2/changelog-web.md new file mode 100644 index 0000000000..301dded59a --- /dev/null +++ b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.3.2/changelog-web.md @@ -0,0 +1,183 @@ +# web子系统ChangeLog + +OpenHarmony 4.0.3.2 版本相较于OpenHarmony 之前的版本,web的API变更如下。 + +## cl.web.1 HitTestTypeV9命名变更 + +枚举类HitTestTypeV9由于命名规范问题,名称变更为WebHitTestType。 + +**变更影响** + +枚举类HitTestTypeV9,以及使用HitTestTypeV9作为参数或返回值的接口,在4.0.3.2版本及后续版本中无法继续正常使用。 + +**关键的接口/组件变更** + +- 涉及接口 + + enum HitTestTypeV9 + +- 变更前: + + ```ts + enum HitTestTypeV9 + ``` + +- 变更后: + + ```ts + enum WebHitTestType + ``` + +**适配指导** + +请使用WebHitTestType替换HitTestTypeV9。 + +## cl.web.2 HeaderV9命名变更 + +结构体HeaderV9由于命名规范问题,名称变更为WebHeader。 + +**变更影响** + +结构体HeaderV9,以及使用HeaderV9作为参数或返回值的接口,在4.0.3.2版本及后续版本中无法继续正常使用。 + +**关键的接口/组件变更** + +- 涉及接口 + + interface HeaderV9 + +- 变更前: + + ```ts + interface HeaderV9 + ``` + +- 变更后: + + ```ts + interface WebHeader + ``` + +**适配指导** + +请使用WebHeader替换HeaderV9。 + +## cl.web.3 HitTestValue结构体成员类型变更 + +结构体HitTestValue中的成员变量HitTestTypeV9由于命名规范问题,名称变更为WebHitTestType。 + +**变更影响** + +结构体HitTestValue,以及使用HitTestValue作为参数或返回值的接口,在4.0.3.2版本及后续版本中无法继续正常使用。 + +**关键的接口/组件变更** + +- 涉及接口 + + interface HitTestValue + +- 变更前: + + ```ts + interface HitTestValue { + + /** + * Get the hit test type. + * + * @since 9 + */ + type: HitTestTypeV9; + + /** + * Get the hit test extra data. + * + * @since 9 + */ + extra: string; + } + ``` + +- 变更后: + + ```ts + interface HitTestValue { + + /** + * Get the hit test type. + * + * @since 9 + */ + type: WebHitTestType; + + /** + * Get the hit test extra data. + * + * @since 9 + */ + extra: string; + } + ``` + +**适配指导** + +请使用WebHitTestType替换HitTestTypeV9。 + +## cl.web.4 loadUrl参数类型变更 + +loadUrl接口中的参数headers,由于其类型的命名规范问题,类型变更为WebHeader。 + +**变更影响** + +loadUrl接口若使用了headers参数,则在4.0.3.2版本及后续版本中无法继续正常使用。 + +**关键的接口/组件变更** + +- 涉及接口 + + loadUrl(url: string | Resource, headers?: Array): void + +- 变更前: + + ```ts + loadUrl(url: string | Resource, headers?: Array): void + ``` + +- 变更后: + + ```ts + loadUrl(url: string | Resource, headers?: Array): void + ``` + +**适配指导** + +在loadUrl中设置headers参数时,请使用WebHeader类型替换HeaderV9类型。 + +## cl.web.5 getHitTest返回值类型变更 + +getHitTest接口中的返回值,由于其类型的命名规范问题,变更为WebHitTest。 + +**变更影响** + +getHitTest接口,在4.0.3.2版本及后续版本中无法继续正常使用。 + +**关键的接口/组件变更** + +- 涉及接口 + + getHitTest(): HitTestTypeV9 + +- 变更前: + + ```ts + getHitTest(): HitTestTypeV9 + ``` + +- 变更后: + + ```ts + getHitTest(): WebHitTestType + ``` + +**适配指导** + +在使用getHitTest接口的返回值时,请使用WebHitTestType类型替换HitTestTypeV9类型。 \ No newline at end of file -- GitLab