From 61b9db9d1ec4318ee7f07540e71ab5e904ddb057 Mon Sep 17 00:00:00 2001 From: zWX1234017 Date: Thu, 3 Jul 2025 14:55:11 +0800 Subject: [PATCH] Modify the URI and XML documentation in the basic library MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 赵杜炜 --- .../arkts-utils/xml-generation.md | 14 ++++++---- .../arkts-utils/xml-overview.md | 3 ++- .../reference/apis-arkts/js-apis-uri.md | 26 +++++++++---------- 3 files changed, 24 insertions(+), 19 deletions(-) diff --git a/zh-cn/application-dev/arkts-utils/xml-generation.md b/zh-cn/application-dev/arkts-utils/xml-generation.md index ecd0fa5b8d3..a506bc7a380 100644 --- a/zh-cn/application-dev/arkts-utils/xml-generation.md +++ b/zh-cn/application-dev/arkts-utils/xml-generation.md @@ -30,15 +30,19 @@ XML模块的API接口可以参考[@ohos.xml](../reference/apis-arkts/js-apis-xml 2. 创建缓冲区，构造XmlSerializer对象。可以基于ArrayBuffer构造XmlSerializer对象，也可以基于DataView构造XmlSerializer对象。 + 方式1：基于ArrayBuffer构造XmlSerializer对象 + ```ts - // 方式1：基于ArrayBuffer构造XmlSerializer对象 let arrayBuffer: ArrayBuffer = new ArrayBuffer(2048); // 创建一个2048字节的缓冲区 let serializer: xml.XmlSerializer = new xml.XmlSerializer(arrayBuffer); // 基于ArrayBuffer构造XmlSerializer对象 + ``` + + 方式2：基于DataView构造XmlSerializer对象 - // 方式2：基于DataView构造XmlSerializer对象 - // let arrayBuffer: ArrayBuffer = new ArrayBuffer(2048); - // let dataView: DataView = new DataView(arrayBuffer); - // let serializer: xml.XmlSerializer = new xml.XmlSerializer(dataView); + ```ts + let arrayBuffer: ArrayBuffer = new ArrayBuffer(2048); // 创建一个2048字节的缓冲区 + let dataView: DataView = new DataView(arrayBuffer); // 创建一个DataView + let serializer: xml.XmlSerializer = new xml.XmlSerializer(dataView); // 基于DataView构造XmlSerializer对象 ``` 3. 调用XML元素生成函数。 diff --git a/zh-cn/application-dev/arkts-utils/xml-overview.md b/zh-cn/application-dev/arkts-utils/xml-overview.md index dde7b7ccce7..66fd700d259 100644 --- a/zh-cn/application-dev/arkts-utils/xml-overview.md +++ b/zh-cn/application-dev/arkts-utils/xml-overview.md @@ -25,7 +25,8 @@ XML支持命名空间、实体引用、注释和处理指令等特性，使其 以下是一个简单的XML样例及对应说明，更多XML的接口和具体使用，请见[@ohos.xml](../reference/apis-arkts/js-apis-xml.md)。 ```XML - + + diff --git a/zh-cn/application-dev/reference/apis-arkts/js-apis-uri.md b/zh-cn/application-dev/reference/apis-arkts/js-apis-uri.md index 9f741c998a8..d4cff7f8e2c 100644 --- a/zh-cn/application-dev/reference/apis-arkts/js-apis-uri.md +++ b/zh-cn/application-dev/reference/apis-arkts/js-apis-uri.md @@ -23,21 +23,21 @@ import { uri } from '@kit.ArkTS'; | 名称 | 类型 | 只读 | 可选 | 说明 | | -------- | -------- | -------- | -------- | -------- | -| scheme | string | 否 | 否 | 获取和设置URI的协议部分，若无此部分则返回null对象。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。| -| userInfo | string | 否 | 否 | 获取和设置URI的用户信息部分，若无此部分则返回null对象。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | +| scheme | string | 否 | 否 | 获取和设置URI的协议部分，若无此部分则返回null对象。
此属性在API version 19之前为只读属性，不可写，修改此属性会报错。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。| +| userInfo | string | 否 | 否 | 获取和设置URI的用户信息部分，若无此部分则返回null对象。
此属性在API version 19之前为只读属性，不可写，修改此属性会报错。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | | host | string | 是 | 否 | 获取URI的主机名部分（不带端口），若无此部分则返回null对象。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。| | port | string | 是 | 否 | 获取URI的端口部分。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | -| path | string | 否 | 否 | 获取和设置URI的路径部分，若无此部分则返回null对象。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | -| query | string | 否 | 否 | 获取和设置URI的查询部分，若无此部分则返回null对象。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | -| fragment | string | 否 | 否 | 获取和设置URI的片段部分，若无此部分则返回null对象。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | -| authority | string | 否 | 否 | 获取和设置此URI的解码权限组件部分，若无此部分则返回null对象。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | -| ssp | string | 否 | 否 | 获取和设置URI的解码方案特定部分，方案特定部分是URI的一部分，它包含了特定于协议或方案的信息。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | -| encodedUserInfo12+ | string | 否 | 否 | 获取和设置URI的编码用户信息部分，若无此部分则返回null对象。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | -| encodedPath12+ | string | 否 | 否 | 获取和设置URI的编码路径部分，若无此部分则返回null对象。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | -| encodedQuery12+ | string | 否 | 否 | 获取和设置URI的编码查询部分，若无此部分则返回null对象。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | -| encodedFragment12+ | string | 否 | 否 | 获取和设置URI的编码片段部分，若无此部分则返回null对象。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | -| encodedAuthority12+ | string | 否 | 否 | 获取和设置URI的编码权限组件部分，若无此部分则返回null对象。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | -| encodedSSP12+ | string | 否 | 否 | 获取和设置URI的编码方案特定部分。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | +| path | string | 否 | 否 | 获取和设置URI的路径部分，若无此部分则返回null对象。
此属性在API version 19之前为只读属性，不可写，修改此属性会报错。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | +| query | string | 否 | 否 | 获取和设置URI的查询部分，若无此部分则返回null对象。
此属性在API version 19之前为只读属性，不可写，修改此属性会报错。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | +| fragment | string | 否 | 否 | 获取和设置URI的片段部分，若无此部分则返回null对象。
此属性在API version 19之前为只读属性，不可写，修改此属性会报错。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | +| authority | string | 否 | 否 | 获取和设置此URI的解码权限组件部分，若无此部分则返回null对象。
此属性在API version 19之前为只读属性，不可写，修改此属性会报错。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | +| ssp | string | 否 | 否 | 获取和设置URI的解码方案特定部分，方案特定部分是URI的一部分，它包含了特定于协议或方案的信息。
此属性在API version 19之前为只读属性，不可写，修改此属性会报错。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | +| encodedUserInfo12+ | string | 否 | 否 | 获取和设置URI的编码用户信息部分，若无此部分则返回null对象。
此属性在API version 19之前为只读属性，不可写，修改此属性会报错。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | +| encodedPath12+ | string | 否 | 否 | 获取和设置URI的编码路径部分，若无此部分则返回null对象。
此属性在API version 19之前为只读属性，不可写，修改此属性会报错。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | +| encodedQuery12+ | string | 否 | 否 | 获取和设置URI的编码查询部分，若无此部分则返回null对象。
此属性在API version 19之前为只读属性，不可写，修改此属性会报错。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | +| encodedFragment12+ | string | 否 | 否 | 获取和设置URI的编码片段部分，若无此部分则返回null对象。
此属性在API version 19之前为只读属性，不可写，修改此属性会报错。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | +| encodedAuthority12+ | string | 否 | 否 | 获取和设置URI的编码权限组件部分，若无此部分则返回null对象。
此属性在API version 19之前为只读属性，不可写，修改此属性会报错。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | +| encodedSSP12+ | string | 否 | 否 | 获取和设置URI的编码方案特定部分。
此属性在API version 19之前为只读属性，不可写，修改此属性会报错。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | ### 命名规则 -- Gitee