\
| 定义段落。 | \这是一个段落\
| -| \这是一个段落\
这是换行段落\
这个一个段落\
\这是一个段落\
| -| \\这是带有下划线的段落\\
| -| \ | 定义HTML文档的样式信息。 | \ | -| style | 属性规定元素的行内样式，写在标签内部，在使用的时候需用引号来进行区分，并以; 间隔样式，style='width: 500px;height: 500px;border: 1px soild;margin: 0 auto;'。 | \这是一个段落。\
| -| \ | 用于定义客户端文本，比如JavaScript。 | \ | +| 名称 | 描述 | 示例 | +| ------------------- | ---------------------------------------- | ---------------------------------------- | +| \\
| 定义段落。 | \这是一个段落\
| +| \这是一个段落\
这是换行段落\
这个一个段落\
\这是一个段落\
| +| \\这是带有下划线的段落\\
| +| \ | 定义HTML文档的样式信息。 | \ | +| style | 属性规定元素的行内样式，写在标签内部，在使用的时候需用引号来进行区分，并以; 间隔样式，style='width: 500px;height: 500px;border: 1px soild;margin: 0 auto;'。 | \这是一个段落。\
| +| \ | 用于定义客户端文本，比如JavaScript。 | \ | ## 示例 示例效果请以真机运行为准，当前IDE预览器不支持。 -``` +```ts +// xxx.ets @Entry @Component struct RichTextExample { diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-scrollbar.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-scrollbar.md index fb2139c20442965793177da3f7d258ae979bf22e..13438fb94402aae10fc7d76c9eae897ca78526be 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-scrollbar.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-scrollbar.md @@ -1,11 +1,11 @@ # ScrollBar ->  **说明：** -> 该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 - - 滚动条组件ScrollBar，用于配合可滚动组件使用，如List、Grid、Scroll。 +> **说明：** +> +> 该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 + ## 权限列表 @@ -21,35 +21,38 @@ ScrollBar(value: ScrollBarOptions) -- ScrollBarOptions的参数描述 - | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | - | -------- | -------- | -------- | -------- | -------- | - | scroller | [Scroller](ts-container-scroll.md#scroller) | 是 | - | 可滚动组件的控制器。用于与可滚动组件进行绑定。 | - | direction | ScrollBarDirection | 否 | ScrollBarDirection.Vertical | 滚动条的方向，控制可滚动组件对应方向的滚动。 | - | state | BarState | 否 | BarState.Auto | 滚动条状态。 | +**参数：** - >  **说明：** - > ScrollBar组件负责定义可滚动区域的行为样式，ScrollBar的子节点负责定义滚动条的行为样式。 - > - > 滚动条组件与可滚动组件通过Scroller进行绑定，且只有当两者方向相同时，才能联动，ScrollBar与可滚动组件仅支持一对一绑定。 +| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | +| --------- | ---------------------------------------- | ---- | --------------------------- | ----------------------- | +| scroller | [Scroller](ts-container-scroll.md#scroller) | 是 | - | 可滚动组件的控制器。用于与可滚动组件进行绑定。 | +| direction | ScrollBarDirection | 否 | ScrollBarDirection.Vertical | 滚动条的方向，控制可滚动组件对应方向的滚动。 | +| state | BarState | 否 | BarState.Auto | 滚动条状态。 | -- ScrollBarDirection枚举说明 - | 名称 | 描述 | - | -------- | -------- | - | Vertical | 纵向滚动条。 | - | Horizontal | 横向滚动条。 | +> **说明：** +> ScrollBar组件负责定义可滚动区域的行为样式，ScrollBar的子节点负责定义滚动条的行为样式。 +> +> 滚动条组件与可滚动组件通过Scroller进行绑定，且只有当两者方向相同时，才能联动，ScrollBar与可滚动组件仅支持一对一绑定。 -- BarState枚举说明 - | 名称 | 描述 | - | -------- | -------- | - | On | 常驻显示。 | - | Off | 不显示。 | - | Auto | 按需显示(触摸时显示，无操作2s后消失)。 | +## ScrollBarDirection枚举说明 +| 名称 | 描述 | +| ---------- | ------ | +| Vertical | 纵向滚动条。 | +| Horizontal | 横向滚动条。 | + +## BarState枚举说明 + +| 名称 | 描述 | +| ---- | --------------------- | +| On | 常驻显示。 | +| Off | 不显示。 | +| Auto | 按需显示(触摸时显示，无操作2s后消失)。 | ## 示例 -``` +```ts +// xxx.ets @Entry @Component struct ScrollBarExample { diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-search.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-search.md index 4213712676b501c3fcb3090ce10dd7b0c96d0664..a7fd51486f1c17214da1f8bbef33f5720cf87f90 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-search.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-search.md @@ -1,11 +1,11 @@ # Search ->  **说明：** +提供搜索框组件，用于提供用户搜索内容的输入区域。 + +> **说明：** > > 该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 -提供搜索框组件，用于提供用户搜索内容的输入区域。 - ## 权限列表 无 @@ -18,15 +18,14 @@ Search(options?: { value?: string; placeholder?: string; icon?: string; controller?: SearchController }) -- 参数 - - | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | - | ----------- | ---------------- | ---- | ---- | ---------------------------------------- | - | value | string | 否 | - | 搜索文本值。 | - | placeholder | string | 否 | - | 无输入时的提示文本。 | - | icon | string | 否 | - | 搜索图标路径，默认使用系统搜索图标，支持的图标格式: svg, jpg和png。 | - | controller | SearchController | 否 | - | 控制器。 | +**参数：** +| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | +| ----------- | ---------------- | ---- | ---- | ---------------------------------------- | +| value | string | 否 | - | 搜索文本值。 | +| placeholder | string | 否 | - | 无输入时的提示文本。 | +| icon | string | 否 | - | 搜索图标路径，默认使用系统搜索图标，支持的图标格式: svg, jpg和png。 | +| controller | SearchController | 否 | - | 控制器。 | ## 属性 @@ -61,17 +60,17 @@ caretPosition(value: number): viod 设置输入光标的位置。 -- 参数 - - | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | - | ----- | ------ | ---- | ---- | ----------------- | - | value | number | 是 | - | 从字符串开始到光标所在位置的长度。 | +**参数：** +| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | +| ----- | ------ | ---- | ---- | ----------------- | +| value | number | 是 | - | 从字符串开始到光标所在位置的长度。 | ## 示例 -``` +```ts +// xxx.ets @Entry @Component struct SearchExample { diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-select.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-select.md index a1f366c42fe071b4bda667e12765f8b468355090..967f5005cdd6894909939e4b03e110cfe5a38467 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-select.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-select.md @@ -1,9 +1,11 @@ # Select ->  **说明：** 该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 - 提供下拉选择菜单，可以让用户在多个选项之间选择。 +> **说明：** +> +> 该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 + ## 权限列表 无 @@ -16,37 +18,38 @@ Select(options: Array\网页触发alert()告警弹窗时触发回调。
当回调返回false时，触发默认弹窗。当回调返回true时，系统应用可以调用系统弹窗能力（只有确认场景），并且根据用户的确认操作调用JsResult通知Web组件。
- url：当前显示弹窗所在网页的URL。
- message：弹窗中显示的信息。
- result：通知Web组件用户操作行为。
刷新或关闭场景下，在即将离开当前页面时触发此回调。
当回调返回false时，触发默认弹窗。当回调返回true时，系统应用可以调用系统弹窗能力（包括确认和取消），并且需要根据用户的确认或取消操作调用JsResult通知Web组件最终是否离开当前页面。
- url：当前显示弹窗所在网页的URL。
- message：弹窗中显示的信息。
- result：通知Web组件用户操作行为。
网页调用confirm()告警时触发此回调。
当回调返回false时，触发默认弹窗。当回调返回true时，系统应用可以调用系统弹窗能力（包括确认和取消），并且需要根据用户的确认或取消操作调用JsResult通知Web组件。
- url：当前显示弹窗所在网页的URL。
- message：弹窗中显示的信息。
- result：通知Web组件用户操作行为。
网页的下载任务开始时触发该回调。
- url：文件下载的URL。
- userAgent：下载的用户代理（UA）名称。
- contentDisposition：服务器返回的 Content-Disposition响应头，可能为空。
- mimetype：服务器返回内容媒体类型（MIME）信息。
- contentLength：服务器返回文件的长度。
网页加载遇到错误时触发该回调。
出于性能考虑，建议此回调中尽量执行简单逻辑。
- request：网页请求的封装信息。
- error：网页加载资源错误的封装信息 。
网页加载资源遇到的HTTP错误（响应码>=400)时触发该回调。
- request：网页请求的封装信息。
- response：网页响应的封装信息
网页开始加载时触发该回调，且只在主frame触发，iframe或者frameset的内容加载时不会触发此回调。
- url：页面的URL地址。
网页加载完成时触发该回调，且只在主frame触发。
- url：页面的URL地址。
网页开始加载时触发该回调，且只在主frame触发，iframe或者frameset的内容加载时不会触发此回调。
- url：页面的URL地址。
网页加载完成时触发该回调，且只在主frame触发。
- url：页面的URL地址。
网页加载进度变化时触发该回调。
- newProgress：新的加载进度，取值范围为0到100的整数。
网页document标题更改时触发该回调。
- title：document标题内容。
加载网页页面完成时触发该回调，用于应用更新其访问的历史链接。
- url：访问的url。
- isRefreshed：true表示该页面是被重新加载的，false表示该页面是新加载的。
value的true表示显示，false表示隐藏。| +| 名称 | 功能描述 | +| ---------------------------------------- | ---------------------------------------- | +| onChange(callback: (value: boolen) => void) | 当侧边栏的状态在显示和隐藏之间切换时触发回调。
value的true表示显示，false表示隐藏。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct SideBarContainerExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-stack.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-stack.md
index 16691f323bce9ecfc053bf025313c45ec141eeee..ecb65fa1519079ac116b944440a23723c393b4c2 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-container-stack.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-stack.md
@@ -1,11 +1,11 @@
# Stack
->  **说明：**
-> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
-
-
堆叠容器，子组件按照顺序依次入栈，后一个子组件覆盖前一个子组件。
+> **说明：**
+>
+> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+
## 权限列表
@@ -21,15 +21,16 @@
Stack(value:{alignContent?: Alignment})
-- 参数
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | alignContent | [Alignment](ts-appendix-enums.md#alignment枚举说明) | 否 | Center | 设置子组件在容器内的对齐方式。 |
+**参数：**
+| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+| ------------ | ---------------------------------------- | ---- | ------ | --------------- |
+| alignContent | [Alignment](ts-appendix-enums.md#alignment枚举说明) | 否 | Center | 设置子组件在容器内的对齐方式。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct StackExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-swiper.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-swiper.md
index 0a44ddc144d2b368ce4d315bd94c2070e9376aea..6901f5234f9c9e765f2d470db93e19b0389085fd 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-container-swiper.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-swiper.md
@@ -20,11 +20,11 @@
Swiper(value:{controller?: SwiperController})
-- 参数
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | ---------- | ------------------------------------- | ---- | ---- | -------------------- |
- | controller | [SwiperController](#swipercontroller) | 否 | null | 给组件绑定一个控制器，用来控制组件翻页。 |
+**参数：**
+| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+| ---------- | ------------------------------------- | ---- | ---- | -------------------- |
+| controller | [SwiperController](#swipercontroller) | 否 | null | 给组件绑定一个控制器，用来控制组件翻页。 |
## 属性
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-tabcontent.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-tabcontent.md
index 6486c97a25964c9f1e6f10f72f95a77be28c6d5d..27be563ca2377757b948f64c753aac53d4c2fb02 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-container-tabcontent.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-tabcontent.md
@@ -1,11 +1,11 @@
# TabContent
->  **说明：**
-> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
-
-
仅在Tabs中使用，对应一个切换页签的内容视图。
+> **说明：**
+>
+> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+
## 权限列表
@@ -28,17 +28,18 @@ TabContent()
| 名称 | 参数类型 | 默认值 | 描述 |
| ------ | ---------------------------------------- | ---- | ---------------------------------------- |
-| tabBar | string \| {
icon?: string,
text?: string
}
\| [CustomBuilder](../../ui/ts-types.md)8+ | - | 设置TabBar上显示内容。
CustomBuilder: 构造器，内部可以传入组件（API8版本以上适用）。
>  **说明：**
> 如果icon采用svg格式图源，则要求svg图源删除其自有宽高属性值。如采用带有自有宽高属性的svg图源，icon大小则是svg本身内置的宽高属性值大小。 |
+| tabBar | string \| {
icon?: string,
text?: string
}
\| [CustomBuilder](../../ui/ts-types.md)8+ | - | 设置TabBar上显示内容。
CustomBuilder: 构造器，内部可以传入组件（API8版本以上适用）。
> **说明：**
> 如果icon采用svg格式图源，则要求svg图源删除其自有宽高属性值。如采用带有自有宽高属性的svg图源，icon大小则是svg本身内置的宽高属性值大小。 |
->  **说明：**
-> - TabContent组件不支持设置通用宽度属性，其宽度默认撑满Tabs父组件。
+> **说明：**
+> - TabContent组件不支持设置通用宽度属性，其宽度默认撑满Tabs父组件。
>
-> - TabContent组件不支持设置通用高度属性，其高度由Tabs父组件高度与TabBar组件高度决定。
+> - TabContent组件不支持设置通用高度属性，其高度由Tabs父组件高度与TabBar组件高度决定。
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct TabContentExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-tabs.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-tabs.md
index dc4ebb5e6880bf743b284ffdbb644f36a7d1f1f3..6f09309688187492abfcec94156b3a3d9b9601ff 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-container-tabs.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-tabs.md
@@ -1,11 +1,11 @@
# Tabs
->  **说明：**
-> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
-
-
一种可以通过页签进行内容视图切换的容器组件，每个页签对应一个内容视图。
+> **说明：**
+>
+> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+
## 权限列表
@@ -21,45 +21,46 @@
Tabs(value: {barPosition?: BarPosition, index?: number, controller?: [TabsController](#tabscontroller)})
-- 参数
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | barPosition | BarPosition | 否 | BarPosition.Start | 指定页签位置来创建Tabs容器组件。 |
- | index | number | 否 | 0 | 指定初次初始页签索引。 |
- | controller | [TabsController](#tabscontroller) | 否 | - | 设置Tabs控制器。 |
+**参数：**
-- BarPosition枚举说明
- | 名称 | 描述 |
- | -------- | -------- |
- | Start | vertical属性方法设置为true时，页签位于容器左侧；vertical属性方法设置为false时，页签位于容器顶部。 |
- | End | vertical属性方法设置为true时，页签位于容器右侧；vertical属性方法设置为false时，页签位于容器底部。 |
+| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+| ----------- | --------------------------------- | ---- | ----------------- | ------------------ |
+| barPosition | BarPosition | 否 | BarPosition.Start | 指定页签位置来创建Tabs容器组件。 |
+| index | number | 否 | 0 | 指定初次初始页签索引。 |
+| controller | [TabsController](#tabscontroller) | 否 | - | 设置Tabs控制器。 |
+## BarPosition枚举说明
+
+| 名称 | 描述 |
+| ----- | ---------------------------------------- |
+| Start | vertical属性方法设置为true时，页签位于容器左侧；vertical属性方法设置为false时，页签位于容器顶部。 |
+| End | vertical属性方法设置为true时，页签位于容器右侧；vertical属性方法设置为false时，页签位于容器底部。 |
## 属性
不支持触摸热区设置。
-| 名称 | 参数类型 | 默认值 | 描述 |
-| -------- | -------- | -------- | -------- |
-| vertical | boolean | 是否为纵向Tab，默认为false。 | 是否为纵向Tab，默认为false。 |
-| scrollable | boolean | 是否可以通过左右滑动进行页面切换，默认为true。 | 是否可以通过左右滑动进行页面切换，默认为true。 |
-| barMode | BarMode | TabBar布局模式。 | TabBar布局模式。 |
-| barWidth | number | TabBar的宽度值，不设置时使用系统主题中的默认值。 | TabBar的宽度值，不设置时使用系统主题中的默认值。 |
-| barHeight | number | TabBar的高度值，不设置时使用系统主题中的默认值。 | TabBar的高度值，不设置时使用系统主题中的默认值**。** |
-| animationDuration | number | 200 | TabContent滑动动画时长。 |
+| 名称 | 参数类型 | 默认值 | 描述 |
+| ----------------- | ------- | --------------------------- | ------------------------------- |
+| vertical | boolean | 是否为纵向Tab，默认为false。 | 是否为纵向Tab，默认为false。 |
+| scrollable | boolean | 是否可以通过左右滑动进行页面切换，默认为true。 | 是否可以通过左右滑动进行页面切换，默认为true。 |
+| barMode | BarMode | TabBar布局模式。 | TabBar布局模式。 |
+| barWidth | number | TabBar的宽度值，不设置时使用系统主题中的默认值。 | TabBar的宽度值，不设置时使用系统主题中的默认值。 |
+| barHeight | number | TabBar的高度值，不设置时使用系统主题中的默认值。 | TabBar的高度值，不设置时使用系统主题中的默认值**。** |
+| animationDuration | number | 200 | TabContent滑动动画时长。 |
-- BarMode枚举说明
- | 名称 | 描述 |
- | -------- | -------- |
- | Scrollable | TabBar使用实际布局宽度, 超过总长度后可滑动。 |
- | Fixed | 所有TabBar平均分配宽度。 |
+## BarMode枚举说明
+| 名称 | 描述 |
+| ---------- | ------------------------------- |
+| Scrollable | TabBar使用实际布局宽度, 超过总长度后可滑动。 |
+| Fixed | 所有TabBar平均分配宽度。 |
## 事件
-| 名称 | 功能描述 |
-| -------- | -------- |
-| onChange(callback: (index: number) => void) | Tab页签切换后触发的事件。 |
+| 名称 | 功能描述 |
+| ---------------------------------------- | -------------- |
+| onChange(callback: (index: number) => void) | Tab页签切换后触发的事件。 |
## TabsController
@@ -78,15 +79,16 @@ changeIndex(value: number): void
控制Tabs切换到指定页签。
-- 参数
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | value | number | 是 | - | 页签在Tabs里的索引值，索引值从0开始。 |
+**参数：**
+| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+| ----- | ------ | ---- | ---- | --------------------- |
+| value | number | 是 | - | 页签在Tabs里的索引值，索引值从0开始。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct TabsExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-circle.md b/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-circle.md
index c2e660b62c106a8337592bfc21de67bb9b6faa9d..1db4f4378afc8816facaae96a2606e5b1488a10d 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-circle.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-circle.md
@@ -1,11 +1,11 @@
# Circle
->  **说明：**
-> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
-
-
圆形绘制组件。
+> **说明：**
+>
+> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+
## 权限列表
@@ -21,29 +21,25 @@
Circle(options?: {width: Length, height: Length})
-- 参数
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | options | Object | 否 | - | 见options参数说明。 |
-
-- options参数说明
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | width | Length | 是 | - | 宽度。 |
- | height | Length | 是 | - | 高度。 |
+**options参数：**
+| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+| ------ | ------ | ---- | ---- | ---- |
+| width | Length | 是 | - | 宽度。 |
+| height | Length | 是 | - | 高度。 |
## 属性
-| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
-| -------- | -------- | -------- | -------- | -------- |
-| width | Length | 0 | 否 | 圆所在矩形的宽度。 |
-| height | Length | 0 | 否 | 圆所在矩形的高度。 |
+| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
+| ------ | ------ | ---- | ---- | --------- |
+| width | Length | 0 | 否 | 圆所在矩形的宽度。 |
+| height | Length | 0 | 否 | 圆所在矩形的高度。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct CircleExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-ellipse.md b/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-ellipse.md
index 322800fca201305e89e4c767c2fa142af3bb49a3..36d8040c657a83c3c36a00bdb40ada585d9cbf8f 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-ellipse.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-ellipse.md
@@ -1,7 +1,8 @@
# Ellipse
->  **说明：**
-> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+> **说明：**
+>
+> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
椭圆绘制组件。
@@ -21,29 +22,25 @@
ellipse(options?: {width: Length, height: Length})
-- 参数
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | options | Object | 否 | - | 见options参数说明。 |
-
-- options参数说明
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | width | Length | 是 | - | 宽度。 |
- | height | Length | 是 | - | 高度。 |
+**options参数说明：**
+| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+| ------ | ------ | ---- | ---- | ---- |
+| width | Length | 是 | - | 宽度。 |
+| height | Length | 是 | - | 高度。 |
## 属性
-| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
-| -------- | -------- | -------- | -------- | -------- |
-| width | Length | 0 | 否 | 椭圆所在矩形的宽度。 |
-| height | Length | 0 | 否 | 椭圆所在矩形的高度。 |
+| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
+| ------ | ------ | ---- | ---- | ---------- |
+| width | Length | 0 | 否 | 椭圆所在矩形的宽度。 |
+| height | Length | 0 | 否 | 椭圆所在矩形的高度。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct EllipseExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-line.md b/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-line.md
index dd0565e1a35a6a5bfe6795454661260316f4e26a..b5f80f172d4d1f459d31b8bec542396a9b506bb5 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-line.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-line.md
@@ -1,11 +1,11 @@
# Line
->  **说明：**
-> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
-
-
直线绘制组件。
+> **说明：**
+>
+> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+
## 权限列表
@@ -21,31 +21,27 @@
Line(options?: {width: Length, height: Length})
-- 参数
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | options | Object | 否 | - | 见options参数说明。 |
-
-- options参数说明
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | width | Length | 是 | - | 宽度。 |
- | height | Length | 是 | - | 高度。 |
+**options参数说明：**
+| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+| ------ | ------ | ---- | ---- | ---- |
+| width | Length | 是 | - | 宽度。 |
+| height | Length | 是 | - | 高度。 |
## 属性
-| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
-| -------- | -------- | -------- | -------- | -------- |
-| width | Length | 0 | 否 | 直线所在矩形的宽度。 |
-| height | Length | 0 | 否 | 直线所在矩形的高度。 |
-| startPoint | Point | [0, 0] | 是 | 直线起点坐标(相对坐标)。 |
-| endPoint | Point | [0, 0] | 是 | 直线终点坐标(相对坐标)。 |
+| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
+| ---------- | ------ | ----------- | ---- | ------------- |
+| width | Length | 0 | 否 | 直线所在矩形的宽度。 |
+| height | Length | 0 | 否 | 直线所在矩形的高度。 |
+| startPoint | Point | [0, 0] | 是 | 直线起点坐标(相对坐标)。 |
+| endPoint | Point | [0, 0] | 是 | 直线终点坐标(相对坐标)。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct LineExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-path.md b/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-path.md
index 0e9d0e33f4c34b37454ca8b8263298b0856984f0..b1677e23df60821240c9af3a159e2d6355adc550 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-path.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-path.md
@@ -16,14 +16,13 @@
Path(value?: { width?: number | string, height?: number | string, commands?: string })
-- 参数
-
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | ---------------- | ---- | ---- | ----------- |
- | width | number \| string | 否 | 0 | 路径所在矩形的宽度。 |
- | height | number \| string | 否 | 0 | 路径所在矩形的高度。 |
- | commands | string | 否 | '' | 路径绘制的命令字符串。 |
+**参数：**
+| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+| -------- | ---------------- | ---- | ---- | ----------- |
+| width | number \| string | 否 | 0 | 路径所在矩形的宽度。 |
+| height | number \| string | 否 | 0 | 路径所在矩形的高度。 |
+| commands | string | 否 | '' | 路径绘制的命令字符串。 |
## 属性
@@ -63,7 +62,8 @@ Path(value?: { width?: number | string, height?: number | string, commands?: str
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct PathExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-polygon.md b/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-polygon.md
index fc5a45c6886e66b0b4c49e4819f467cc593672df..6e921a4dd227e8f539f6144e58e4da8e1bb3d1d1 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-polygon.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-polygon.md
@@ -1,11 +1,11 @@
# Polygon
->  **说明：**
-> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
-
-
多边形绘制组件。
+> **说明：**
+>
+> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+
## 权限列表
@@ -21,30 +21,26 @@
Polygon(value:{options?: {width: Length, height: Length}})
-- 参数
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | options | Object | 否 | - | 见见options参数说明。 |
-
-- options参数说明
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | width | Length | 是 | - | 宽度。 |
- | height | Length | 是 | - | 高度。 |
+**options参数说明：**
+| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+| ------ | ------ | ---- | ---- | ---- |
+| width | Length | 是 | - | 宽度。 |
+| height | Length | 是 | - | 高度。 |
## 属性
-| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
-| -------- | -------- | -------- | -------- | -------- |
-| width | Length | 0 | 否 | 多边形所在矩形的宽度。 |
-| height | Length | 0 | 否 | 多边形所在矩形的高度。 |
-| points | Array<Point> | - | 是 | 多边形的顶点坐标列表。 |
+| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
+| ------ | ------------------ | ---- | ---- | ----------- |
+| width | Length | 0 | 否 | 多边形所在矩形的宽度。 |
+| height | Length | 0 | 否 | 多边形所在矩形的高度。 |
+| points | Array<Point> | - | 是 | 多边形的顶点坐标列表。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct PolygonExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-polyline.md b/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-polyline.md
index cb6add47d5a1c90442db199b8e172954905237c5..37b72ec5200810550b290fd79ed67abf601b92ba 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-polyline.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-polyline.md
@@ -1,7 +1,8 @@
# Polyline
->  **说明：**
-> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+> **说明：**
+>
+> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
折线绘制组件。
@@ -21,30 +22,26 @@
Polyline(options?: {width: Length, height: Length})
-- 参数
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | options | Object | 否 | - | 见options参数说明。 |
-
-- options参数说明
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | width | Length | 是 | - | 宽度。 |
- | height | Length | 是 | - | 高度。 |
+**options参数说明：**
+| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+| ------ | ------ | ---- | ---- | ---- |
+| width | Length | 是 | - | 宽度。 |
+| height | Length | 是 | - | 高度。 |
## 属性
-| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
-| -------- | -------- | -------- | -------- | -------- |
-| width | Length | 0 | 否 | 折线所在矩形的宽度。 |
-| height | Length | 0 | 否 | 折线所在矩形的高度。 |
-| points | Array<Point> | - | 是 | 折线经过坐标点列表。 |
+| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
+| ------ | ------------------ | ---- | ---- | ---------- |
+| width | Length | 0 | 否 | 折线所在矩形的宽度。 |
+| height | Length | 0 | 否 | 折线所在矩形的高度。 |
+| points | Array<Point> | - | 是 | 折线经过坐标点列表。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct PolylineExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-rect.md b/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-rect.md
index be2e35cf3ed10699a115fef900de6e29c2609b29..aaf992b52b8af25b7b99a8e822cd23d29d28fb4e 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-rect.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-rect.md
@@ -1,7 +1,8 @@
# Rect
->  **说明：**
-> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+> **说明：**
+>
+> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
矩形绘制组件。
@@ -21,35 +22,31 @@
Rect(value:{options?: {width: Length,height: Length,radius?: Length | Array<Length>} | {width: Length,height: Length,radiusWidth?: Length,radiusHeight?: Length}})
-- 参数
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | options | Object | 否 | - | 见options参数说明。 |
-
-- options参数说明
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | width | Length | 是 | - | 宽度。 |
- | height | Length | 是 | - | 高度。 |
- | radius | Length \| Array<Length> | 否 | 0 | 圆角半径，支持分别设置四个角的圆角度数。 |
- | radiusWidth | Length | 否 | 0 | 圆角宽度。 |
- | radiusHeight | Length | 否 | 0 | 圆角高度。 |
+**options参数说明：**
+| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+| ------------ | --------------------------------------- | ---- | ---- | -------------------- |
+| width | Length | 是 | - | 宽度。 |
+| height | Length | 是 | - | 高度。 |
+| radius | Length \| Array<Length> | 否 | 0 | 圆角半径，支持分别设置四个角的圆角度数。 |
+| radiusWidth | Length | 否 | 0 | 圆角宽度。 |
+| radiusHeight | Length | 否 | 0 | 圆角高度。 |
## 属性
-| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
-| -------- | -------- | -------- | -------- | -------- |
-| width | Length | 0 | 否 | 宽度。 |
-| height | Length | 0 | 否 | 高度。 |
-| radiusWidth | Length | 0 | 否 | 圆角的宽度，仅设置宽时宽高一致。 |
-| radiusHeight | Length | 0 | 否 | 圆角的高度，仅设置高时宽高一致。 |
-| radius | Length \| Array<Length> | 0 | 否 | 圆角大小。 |
+| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
+| ------------ | --------------------------------------- | ---- | ---- | ---------------- |
+| width | Length | 0 | 否 | 宽度。 |
+| height | Length | 0 | 否 | 高度。 |
+| radiusWidth | Length | 0 | 否 | 圆角的宽度，仅设置宽时宽高一致。 |
+| radiusHeight | Length | 0 | 否 | 圆角的高度，仅设置高时宽高一致。 |
+| radius | Length \| Array<Length> | 0 | 否 | 圆角大小。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct RectExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-shape.md b/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-shape.md
index 7c3e80fe8db461f185e254d9e7b22ab284aa7697..4a56238b30a5832e9f0405fb2bb169a0b090a3f0 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-shape.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-shape.md
@@ -1,17 +1,15 @@
# Shape
->  **说明：**
-> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
-
-
绘制组件的父组件，父组件中会描述所有绘制组件均支持的通用属性。
-
1、绘制组件使用Shape作为父组件，实现类似SVG的效果。
-
2、绘制组件单独使用，用于在页面上绘制指定的图形。
+> **说明：**
+>
+> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+
## 权限列表
@@ -27,39 +25,40 @@
Shape(value:{target?: PixelMap})
-- 参数
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | target | PixelMap | 否 | null | 绘制目标，可将图形绘制在指定的PixelMap对象中，若未设置，则在当前绘制目标中进行绘制。 |
+**参数：**
+| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+| ------ | -------- | ---- | ---- | ---------------------------------------- |
+| target | PixelMap | 否 | null | 绘制目标，可将图形绘制在指定的PixelMap对象中，若未设置，则在当前绘制目标中进行绘制。 |
## 属性
-| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
-| -------- | -------- | -------- | -------- | -------- |
-| viewPort | {
x: Length,
y: Length,
width: Length,
height: Length
} | - | 是 | 形状的视口。 |
-| fill | Color | Black | 否 | 填充颜色。 |
-| stroke | Color | - | 否 | 边框颜色。 |
-| strokeDashArray | Array<Length> | [] | 否 | 设置边框的间隙。 |
-| strokeDashOffset | Length | 0 | 否 | 边框绘制起点的偏移量。 |
-| strokeLineCap | [LineCapStyle](ts-appendix-enums.md#LineCapStyle枚举说明) | LineCapStyle.Butt | 否 | 路径端点绘制样式。 |
-| strokeLineJoin | LineJoinStyle | LineJoinStyle.Miter | 否 | 边框拐角绘制样式。 |
-| strokeMiterLimit | number | 4 | 否 | 锐角绘制成斜角的极限值。 |
-| strokeOpacity | number | 1 | 否 | 设置边框的不透明度。 |
-| strokeWidth | Length | 1 | 否 | 设置边框的宽度。 |
-| antiAlias | boolean | true | 否 | 是否开启抗锯齿。 |
-
-- LineJoinStyle枚举说明
- | 名称 | 描述 |
- | -------- | -------- |
- | Bevel | 使用斜角连接路径段。 |
- | Miter | 使用尖角连接路径段。 |
- | Round | 使用圆角连接路径段。 |
-
+| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
+| ---------------- | ---------------------------------------- | ------------------- | ---- | ------------ |
+| viewPort | {
x: Length,
y: Length,
width: Length,
height: Length
} | - | 是 | 形状的视口。 |
+| fill | Color | Black | 否 | 填充颜色。 |
+| stroke | Color | - | 否 | 边框颜色。 |
+| strokeDashArray | Array<Length> | [] | 否 | 设置边框的间隙。 |
+| strokeDashOffset | Length | 0 | 否 | 边框绘制起点的偏移量。 |
+| strokeLineCap | [LineCapStyle](ts-appendix-enums.md#LineCapStyle枚举说明) | LineCapStyle.Butt | 否 | 路径端点绘制样式。 |
+| strokeLineJoin | LineJoinStyle | LineJoinStyle.Miter | 否 | 边框拐角绘制样式。 |
+| strokeMiterLimit | number | 4 | 否 | 锐角绘制成斜角的极限值。 |
+| strokeOpacity | number | 1 | 否 | 设置边框的不透明度。 |
+| strokeWidth | Length | 1 | 否 | 设置边框的宽度。 |
+| antiAlias | boolean | true | 否 | 是否开启抗锯齿。 |
+
+## LineJoinStyle枚举说明
+
+| 名称 | 描述 |
+| ----- | ---------- |
+| Bevel | 使用斜角连接路径段。 |
+| Miter | 使用尖角连接路径段。 |
+| Round | 使用圆角连接路径段。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct ShapeExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-explicit-animation.md b/zh-cn/application-dev/reference/arkui-ts/ts-explicit-animation.md
index 9b2c8200c3c62f8472861e88590fd3fb47866e0f..8c1d10aed8ffec034003a4b1feb6a47bffb08d7f 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-explicit-animation.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-explicit-animation.md
@@ -1,36 +1,38 @@
# 显式动画
->  **说明：**
-> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+> **说明：**
+>
+> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
-| 接口名称 | 功能描述 |
-| ------------------------------------------------------------ | ------------------------------------------------------------ |
+| 接口名称 | 功能描述 |
+| ---------------------------------------- | ---------------------------------------- |
| animateTo(value: [AnimationOptions](#animationoptions对象说明), event: ()=> void) : void | 提供全局animateTo显式动画接口来指定由于闭包代码导致的状态变化插入过渡动效。
event指定显示动效的闭包函数，在闭包函数中导致的状态变化系统会自动插入过渡动画。 |
## AnimationOptions对象说明
-- 属性
- | 属性名称 | 属性类型 | 默认值 | 描述 |
- | -------- | -------- | -------- | -------- |
- | duration | number | 1000 | 动画持续时间，单位为毫秒。 |
- | tempo | number | 1.0 | 动画的播放速度，值越大动画播放越快，值越小播放越慢，为0时无动画效果。 |
- | curve | Curve \| Curves | Linear | 动画曲线。 |
- | delay | number | 0 | 单位为ms(毫秒)，默认不延时播放。 |
- | iterations | number | 1 | 默认播放一次，设置为-1时表示无限次播放。 |
- | playMode | PlayMode | Normal | 设置动画播放模式，默认播放完成后重头开始播放。 |
+### 属性
+| 属性名称 | 属性类型 | 默认值 | 描述 |
+| ---------- | ------------------------- | ------ | ----------------------------------- |
+| duration | number | 1000 | 动画持续时间，单位为毫秒。 |
+| tempo | number | 1.0 | 动画的播放速度，值越大动画播放越快，值越小播放越慢，为0时无动画效果。 |
+| curve | Curve \| Curves | Linear | 动画曲线。 |
+| delay | number | 0 | 单位为ms(毫秒)，默认不延时播放。 |
+| iterations | number | 1 | 默认播放一次，设置为-1时表示无限次播放。 |
+| playMode | PlayMode | Normal | 设置动画播放模式，默认播放完成后重头开始播放。 |
-- 接口
- | 名称 | 功能描述 |
- | -------- | -------- |
- | onFinish() => void | 动效播放完成回调。 |
+### 接口
+| 名称 | 功能描述 |
+| ------------------------------- | --------- |
+| onFinish() => void | 动效播放完成回调。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct AnimateToExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-interpolation-calculation.md b/zh-cn/application-dev/reference/arkui-ts/ts-interpolation-calculation.md
index 8d7f9b9f75892f0c4cc4e83bf5bc6e28d82615c4..25a017df72ff01f7cb1fda311c7f30f14e9146b9 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-interpolation-calculation.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-interpolation-calculation.md
@@ -1,6 +1,6 @@
# 插值计算
->  **说明：**
+> **说明：**
> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-matrix-transformation.md b/zh-cn/application-dev/reference/arkui-ts/ts-matrix-transformation.md
index fa9ecb8c49bc37ad43f20fabc6f14b77718768a6..40d89097abf49f7a49ec24b5e49387c645d66c86 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-matrix-transformation.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-matrix-transformation.md
@@ -1,6 +1,6 @@
# 矩阵变换
->  **说明：**
+> **说明：**
> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md b/zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md
index bd97f739ccbae22648af5b99e7f7d363fed9a7c6..b7bf5b90c356be7eab397976bce19c41d00a060d 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md
@@ -1,6 +1,6 @@
# Video
->  **说明：**
+> **说明：**
> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
视频播放组件。
@@ -33,7 +33,7 @@ Video(value: VideoOptions)
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| ------------------- | ---------------------------------------- | ---- | ---------------------------------------- | ---------------------------------------- |
| src | string \| [Resource](../../ui/ts-types.md) | 否 | - | 视频播放源的路径，支持本地视频路径和网络路径。
支持在resources下面的video或rawfile文件夹里放置媒体资源。
支持dataability://的路径前缀，用于访问通过Data Ability提供的视频路径，具体路径信息详见[Data Ability说明](../../ability/fa-dataability.md)。 |
- | currentProgressRate | number \| PlaybackSpeed8+ | 否 | 1.0 \| PlaybackSpeed.
Speed_Forward_1_00_X | 视频播放倍速。
>  **说明：**
> number取值仅支持：0.75，1.0，1.25，1.75，2.0。
|
+ | currentProgressRate | number \| PlaybackSpeed8+ | 否 | 1.0 \| PlaybackSpeed.
Speed_Forward_1_00_X | 视频播放倍速。
> **说明：**
> number取值仅支持：0.75，1.0，1.25，1.75，2.0。
|
| previewUri | string \| PixelMap8+ \| [Resource](../../ui/ts-types.md) | 否 | - | 预览图片的路径。 |
| controller | [VideoController](#videocontroller) | 否 | - | 控制器。 |
@@ -155,7 +155,8 @@ setCurrentTime(value: number, seekMode: SeekMode)
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct VideoCreateComponent {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-methods-action-sheet.md b/zh-cn/application-dev/reference/arkui-ts/ts-methods-action-sheet.md
index 07d48cb35b8d26ed9ed9cb3d16659799e8e25506..e5e4e723fb00b7a44c4656b23b4125e39edaf8df 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-methods-action-sheet.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-methods-action-sheet.md
@@ -1,6 +1,6 @@
# 列表选择弹窗
->  **说明：**
+> **说明：**
> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
@@ -42,7 +42,8 @@ show(options: { paramObject1})
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct ActionSheetExapmle {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-methods-alert-dialog-box.md b/zh-cn/application-dev/reference/arkui-ts/ts-methods-alert-dialog-box.md
index 2f55b32db3bfe3d1873065876243b2f308702d49..57162b87f0ffa886dff0c4cb184ebc7dfac05844 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-methods-alert-dialog-box.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-methods-alert-dialog-box.md
@@ -1,6 +1,6 @@
# 警告弹窗
->  **说明：**
+> **说明：**
> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
@@ -41,7 +41,8 @@
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct AlertDialogExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-methods-custom-dialog-box.md b/zh-cn/application-dev/reference/arkui-ts/ts-methods-custom-dialog-box.md
index 26a07679a32099d18d50cc43dac30cc14b288256..4608aba9dc8edc10aca85072454448606546cd61 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-methods-custom-dialog-box.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-methods-custom-dialog-box.md
@@ -1,6 +1,6 @@
# 自定义弹窗
->  **说明：**
+> **说明：**
> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-methods-datepicker-dialog.md b/zh-cn/application-dev/reference/arkui-ts/ts-methods-datepicker-dialog.md
index 10a9a68cda53c73b82ce1dac80ad4044c7acaaf9..98663cb9bf0387b0cf266122cf76093e2c81eb50 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-methods-datepicker-dialog.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-methods-datepicker-dialog.md
@@ -1,6 +1,6 @@
# 日期滑动选择器弹窗
->  **说明：**
+> **说明：**
> 该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
根据指定范围的Date创建可以选择日期的滑动选择器，展示在弹窗上。
@@ -29,7 +29,8 @@ show(options?: DatePickerDialogOptions)
## 示例
### 日期滑动选择器（显示农历）示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct DatePickerDialogExample01 {
@@ -62,7 +63,8 @@ struct DatePickerDialogExample01 {
}
```
### 日期滑动选择器（不显示农历）示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct DatePickerDialogExample02 {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-methods-menu.md b/zh-cn/application-dev/reference/arkui-ts/ts-methods-menu.md
index df97249f6d38576b79f604df4aab7d277c7118f9..3e832dee2c127cdec7d5160e4cc9737a5aec885d 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-methods-menu.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-methods-menu.md
@@ -1,7 +1,8 @@
# 菜单
->  **说明：**
-> 从 API Version 8 开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+> **说明：**
+>
+> 从 API Version 8 开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
## ContextMenu.close
@@ -9,31 +10,32 @@ close(): void
可以通过该方法在页面范围内关闭通过[bindContextMenu](./ts-universal-attributes-menu.md#属性)给组件绑定的菜单。
-- 示例
- ```
- @Entry
- @Component
- struct Index {
- @Builder MenuBuilder(){
- Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
- Text('close')
- .fontSize(30)
- .fontWeight(FontWeight.Bold)
- .onClick(() => {
- ContextMenu.close();
- })
- }.height(400)
- .backgroundColor(Color.Pink)
-
- }
- build() {
- Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Start, justifyContent: FlexAlign.Start }) {
- Column(){
- Text("Text")
- }.bindContextMenu(this.MenuBuilder, ResponseType.LongPress)
- }
- .width('100%')
- .height('100%')
+**示例：**
+
+```
+@Entry
+@Component
+struct Index {
+ @Builder MenuBuilder(){
+ Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
+ Text('close')
+ .fontSize(30)
+ .fontWeight(FontWeight.Bold)
+ .onClick(() => {
+ ContextMenu.close();
+ })
+ }.height(400)
+ .backgroundColor(Color.Pink)
+
+ }
+ build() {
+ Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Start, justifyContent: FlexAlign.Start }) {
+ Column(){
+ Text("Text")
+ }.bindContextMenu(this.MenuBuilder, ResponseType.LongPress)
}
+ .width('100%')
+ .height('100%')
}
- ```
+}
+```
\ No newline at end of file
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md b/zh-cn/application-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md
index b9c0e9cd7a1a410f2509f6ceb719820272d1c90f..21085f27e61f40bed7568fae682e820dad77cb9f 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md
@@ -1,6 +1,6 @@
# 文本滑动选择器弹窗
->  **说明：**
+> **说明：**
> 该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
根据指定的选择范围创建文本选择器，展示在弹窗上。
@@ -33,7 +33,8 @@ show(options: TextPickerDialogOptions)
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct TextPickerDialogExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-methods-timepicker-dialog.md b/zh-cn/application-dev/reference/arkui-ts/ts-methods-timepicker-dialog.md
index 073e84113a50767dab0a84a294b0ceb45e4faa91..2917d91350b4fd82e62f3a2c1092827f452f7c2d 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-methods-timepicker-dialog.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-methods-timepicker-dialog.md
@@ -1,6 +1,6 @@
# 时间滑动选择器弹窗
->  **说明：**
+> **说明：**
> 该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
默认以00：00至23：59的时间区间创建滑动选择器，展示在弹窗上。
@@ -27,7 +27,8 @@ show(options?: TimePickerDialogOptions)
## 示例
### 时间滑动选择器（24小时制）示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct TimePickerDialogExample01 {
@@ -55,7 +56,8 @@ struct TimePickerDialogExample01 {
}
```
### 时间滑动选择器（12小时制）示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct TimePickerDialogExample02 {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-motion-path-animation.md b/zh-cn/application-dev/reference/arkui-ts/ts-motion-path-animation.md
index 82a6b6a35aa076ddd43098bb09048e7405871ec0..022e2efe6d9466d14d21ec81d0d3dbbeeafefd57 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-motion-path-animation.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-motion-path-animation.md
@@ -1,6 +1,6 @@
# 路径动画
->  **说明：**
+> **说明：**
> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
@@ -11,12 +11,13 @@
| 名称 | 参数类型 | 默认值 | 描述 |
| -------- | -------- | -------- | -------- |
-| motionPath | {
path: string,
from?: number,
to?: number,
rotatable?: boolean
}
>  **说明：**
> path中支持通过start和end进行起点和终点的替代，如：
>
> 'Mstart.x start.y L50 50 Lend.x end.y Z'。 | {
"",
0.0,
1.0,
false
} | 设置组件的运动路径，入参说明如下：
- path：位移动画的运动路径，使用svg路径字符串。
- from：运动路径的起点，默认为0.0。
- to：运动路径的终点，默认为1.0。
- rotatable：是否跟随路径进行旋转。 |
+| motionPath | {
path: string,
from?: number,
to?: number,
rotatable?: boolean
}
> **说明：**
> path中支持通过start和end进行起点和终点的替代，如：
>
> 'Mstart.x start.y L50 50 Lend.x end.y Z'。 | {
"",
0.0,
1.0,
false
} | 设置组件的运动路径，入参说明如下：
- path：位移动画的运动路径，使用svg路径字符串。
- from：运动路径的起点，默认为0.0。
- to：运动路径的终点，默认为1.0。
- rotatable：是否跟随路径进行旋转。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct MotionPathExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-offscreencanvasrenderingcontext2d.md b/zh-cn/application-dev/reference/arkui-ts/ts-offscreencanvasrenderingcontext2d.md
index 065c59e0d43cf97c45b5d8aac131805a64b1bb1d..f62674077b93bb96247757fbbdd6d202fdbd3e39 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-offscreencanvasrenderingcontext2d.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-offscreencanvasrenderingcontext2d.md
@@ -1,6 +1,6 @@
# OffscreenCanvasRenderingContext2D对象
->  **说明：**
+> **说明：**
> 从 API Version 8 开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
@@ -30,7 +30,7 @@ OffscreenCanvasRenderingContext2D(width: number, height: number, setting: Render
| [lineJoin](#linejoin) | string | 'miter' | 指定线段间相交的交点样式，可选值为：
- 'round'：在线段相连处绘制一个扇形，扇形的圆角半径是线段的宽度。
- 'bevel'：在线段相连处使用三角形为底填充， 每个部分矩形拐角独立。
- 'miter'：在相连部分的外边缘处进行延伸，使其相交于一点，形成一个菱形区域，该属性可以通过设置miterLimit属性展现效果。 |
| [miterLimit](#miterlimit) | number | 10 | 设置斜接面限制值，该值指定了线条相交处内角和外角的距离。 |
| [font](#font) | string | 'normal normal 14px sans-serif' | 设置文本绘制中的字体样式。
语法：ctx.font='font-size font-family'
- font-size(可选)，指定字号和行高，单位只支持px。
- font-family(可选)，指定字体系列。
语法：ctx.font='font-style font-weight font-size font-family'
- font-style(可选)，用于指定字体样式，支持如下几种样式：'normal', 'italic'。
- font-weight(可选)，用于指定字体的粗细，支持如下几种类型：'normal', 'bold', 'bolder', 'lighter', 100, 200, 300, 400, 500, 600, 700, 800, 900。
- font-size(可选)，指定字号和行高，单位只支持px。
- font-family(可选)，指定字体系列，支持如下几种类型：'sans-serif', 'serif', 'monospace'。 |
-| [textAlign](#textalign) | string | 'left' | 设置文本绘制中的文本对齐方式，可选值为：
- 'left'：文本左对齐。
- 'right'：文本右对齐。
- 'center'：文本居中对齐。
- 'start'：文本对齐界线开始的地方。
- 'end'：文本对齐界线结束的地方。
>  **说明：**
> ltr布局模式下start和left一致，rtl布局模式下start和right一致·。 |
+| [textAlign](#textalign) | string | 'left' | 设置文本绘制中的文本对齐方式，可选值为：
- 'left'：文本左对齐。
- 'right'：文本右对齐。
- 'center'：文本居中对齐。
- 'start'：文本对齐界线开始的地方。
- 'end'：文本对齐界线结束的地方。
> **说明：**
> ltr布局模式下start和left一致，rtl布局模式下start和right一致·。 |
| [textBaseline](#textbaseline) | string | 'alphabetic' | 设置文本绘制中的水平对齐方式，可选值为：
- 'alphabetic'：文本基线是标准的字母基线。
- 'top'：文本基线在文本块的顶部。
- 'hanging'：文本基线是悬挂基线。
- 'middle'：文本基线在文本块的中间。
- 'ideographic'：文字基线是表意字基线；如果字符本身超出了alphabetic基线，那么ideograhpic基线位置在字符本身的底部。
- 'bottom'：文本基线在文本块的底部。 与ideographic基线的区别在于ideographic 基线不需要考虑下行字母。 |
| [globalAlpha](#globalalpha) | number | - | 设置透明度，0.0为完全透明，1.0为完全不透明。 |
| [lineDashOffset](#linedashoffset) | number | 0.0 | 设置画布的虚线偏移量，精度为float。 |
@@ -42,13 +42,14 @@ OffscreenCanvasRenderingContext2D(width: number, height: number, setting: Render
| [imageSmoothingEnabled](#imagesmoothingenabled) | boolean | true | 用于设置绘制图片时是否进行图像平滑度调整，true为启用，false为不启用。 |
| imageSmoothingQuality | string | 'low' | 用于设置图像平滑度，支持如下三种类型：'low', 'medium', 'high'。 |
->  **说明：**
+> **说明：**
> <color>类型格式为 'rgb(255, 255, 255)'，'rgba(255, 255, 255, 1.0)'，'\#FFFFFF'。
### fillStyle
-```
+```ts
+// xxx.ets
@Entry
@Component
struct FillStyleExample {
@@ -80,7 +81,8 @@ struct FillStyleExample {
### lineWidth
-```
+```ts
+// xxx.ets
@Entry
@Component
struct LineWidthExample {
@@ -112,7 +114,8 @@ struct LineWidthExample {
### strokeStyle
-```
+```ts
+// xxx.ets
@Entry
@Component
struct StrokeStyleExample {
@@ -146,7 +149,8 @@ struct StrokeStyleExample {
### lineCap
-```
+```ts
+// xxx.ets
@Entry
@Component
struct LineCapExample {
@@ -182,7 +186,8 @@ struct LineCapExample {
### lineJoin
-```
+```ts
+// xxx.ets
@Entry
@Component
struct LineJoinExample {
@@ -219,7 +224,8 @@ struct LineJoinExample {
### miterLimit
-```
+```ts
+// xxx.ets
@Entry
@Component
struct MiterLimit {
@@ -256,7 +262,8 @@ struct MiterLimit {
### font
-```
+```ts
+// xxx.ets
@Entry
@Component
struct Fonts {
@@ -288,7 +295,8 @@ struct Fonts {
### textAlign
-```
+```ts
+// xxx.ets
@Entry
@Component
struct CanvasExample {
@@ -335,7 +343,8 @@ struct CanvasExample {
### textBaseline
-```
+```ts
+// xxx.ets
@Entry
@Component
struct TextBaseline {
@@ -382,7 +391,8 @@ struct TextBaseline {
### globalAlpha
-```
+```ts
+// xxx.ets
@Entry
@Component
struct GlobalAlpha {
@@ -417,7 +427,8 @@ struct GlobalAlpha {
### lineDashOffset
-```
+```ts
+// xxx.ets
@Entry
@Component
struct LineDashOffset {
@@ -464,7 +475,8 @@ struct LineDashOffset {
| copy | 显示新绘制内容而忽略现有绘制内容。 |
| xor | 使用异或操作对新绘制内容与现有绘制内容进行融合。 |
-```
+```ts
+// xxx.ets
@Entry
@Component
struct GlobalCompositeOperation {
@@ -504,7 +516,8 @@ struct GlobalCompositeOperation {
### shadowBlur
-```
+```ts
+// xxx.ets
@Entry
@Component
struct ShadowBlur {
@@ -538,7 +551,8 @@ struct ShadowBlur {
### shadowColor
-```
+```ts
+// xxx.ets
@Entry
@Component
struct ShadowColor {
@@ -573,7 +587,8 @@ struct ShadowColor {
### shadowOffsetX
-```
+```ts
+// xxx.ets
@Entry
@Component
struct ShadowOffsetX {
@@ -608,7 +623,8 @@ struct ShadowOffsetX {
### shadowOffsetY
-```
+```ts
+// xxx.ets
@Entry
@Component
struct ShadowOffsetY {
@@ -643,7 +659,8 @@ struct ShadowOffsetY {
### imageSmoothingEnabled
-```
+```ts
+// xxx.ets
@Entry
@Component
struct ImageSmoothingEnabled {
@@ -1648,7 +1665,7 @@ transform(scaleX: number, skewX: number, skewY: number, scaleY: number, translat
transform方法对应一个变换矩阵，想对一个图形进行变化的时候，只要设置此变换矩阵相应的参数，对图形的各个定点的坐标分别乘以这个矩阵，就能得到新的定点的坐标。矩阵变换效果可叠加。
->  **说明：**
+> **说明：**
> 变换后的坐标计算方式（x和y为变换前坐标，x'和y'为变换后坐标）：
>
> - x' = scaleX \* x + skewY \* y + translateX
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-page-transition-animation.md b/zh-cn/application-dev/reference/arkui-ts/ts-page-transition-animation.md
index 6c2933272d3a0e90b99bf3eb687cc736fa4a113a..1c7595fe804ee158e8f87dc050835f8758df2c3b 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-page-transition-animation.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-page-transition-animation.md
@@ -1,6 +1,6 @@
# 页面间转场
->  **说明：**
+> **说明：**
> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-component.md b/zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-component.md
index cf0b35935cccc4d96d4b21a723664ba2e2b5ddd7..15650d25328004d44a47b8cafb8bc4cc06e11ae9 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-component.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-component.md
@@ -1,6 +1,6 @@
# 组件内转场
->  **说明：**
+> **说明：**
> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
@@ -16,7 +16,7 @@
- transition入参说明
| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
| -------- | -------- | -------- | -------- | -------- |
- | type | TransitionType | TransitionType.All | 否 | 默认包括组件新增和删除。
>  **说明：**
> 不指定Type时说明插入删除使用同一种效果。 |
+ | type | TransitionType | TransitionType.All | 否 | 默认包括组件新增和删除。
> **说明：**
> 不指定Type时说明插入删除使用同一种效果。 |
| opacity | number | 1 | 否 | 设置组件转场时的透明度效果，为插入时起点和删除时终点的值。 |
| translate | {
x? : number,
y? : number,
z? : number
} | - | 否 | 设置组件转场时的平移效果，为插入时起点和删除时终点的值。 |
| scale | {
x? : number,
y? : number,
z? : number,
centerX? : number,
centerY? : number
} | - | 否 | 设置组件转场时的缩放效果，为插入时起点和删除时终点的值。 |
@@ -34,7 +34,8 @@
示例功能通过一个Button控制第二个Button的出现和消失，并通过transition配置第二个Button出现和消失的过场动画。
-```
+```ts
+// xxx.ets
@Entry
@Component
struct TransitionExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-shared-elements.md b/zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-shared-elements.md
index 57ebdcd0567bb63066f95db82d19910bae33c75c..06e889473736a080f28dc92523efcbea2d0f6099 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-shared-elements.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-shared-elements.md
@@ -1,6 +1,6 @@
# 共享元素转场
->  **说明：**
+> **说明：**
> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
@@ -25,7 +25,8 @@
示例功能为两个页面，共享元素转场页面图片点击后转场至页面B的图片。
-```
+```ts
+// xxx.ets
@Entry
@Component
struct SharedTransitionExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-background.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-background.md
index 12b9c249fc0b3488240d5dcac36766867b0daa96..123824d1a5deba3e49c73e5986e905dde35956db 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-background.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-background.md
@@ -1,6 +1,6 @@
# 背景设置
->  **说明：**
+> **说明：**
> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
@@ -33,7 +33,8 @@
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct BackgroundExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-border.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-border.md
index add589fa8e92a1946bfbbb4d232e8bc1226a5970..d5a4caf31865e7f87f4f7c370d787bc96cd5f516 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-border.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-border.md
@@ -1,6 +1,6 @@
# 边框设置
->  **说明：**
+> **说明：**
> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
@@ -34,7 +34,8 @@
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct BorderExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-click.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-click.md
index 2f62426bd2ff18c88ae86ba0ab58eeddd93fd99d..f4f688c4c3920a669da4b41e4ecbc39bceab8c96 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-click.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-click.md
@@ -1,6 +1,6 @@
# 点击控制
->  **说明：**
+> **说明：**
> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
@@ -19,7 +19,8 @@
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct TouchAbleExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-enable.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-enable.md
index b3939fe73d40d7bdc9aa1616497cd14829ef412d..3c891de4cdd5a799a6301fb0fb654332c07116dc 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-enable.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-enable.md
@@ -1,6 +1,6 @@
# 禁用控制
->  **说明：**
+> **说明：**
> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
@@ -19,7 +19,8 @@
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct EnabledExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-flex-layout.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-flex-layout.md
index ae6ce5b46ecfba98a33c852e996d3050552454aa..9cb57983343423c9e5b4376d00dc7fc4489d4d1e 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-flex-layout.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-flex-layout.md
@@ -1,6 +1,6 @@
# Flex布局
->  **说明：**
+> **说明：**
> - 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
>
> - 仅当父组件是Flex组件时生效。
@@ -24,7 +24,8 @@
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct FlexExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-focus.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-focus.md
index e6ed56978e3cbcb1fe41101ece127d0f09b40cce..0748f2a9cd61aa6c5bd468fbc6a74d11958a2ac0 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-focus.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-focus.md
@@ -1,6 +1,6 @@
# 焦点控制
->  **说明：**
+> **说明：**
> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
@@ -15,13 +15,14 @@
| -------- | -------- | -------- | -------- |
| focusable | boolean | false | 设置当前组件是否可以获焦。 |
->  **说明：**
+> **说明：**
> 支持焦点控制的组件：Button、Text、Image、List、Grid。
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct FocusableExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-gradient-color.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-gradient-color.md
index bfa90330fb746ec3a6bbd76371c1963bd0fe6b77..e71af0022d870bb9b803f9cdf952be61c37ae345 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-gradient-color.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-gradient-color.md
@@ -1,6 +1,6 @@
# 颜色渐变
->  **说明：**
+> **说明：**
> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
@@ -37,7 +37,8 @@
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct ColorGradientExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-grid.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-grid.md
index 6237d39f4e76c11657955fea6fb7fe6e6f136aa5..47a956ac210309c8dce276dc83ab8b228fadcaed 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-grid.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-grid.md
@@ -1,6 +1,6 @@
# 栅格设置
->  **说明：**
+> **说明：**
> - 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
>
> - 栅格布局的列宽、列间距由距离最近的GridContainer父组件决定。使用栅格属性的组件树上至少需要有1个GridContainer容器组件。
@@ -17,13 +17,14 @@
| 名称 | 参数类型 | 默认值 | 描述 |
| -------- | -------- | -------- | -------- |
| useSizeType | {
xs?: number \| { span: number, offset: number },
sm?: number \| { span: number, offset: number },
md?: number \| { span: number, offset: number },
lg?: number \| { span: number, offset: number }
} | - | 设置在特定设备宽度类型下的占用列数和偏移列数，span: 占用列数; offset: 偏移列数。
当值为number类型时，仅设置列数， 当格式如{"span": 1, "offset": 0}时，指同时设置占用列数与偏移列数。
- xs: 指设备宽度类型为SizeType.XS时的占用列数和偏移列数。
- sm: 指设备宽度类型为SizeType.SM时的占用列数和偏移列数。
- md: 指设备宽度类型为SizeType.MD时的占用列数和偏移列数。
- lg: 指设备宽度类型为SizeType.LG时的占用列数和偏移列数。 |
-| gridSpan | number | 1 | 默认占用列数，指useSizeType属性没有设置对应尺寸的列数（span)时，占用的栅格列数。
>  **说明：**
> 设置了栅格span属性，组件的宽度由栅格布局决定。 |
-| gridOffset | number | 0 | 默认偏移列数，指useSizeType属性没有设置对应尺寸的偏移(offset)时， 当前组件沿着父组件Start方向，偏移的列数，也就是当前组件位于第n列。
>  **说明：**
> -配置该属性后，当前组件在父组件水平方向的布局不再跟随父组件原有的布局方式，而是沿着父组件的Start方向偏移一定位移。
> -偏移位移 = （列宽 + 间距）\* 列数。
> -设置了偏移(gridOffset)的组件之后的兄弟组件会根据该组件进行相对布局，类似相对布局。 |
+| gridSpan | number | 1 | 默认占用列数，指useSizeType属性没有设置对应尺寸的列数（span)时，占用的栅格列数。
> **说明：**
> 设置了栅格span属性，组件的宽度由栅格布局决定。 |
+| gridOffset | number | 0 | 默认偏移列数，指useSizeType属性没有设置对应尺寸的偏移(offset)时， 当前组件沿着父组件Start方向，偏移的列数，也就是当前组件位于第n列。
> **说明：**
> -配置该属性后，当前组件在父组件水平方向的布局不再跟随父组件原有的布局方式，而是沿着父组件的Start方向偏移一定位移。
> -偏移位移 = （列宽 + 间距）\* 列数。
> -设置了偏移(gridOffset)的组件之后的兄弟组件会根据该组件进行相对布局，类似相对布局。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct GridContainerExample1 {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-hover-effect.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-hover-effect.md
index 796b92a921c929133d6c1f9adec13f2b0f78dcce..5ff1536cc78f199d202aa3bcb207df5656930f42 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-hover-effect.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-hover-effect.md
@@ -1,6 +1,6 @@
# 悬浮态效果
->  **说明：**
+> **说明：**
> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
@@ -26,7 +26,8 @@
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct HoverExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-image-effect.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-image-effect.md
index 8e67fd5f1e9f076ac59c5f50f977626173be5675..dbb474ba4289020a0c0676bb040b5ae2ff6ee529 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-image-effect.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-image-effect.md
@@ -1,6 +1,6 @@
# 图像效果
->  **说明：**
+> **说明：**
> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
@@ -29,7 +29,8 @@
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct ImageEffectsExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-layout-constraints.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-layout-constraints.md
index 7f267aac3beda6f6a373fb0183922e512f3657c8..23a1f4329db73c2f9b262e2f56f49239d331df8c 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-layout-constraints.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-layout-constraints.md
@@ -1,6 +1,6 @@
# 布局约束
->  **说明：**
+> **说明：**
> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
@@ -15,12 +15,13 @@
| 名称 | 参数说明 | 默认值 | 描述 |
| -------- | -------- | -------- | -------- |
| aspectRatio | number | - | 指定当前组件的宽高比。 |
-| displayPriority | number | - | 设置当前组件在布局容器中显示的优先级，当父容器空间不足时，低优先级的组件会被隐藏。
>  **说明：**
> 仅在Row/Column/Flex(单行)容器组件中生效。 |
+| displayPriority | number | - | 设置当前组件在布局容器中显示的优先级，当父容器空间不足时，低优先级的组件会被隐藏。
> **说明：**
> 仅在Row/Column/Flex(单行)容器组件中生效。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct AspectRatioExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-location.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-location.md
index ac65f17a241863ab26b65f9c4a0c217e38d5826f..34af6dbbc7333150cc4e0dd1e53087e9132c663a 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-location.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-location.md
@@ -1,7 +1,8 @@
# 位置设置
->  **说明：**
-> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+> **说明：**
+>
+> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
## 权限列表
@@ -12,26 +13,26 @@
## 属性
-| 名称 | 参数类型 | 默认值 | 描述 |
-| -------- | -------- | -------- | -------- |
-| align | [Alignment](ts-appendix-enums.md#alignment枚举说明) | Center | 设置元素内容的对齐方式，只有当设置的width和height大小超过元素本身内容大小时生效。 |
-| direction | Direction | Auto | 设置元素水平方向的布局，可选值参照Direction枚举说明。 |
-| position | {
x: Length,
y: Length
} | - | 使用绝对定位，设置元素锚点相对于父容器顶部起点偏移位置。在布局容器中，设置该属性不影响父容器布局，仅在绘制时进行位置调整。 |
-| markAnchor | {
x: Length,
y: Length
} | {
x: 0,
y: 0
} | 设置元素在位置定位时的锚点，以元素顶部起点作为基准点进行偏移。 |
-| offset | {
x: Length,
y: Length
} | {
x: 0,
y: 0
} | 相对布局完成位置坐标偏移量，设置该属性，不影响父容器布局，仅在绘制时进行位置调整。 |
+| 名称 | 参数类型 | 默认值 | 描述 |
+| ---------- | ---------------------------------------- | ------------------------------------ | ---------------------------------------- |
+| align | [Alignment](ts-appendix-enums.md#alignment枚举说明) | Center | 设置元素内容的对齐方式，只有当设置的width和height大小超过元素本身内容大小时生效。 |
+| direction | Direction | Auto | 设置元素水平方向的布局，可选值参照Direction枚举说明。 |
+| position | {
x: Length,
y: Length
} | - | 使用绝对定位，设置元素锚点相对于父容器顶部起点偏移位置。在布局容器中，设置该属性不影响父容器布局，仅在绘制时进行位置调整。 |
+| markAnchor | {
x: Length,
y: Length
} | {
x: 0,
y: 0
} | 设置元素在位置定位时的锚点，以元素顶部起点作为基准点进行偏移。 |
+| offset | {
x: Length,
y: Length
} | {
x: 0,
y: 0
} | 相对布局完成位置坐标偏移量，设置该属性，不影响父容器布局，仅在绘制时进行位置调整。 |
+## Direction枚举说明
-- Direction枚举说明
- | 名称 | 描述 |
- | -------- | -------- |
- | Ltr | 元素从左到右布局。 |
- | Rtl | 元素从右到左布局。 |
- | Auto | 使用系统默认布局方向。 |
-
+| 名称 | 描述 |
+| ---- | ----------- |
+| Ltr | 元素从左到右布局。 |
+| Rtl | 元素从右到左布局。 |
+| Auto | 使用系统默认布局方向。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct PositionExample {
@@ -64,7 +65,8 @@ struct PositionExample {
-```
+```ts
+// xxx.ets
@Entry
@Component
struct PositionExample2 {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-menu.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-menu.md
index 71c1273bb276dca02d9708a0bbd85601c98f1a31..3c15bdf0786afe6f1bede9a05f815c726e8272b5 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-menu.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-menu.md
@@ -1,7 +1,8 @@
# Menu控制
->  **说明：**
-> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+> **说明：**
+>
+> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
## 权限列表
@@ -12,29 +13,31 @@
## 属性
-| 名称 | 参数类型 | 默认值 | 描述 |
-| -------- | -------- | -------- | -------- |
-| bindMenu | Array
responseType: ResponseType | - | 给组件绑定菜单，触发方式为长按或者右键点击，弹出菜单项需要自定义。 |
+| 名称 | 参数类型 | 默认值 | 描述 |
+| ---------------------------- | ---------------------------------------- | ---- | ---------------------------------- |
+| bindMenu | Array
responseType: ResponseType | - | 给组件绑定菜单，触发方式为长按或者右键点击，弹出菜单项需要自定义。 |
+## MenuItem
-- MenuItem
- | 名称 | 类型 | 描述 |
- | -------- | -------- | -------- |
- | value | string | 菜单项文本。 |
- | action | () => void | 点击菜单项的事件回调。 |
+| 名称 | 类型 | 描述 |
+| ------ | ----------------------- | ----------- |
+| value | string | 菜单项文本。 |
+| action | () => void | 点击菜单项的事件回调。 |
-- ResponseType8+
- | 参数值 | 描述 |
- | -------- | -------- |
- | LongPress | 通过长按触发菜单弹出。 |
- | RightClick | 通过鼠标右键触发菜单弹出。 |
+## ResponseType8+
+
+| 参数值 | 描述 |
+| ---------- | ------------- |
+| LongPress | 通过长按触发菜单弹出。 |
+| RightClick | 通过鼠标右键触发菜单弹出。 |
## 示例
#### 普通菜单
-```
+```ts
+// xxx.ets
@Entry
@Component
struct MenuExample {
@@ -116,7 +119,8 @@ struct MenuExample {
#### 菜单(右键触发显示)
-```
+```ts
+// xxx.ets
@Entry
@Component
struct ContextMenuExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-opacity.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-opacity.md
index bba65d744a27c56232b24f55b1fb46b29709d666..44e5d0785420e0b501daee22dcb22b20ad1a548f 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-opacity.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-opacity.md
@@ -1,11 +1,11 @@
# 透明度设置
->  **说明：**
-> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
-
-
设置组件的透明度。
+> **说明：**
+>
+> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+
## 权限列表
@@ -15,14 +15,15 @@
## 属性
-| 名称 | 参数类型 | 默认值 | 描述 |
-| -------- | -------- | -------- | -------- |
-| opacity | number | 1 | 元素的不透明度，取值范围为0到1，1表示为不透明，0表示为完全透明。 |
+| 名称 | 参数类型 | 默认值 | 描述 |
+| ------- | ------ | ---- | ---------------------------------- |
+| opacity | number | 1 | 元素的不透明度，取值范围为0到1，1表示为不透明，0表示为完全透明。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct OpacityExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-overlay.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-overlay.md
index 45b00a1bdafd5018100d506adf76cf217180106f..9907f1f26810a35295e430592f344384f55a3195 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-overlay.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-overlay.md
@@ -1,7 +1,8 @@
# 浮层
->  **说明：**
-> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+> **说明：**
+>
+> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
## 权限列表
@@ -12,14 +13,15 @@
## 属性
-| 名称 | 参数类型 | 默认值 | 描述 |
-| -------- | -------- | -------- | -------- |
+| 名称 | 参数类型 | 默认值 | 描述 |
+| ------- | ---------------------------------------- | ---------------------------------------- | ------------------------ |
| overlay | title: string,
options: {
align?: [Alignment](ts-appendix-enums.md#alignment枚举说明),
offset?: {x: number, y: number}
} | {
align: Alignment.Center,
offset: {0, 0}
} | 在当前组件上，增加遮罩文本，布局与当前组件相同。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct OverlayExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-polymorphic-style.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-polymorphic-style.md
index 02941dc6bccbf1e0c8429e1aa69b0a22f2d30d43..44c2a17684ecdd23ab19b72b29f4699d354b8f1a 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-polymorphic-style.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-polymorphic-style.md
@@ -1,7 +1,7 @@
# 多态样式
->  **说明：**
-> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+> **说明：**
+> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
设置组件不同状态下的样式。
@@ -14,21 +14,22 @@
## 属性
-| 名称 | 参数类型 | 默认值 | 描述 |
-| -------- | -------- | -------- | -------- |
-| stateStyles | StateStyles | - | 设置组件不同状态的样式。 |
+| 名称 | 参数类型 | 默认值 | 描述 |
+| ----------- | ----------- | ---- | ------------ |
+| stateStyles | StateStyles | - | 设置组件不同状态的样式。 |
-- StateStyles接口说明
- | 名称 | 类型 | 必填 | 默认值 | 描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | normal | ()=>void | 否 | - | 组件无状态时的样式。 |
- | pressed | ()=>void | 否 | - | 组件按下状态的样式。 |
- | disabled | ()=>void | 否 | - | 组件禁用状态的样式。 |
+## StateStyles接口说明
+| 名称 | 类型 | 必填 | 默认值 | 描述 |
+| -------- | ----------- | ---- | ---- | ---------- |
+| normal | ()=>void | 否 | - | 组件无状态时的样式。 |
+| pressed | ()=>void | 否 | - | 组件按下状态的样式。 |
+| disabled | ()=>void | 否 | - | 组件禁用状态的样式。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct StyleExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-popup.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-popup.md
index a26b8137956befec8e1153e987e4fb49998f88c4..1cadac8e50e9e6865e7e4c40e6da6c0ad50d8d95 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-popup.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-popup.md
@@ -1,7 +1,8 @@
# Popup控制
->  **说明：**
-> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+> **说明：**
+>
+> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
## 权限列表
@@ -12,47 +13,49 @@
## 属性
-| 名称 | 参数类型 | 默认值 | 描述 |
-| -------- | -------- | -------- | -------- |
-| bindPopup | show: boolean,
popup: PopupOptions\| CustomPopupOptions | - | 给组件绑定Popup，点击弹出弹窗。
show: 创建页面弹窗提示是否默认显示，默认值为false。
popup: 配置当前弹窗提示的参数。 |
-
-
-- PopupOptions类型接口说明
- | 名称 | 类型 | 必填 | 默认值 | 描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | message | string | 是 | - | 弹窗信息内容。 |
- | placementOnTop | boolean | 否 | false | 是否在组件上方显示，默认值为false。 |
- | primaryButton | {
value: string,
action: () => void
} | 否 | - | 第一个按钮。
value: 弹窗里主按钮的文本。
action: 点击主按钮的回调函数。 |
- | secondaryButton | {
value: string,
action: () => void
} | 否 | - | 第二个按钮。
value: 弹窗里辅助按钮的文本。
action: 点击辅助按钮的回调函数。 |
- | onStateChange | (isVisible: boolean) => void | 否 | - | 弹窗状态变化事件回调，参数isVisible为弹窗当前的显示状态。 |
-
-- CustomPopupOptions8+类型接口说明
- | 名称 | 类型 | 必填 | 默认值 | 描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | builder | () => any | 是 | - | 提示气泡内容的构造器。 |
- | placement | Placement | 否 | Placement.Bottom | 气泡组件优先显示的位置，当前位置显示不下时，会自动调整位置。 |
- | maskColor | [Color](../../ui/ts-types.md#颜色类型) | 否 | - | 提示气泡遮障层的颜色。 |
- | popupColor | [Color](../../ui/ts-types.md#颜色类型) | 否 | - | 提示气泡的颜色。 |
- | enableArrow | boolean | 否 | true | 是否显示箭头，只有上、下方向的气泡会显示箭头。 |
- | autoCancel | boolean | 否 | true | 页面有操作时，是否自动关闭气泡 |
- | onStateChange | (isVisible: boolean) => void | 否 | - | 弹窗状态变化事件回调，参数为弹窗当前的显示状态。 |
-
-- Placement8+枚举说明
- | 名称 | 描述 |
- | -------- | -------- |
- | Left | 气泡提示位于组件左侧。 |
- | Right | 气泡提示位于组件右侧。 |
- | Top | 气泡提示位于组件上侧。 |
- | Bottom | 气泡提示位于组件下侧。 |
- | TopLeft | 气泡提示位于组件左上角。 |
- | TopRight | 气泡提示位于组件右上角。 |
- | BottomLeft | 气泡提示位于组件左下角。 |
- | BottomRight | 气泡提示位于组件右下角。 |
-
+| 名称 | 参数类型 | 默认值 | 描述 |
+| --------- | ---------------------------------------- | ---- | ---------------------------------------- |
+| bindPopup | show: boolean,
popup: PopupOptions\| CustomPopupOptions | - | 给组件绑定Popup，点击弹出弹窗。
show: 创建页面弹窗提示是否默认显示，默认值为false。
popup: 配置当前弹窗提示的参数。 |
+
+## PopupOptions类型接口说明
+
+| 名称 | 类型 | 必填 | 默认值 | 描述 |
+| --------------- | ---------------------------------------- | ---- | ----- | ---------------------------------------- |
+| message | string | 是 | - | 弹窗信息内容。 |
+| placementOnTop | boolean | 否 | false | 是否在组件上方显示，默认值为false。 |
+| primaryButton | {
value: string,
action: () => void
} | 否 | - | 第一个按钮。
value: 弹窗里主按钮的文本。
action: 点击主按钮的回调函数。 |
+| secondaryButton | {
value: string,
action: () => void
} | 否 | - | 第二个按钮。
value: 弹窗里辅助按钮的文本。
action: 点击辅助按钮的回调函数。 |
+| onStateChange | (isVisible: boolean) => void | 否 | - | 弹窗状态变化事件回调，参数isVisible为弹窗当前的显示状态。 |
+
+## CustomPopupOptions8+类型接口说明
+
+| 名称 | 类型 | 必填 | 默认值 | 描述 |
+| ------------- | ---------------------------------------- | ---- | ---------------- | ------------------------------ |
+| builder | () => any | 是 | - | 提示气泡内容的构造器。 |
+| placement | Placement | 否 | Placement.Bottom | 气泡组件优先显示的位置，当前位置显示不下时，会自动调整位置。 |
+| maskColor | [Color](../../ui/ts-types.md#颜色类型) | 否 | - | 提示气泡遮障层的颜色。 |
+| popupColor | [Color](../../ui/ts-types.md#颜色类型) | 否 | - | 提示气泡的颜色。 |
+| enableArrow | boolean | 否 | true | 是否显示箭头，只有上、下方向的气泡会显示箭头。 |
+| autoCancel | boolean | 否 | true | 页面有操作时，是否自动关闭气泡 |
+| onStateChange | (isVisible: boolean) => void | 否 | - | 弹窗状态变化事件回调，参数为弹窗当前的显示状态。 |
+
+## Placement8+枚举说明
+
+| 名称 | 描述 |
+| ----------- | ------------ |
+| Left | 气泡提示位于组件左侧。 |
+| Right | 气泡提示位于组件右侧。 |
+| Top | 气泡提示位于组件上侧。 |
+| Bottom | 气泡提示位于组件下侧。 |
+| TopLeft | 气泡提示位于组件左上角。 |
+| TopRight | 气泡提示位于组件右上角。 |
+| BottomLeft | 气泡提示位于组件左下角。 |
+| BottomRight | 气泡提示位于组件右下角。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct PopupExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-size.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-size.md
index cb6e258fb771a93e1ea13c04f5f70c55ae477ac7..eec98e9ba2cf6dadcdcd077c42f9b9bb5ae2e1f4 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-size.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-size.md
@@ -1,7 +1,8 @@
# 尺寸设置
->  **说明：**
-> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+> **说明：**
+>
+> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
## 权限列表
@@ -12,20 +13,21 @@
## 属性
-| 名称 | 参数说明 | 默认值 | 描述 |
-| -------- | -------- | -------- | -------- |
-| width | Length | - | 设置组件自身的宽度，缺省时使用元素自身内容需要的宽度。 |
-| height | Length | - | 设置组件自身的高度，缺省时使用元素自身内容需要的高度。 |
-| size | {
width?: Length,
height?: Length
} | - | 设置高宽尺寸。 |
-| padding | {
top?: Length,
right?: Length,
bottom?: Length,
left?: Length
} \| Length | 0 | 设置内边距属性。
参数为Length类型时，四个方向内边距同时生效。 |
-| margin | {
top?: Length,
right?: Length,
bottom?: Length,
left?: Length
}
\| Length | 0 | 设置外边距属性。
参数为Length类型时，四个方向外边距同时生效。 |
-| constraintSize | {
minWidth?: Length,
maxWidth?: Length,
minHeight?: Length,
maxHeight?: Length
} | {
minWidth: 0,
maxWidth: Infinity,
minHeight: 0,
maxHeight: Infinity
} | 设置约束尺寸，组件布局时，进行尺寸范围限制。 |
-| layoutWeight | number | 0 | 容器尺寸确定时，元素与兄弟节点主轴布局尺寸按照权重进行分配，忽略本身尺寸设置。
>  **说明：**
> 仅在Row/Column/Flex布局中生效。 |
+| 名称 | 参数说明 | 默认值 | 描述 |
+| -------------- | ---------------------------------------- | ---------------------------------------- | ---------------------------------------- |
+| width | Length | - | 设置组件自身的宽度，缺省时使用元素自身内容需要的宽度。 |
+| height | Length | - | 设置组件自身的高度，缺省时使用元素自身内容需要的高度。 |
+| size | {
width?: Length,
height?: Length
} | - | 设置高宽尺寸。 |
+| padding | {
top?: Length,
right?: Length,
bottom?: Length,
left?: Length
} \| Length | 0 | 设置内边距属性。
参数为Length类型时，四个方向内边距同时生效。 |
+| margin | {
top?: Length,
right?: Length,
bottom?: Length,
left?: Length
}
\| Length | 0 | 设置外边距属性。
参数为Length类型时，四个方向外边距同时生效。 |
+| constraintSize | {
minWidth?: Length,
maxWidth?: Length,
minHeight?: Length,
maxHeight?: Length
} | {
minWidth: 0,
maxWidth: Infinity,
minHeight: 0,
maxHeight: Infinity
} | 设置约束尺寸，组件布局时，进行尺寸范围限制。 |
+| layoutWeight | number | 0 | 容器尺寸确定时，元素与兄弟节点主轴布局尺寸按照权重进行分配，忽略本身尺寸设置。
> **说明：**
> 仅在Row/Column/Flex布局中生效。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct SizeExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-text-style.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-text-style.md
index 920f40215e0a787c69bfad314c5d21d9989af9c0..be06da35986b7c6b065497bbfd8c5317fee93739 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-text-style.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-text-style.md
@@ -1,7 +1,8 @@
# 文本样式设置
->  **说明：**
-> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+> **说明：**
+>
+> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
针对包含文本元素的组件，设置文本样式。
@@ -15,36 +16,36 @@
## 属性
-| 名称 | 参数类型 | 默认值 | 描述 |
-| -------- | -------- | -------- | -------- |
-| fontColor | Color | - | 设置文本颜色。 |
-| fontSize | Length | - | 设置文本尺寸，Length为number类型时，使用fp单位。 |
-| fontStyle | FontStyle | FontStyle.Normal | 设置文本的字体样式。 |
+| 名称 | 参数类型 | 默认值 | 描述 |
+| ---------- | ------------------------ | --------------------------- | ---------------------------------------- |
+| fontColor | Color | - | 设置文本颜色。 |
+| fontSize | Length | - | 设置文本尺寸，Length为number类型时，使用fp单位。 |
+| fontStyle | FontStyle | FontStyle.Normal | 设置文本的字体样式。 |
| fontWeight | number \|FontWeight | FontWeight.FontWeightNormal | 设置文本的字体粗细，number类型取值[100, 900]，取值间隔为100，默认为400，取值越大，字体越粗。
提供常用枚举值，参考：FontWeight枚举说明。 |
-| fontFamily | string | - | 设置文本的字体列表。使用多个字体，使用','进行分割，优先级按顺序生效。例如：'Arial, sans-serif'。 |
+| fontFamily | string | - | 设置文本的字体列表。使用多个字体，使用','进行分割，优先级按顺序生效。例如：'Arial, sans-serif'。 |
+## FontStyle枚举说明
-- FontStyle枚举说明
- | 名称 | 描述 |
- | -------- | -------- |
- | Normal | 标准的字体样式。 |
- | Italic | 斜体的字体样式。 |
+| 名称 | 描述 |
+| ------ | -------- |
+| Normal | 标准的字体样式。 |
+| Italic | 斜体的字体样式。 |
+## FontWeight枚举说明
-- FontWeight枚举说明
- | 名称 | 描述 |
- | -------- | -------- |
- | Lighter | 字体较细。 |
- | Normal | 字体粗细正常。 |
- | Regular | 字体粗细正常。 |
- | Medium | 字体粗细适中。 |
- | Bold | 字体较粗。 |
- | Bolder | 字体非常粗。 |
-
+| 名称 | 描述 |
+| ------- | ------- |
+| Lighter | 字体较细。 |
+| Normal | 字体粗细正常。 |
+| Regular | 字体粗细正常。 |
+| Medium | 字体粗细适中。 |
+| Bold | 字体较粗。 |
+| Bolder | 字体非常粗。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct TextStyleExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-touch-target.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-touch-target.md
index 2af9b5be1fb516d1c58c40c7f4e949a6f9b0a6a7..2043171acbda94af034e0b4bac847e9a902ea05a 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-touch-target.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-touch-target.md
@@ -1,7 +1,8 @@
# 触摸热区设置
->  **说明：**
-> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+> **说明：**
+>
+> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
适用于支持通用点击事件、通用触摸事件、通用手势处理的组件。
@@ -15,26 +16,28 @@
## 属性
-| 名称 | 参数类型 | 默认值 | 描述 |
-| -------- | -------- | -------- | -------- |
-| responseRegion | Array<Rectangle> \| Rectangle | {
x：0,
y：0,
width：'100%',
height：'100%'
} | 设置一个或多个触摸热区，包括位置和大小。
>  **说明：**
> -百分比是相对于组件本身来度量的。
> -x和y可以设置正负值百分比。当x设置为'100%'时表示热区往右偏移组件本身宽度大小，当x设置为'-100%'时表示热区往左偏移组件本身宽度大小。当y设置为'100%'时表示热区往下偏移组件本身高度大小，当y设置为'-100%'时表示热区往上偏移组件本身高度大小。
> -width和height只能设置正值百分比。width：'100%'表示热区宽度设置为该组件本身的宽度。比如组件本身宽度是100vp，那么'100%'表示热区宽度也为100vp。height：'100%'表示热区高度设置为该组件本身的高度。 |
+| 名称 | 参数类型 | 默认值 | 描述 |
+| -------------- | ---------------------------------------- | ---------------------------------------- | ---------------------------------------- |
+| responseRegion | Array<Rectangle> \| Rectangle | {
x：0,
y：0,
width：'100%',
height：'100%'
} | 设置一个或多个触摸热区，包括位置和大小。
> **说明：**
> -百分比是相对于组件本身来度量的。
> -x和y可以设置正负值百分比。当x设置为'100%'时表示热区往右偏移组件本身宽度大小，当x设置为'-100%'时表示热区往左偏移组件本身宽度大小。当y设置为'100%'时表示热区往下偏移组件本身高度大小，当y设置为'-100%'时表示热区往上偏移组件本身高度大小。
> -width和height只能设置正值百分比。width：'100%'表示热区宽度设置为该组件本身的宽度。比如组件本身宽度是100vp，那么'100%'表示热区宽度也为100vp。height：'100%'表示热区高度设置为该组件本身的高度。 |
### Rectangle对象说明
- | 名称 | 类型 | 必填 | 默认值 | 描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | x | Length | 否 | 0vp | 触摸点相对于组件本身左边沿的X坐标。 |
- | y | Length | 否 | 0vp | 触摸点相对于组件本身左边沿的Y坐标。 |
- | width | Length | 否 | 100% | 触摸热区范围的宽度。 |
- | height | Length | 否 | 100% | 触摸热区范围的高度。 |
+| 名称 | 类型 | 必填 | 默认值 | 描述 |
+| ------ | ------ | ---- | ---- | ------------------ |
+| x | Length | 否 | 0vp | 触摸点相对于组件本身左边沿的X坐标。 |
+| y | Length | 否 | 0vp | 触摸点相对于组件本身左边沿的Y坐标。 |
+| width | Length | 否 | 100% | 触摸热区范围的宽度。 |
+| height | Length | 否 | 100% | 触摸热区范围的高度。 |
- >  **说明：**
- > 当x和y都设置为正值时，表示组件的触摸热区的范围整体往组件本身右下角偏移，偏移的大小可通过数值来设置。
+ > **说明：**
+ >
+ > 当x和y都设置为正值时，表示组件的触摸热区的范围整体往组件本身右下角偏移，偏移的大小可通过数值来设置。
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct ResponseRegionExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-transformation.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-transformation.md
index 78e95635f49d05622b97de4dc09816b34a24711a..a2ec21c5dee915412b71613772d90ee9bce6fb83 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-transformation.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-transformation.md
@@ -1,7 +1,8 @@
# 图形变换
->  **说明：**
-> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+> **说明：**
+>
+> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
## 权限列表
@@ -12,12 +13,12 @@
## 属性
-| 名称 | 参数类型 | 默认值 | 描述 |
-| -------- | -------- | -------- | -------- |
-| rotate | {
x?: number,
y?: number,
z?: number,
angle?: Angle,
centerX?: Length,
centerY?: Length
} | {
x: 0,
y: 0,
z: 0,
angle: 0,
centerX: '50%',
centerY: '50%'
} | (x, y, z)指定一个矢量，表示旋转轴，正角度为顺时针转动，负角度为逆时针转动，默认值为0，同时可以通过centerX和centerY设置旋转的中心点。 |
-| translate | {
x?: Length,
y?: Length,
z? : Length
} | {
x: 0,
y: 0,
z: 0
} | 可以分别设置X轴、Y轴、Z轴的平移距离，距离的正负控制平移的方向，默认值为0。 |
-| scale | {
x?: number,
y?: number,
z?: number,
centerX?: Length,
centerY?: Length
} | {
x: 1,
y: 1,
z: 1,
centerX:'50%',
centerY:'50%'
} | 可以分别设置X轴、Y轴、Z轴的缩放比例，默认值为1，同时可以通过centerX和centerY设置缩放的中心点。 |
-| transform | matrix: Matrix4 | - | 设置当前组件的变换矩阵。 |
+| 名称 | 参数类型 | 默认值 | 描述 |
+| --------- | ---------------------------------------- | ---------------------------------------- | ---------------------------------------- |
+| rotate | {
x?: number,
y?: number,
z?: number,
angle?: Angle,
centerX?: Length,
centerY?: Length
} | {
x: 0,
y: 0,
z: 0,
angle: 0,
centerX: '50%',
centerY: '50%'
} | (x, y, z)指定一个矢量，表示旋转轴，正角度为顺时针转动，负角度为逆时针转动，默认值为0，同时可以通过centerX和centerY设置旋转的中心点。 |
+| translate | {
x?: Length,
y?: Length,
z? : Length
} | {
x: 0,
y: 0,
z: 0
} | 可以分别设置X轴、Y轴、Z轴的平移距离，距离的正负控制平移的方向，默认值为0。 |
+| scale | {
x?: number,
y?: number,
z?: number,
centerX?: Length,
centerY?: Length
} | {
x: 1,
y: 1,
z: 1,
centerX:'50%',
centerY:'50%'
} | 可以分别设置X轴、Y轴、Z轴的缩放比例，默认值为1，同时可以通过centerX和centerY设置缩放的中心点。 |
+| transform | matrix: Matrix4 | - | 设置当前组件的变换矩阵。 |
## 示例
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-visibility.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-visibility.md
index 81aee8bf9c665433b40692aec2413d21ef307fbb..382b62cd008df59538d349180db0356ca25752b8 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-visibility.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-visibility.md
@@ -1,7 +1,8 @@
# 显隐控制
->  **说明：**
-> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+> **说明：**
+>
+> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
## 权限列表
@@ -12,22 +13,22 @@
## 属性
-| 名称 | 参数类型 | 默认值 | 描述 |
-| -------- | -------- | -------- | -------- |
+| 名称 | 参数类型 | 默认值 | 描述 |
+| ---------- | ---------- | ------------------ | ------------ |
| visibility | Visibility | Visibility.Visible | 控制当前组件显示或隐藏。 |
+## Visibility枚举说明
-- Visibility枚举说明
- | 名称 | 描述 |
- | -------- | -------- |
- | Hidden | 隐藏，但参与布局进行占位。 |
- | Visible | 显示。 |
- | None | 隐藏，但不参与布局，不进行占位。 |
-
+| 名称 | 描述 |
+| ------- | ---------------- |
+| Hidden | 隐藏，但参与布局进行占位。 |
+| Visible | 显示。 |
+| None | 隐藏，但不参与布局，不进行占位。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct VisibilityExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-z-order.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-z-order.md
index 00b052581dc316917ef8f27efcaec8b86eebbd2f..ef1cefcaf1bf94a564bf9ff97dc8d7a1153bb523 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-z-order.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-z-order.md
@@ -1,7 +1,8 @@
# Z序控制
->  **说明：**
-> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+> **说明：**
+>
+> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
## 权限列表
@@ -12,14 +13,15 @@
## 属性
-| 名称 | 参数类型 | 默认值 | 描述 |
-| -------- | -------- | -------- | -------- |
-| zIndex | number | 0 | 同一容器中兄弟组件显示层级关系，z值越大，显示层级越高。 |
+| 名称 | 参数类型 | 默认值 | 描述 |
+| ------ | ------ | ---- | ---------------------------- |
+| zIndex | number | 0 | 同一容器中兄弟组件显示层级关系，z值越大，显示层级越高。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct ZIndexExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-component-area-change-event.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-component-area-change-event.md
index 61fd9b2820f6146677c5b16808ed70c8acb3cd66..b1bdbfba1a1595952094d573e1f452b0c2c8dd9e 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-component-area-change-event.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-component-area-change-event.md
@@ -1,7 +1,8 @@
# 组件区域变化事件
->  **说明：**
-> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+> **说明：**
+>
+> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
## 权限列表
@@ -11,14 +12,15 @@
## 事件
-| 名称 | 支持冒泡 | 功能描述 |
-| -------- | -------- | -------- |
-| onAreaChange(event: (oldValue: Area, newValue: Area) => void) | 否 | 组件区域变化时触发该回调，Area类型说明见[Area对象](ts-universal-events-click.md)介绍。 |
+| 名称 | 支持冒泡 | 功能描述 |
+| ---------------------------------------- | ---- | ---------------------------------------- |
+| onAreaChange(event: (oldValue: Area, newValue: Area) => void) | 否 | 组件区域变化时触发该回调，Area类型说明见[Area对象](ts-universal-events-click.md)介绍。 |
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct AreaExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md
index 54b6b01f3ede7ddaf4c2ed815b2e72ecc35026a0..a137bed6d4aded55d05080b08904b61f07c42e61 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md
@@ -1,6 +1,7 @@
# 点击事件
> **说明：**
+>
> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
@@ -26,8 +27,8 @@
| timestamp | number | 事件时间戳。 |
## EventTarget8+对象说明
-| 名称 | 参数类型 | 描述 |
-| ---- | ----------------- | ---------- |
+| 名称 | 参数类型 | 描述 |
+| ---- | ------------------ | ---------- |
| area | [Area](#area8对象说明) | 目标元素的区域信息。 |
## Area8+对象说明
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-drag-drop.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-drag-drop.md
index 154a2c0ec7e4f6aca9c77fe86987e1394cb718a7..24db7913bea564444f29029690fbcad9d6493b3f 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-drag-drop.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-drag-drop.md
@@ -1,6 +1,7 @@
# 拖拽事件
> **说明：**
+>
> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
## 事件
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md
index cdcabb4b2d4b75a11d0c284074475e447be47ece..13a48a0c8056a466fa9e5bfd2e5fdd7eb9dcbefe 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md
@@ -3,6 +3,7 @@
按键事件指组件与键盘、遥控器等按键设备交互时触发的事件。
> **说明：**
+>
> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
@@ -20,22 +21,23 @@
## KeyEvent对象说明
-- 属性
- | 属性名称 | 类型 | 描述 |
- | ------------------------------------- | --------------------------- | -------------------------- |
- | type | [KeyType](#keytype枚举说明) | 按键的类型。 |
- | [keyCode](../apis/js-apis-keycode.md) | number | 按键的键码。 |
- | keyText | string | 按键的键值。 |
- | keySource | [KeySource](#keysource枚举说明) | 触发当前按键的输入设备类型。 |
- | deviceId | number | 触发当前按键的输入设备ID。 |
- | metaKey | number | 按键发生时元键的状态，1表示按压态，0表示未按压态。 |
- | timestamp | number | 按键发生时的时间戳。 |
-
-
-- 接口
- | 接口名称 | 功能描述 |
- | ---------------------------- | --------- |
- | stopPropagation(): void | 阻塞事件冒泡传递。 |
+### 属性
+
+| 属性名称 | 类型 | 描述 |
+| ------------------------------------- | --------------------------- | -------------------------- |
+| type | [KeyType](#keytype枚举说明) | 按键的类型。 |
+| [keyCode](../apis/js-apis-keycode.md) | number | 按键的键码。 |
+| keyText | string | 按键的键值。 |
+| keySource | [KeySource](#keysource枚举说明) | 触发当前按键的输入设备类型。 |
+| deviceId | number | 触发当前按键的输入设备ID。 |
+| metaKey | number | 按键发生时元键的状态，1表示按压态，0表示未按压态。 |
+| timestamp | number | 按键发生时的时间戳。 |
+
+### 接口
+
+| 接口名称 | 功能描述 |
+| ---------------------------- | --------- |
+| stopPropagation(): void | 阻塞事件冒泡传递。 |
## KeyType枚举说明
| 名称 | 描述 |
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-show-hide.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-show-hide.md
index 417b6c0611f7827d2b71a95c31ee4df25f71d4e2..41f987afdd5e8030d1d720081ef6e3d6491c91d3 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-show-hide.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-show-hide.md
@@ -1,7 +1,8 @@
# 挂载卸载事件
->  **说明：**
-> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+> **说明：**
+>
+> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
## 权限列表
@@ -11,10 +12,10 @@
## 事件
-| 名称 | 支持冒泡 | 功能描述 |
-| -------- | -------- | -------- |
-| onAppear(callback: () => void) | 否 | 组件挂载显示时触发此回调。 |
-| onDisappear(callback: () => void) | 否 | 组件卸载消失时触发此回调。 |
+| 名称 | 支持冒泡 | 功能描述 |
+| ---------------------------------------- | ---- | ------------- |
+| onAppear(callback: () => void) | 否 | 组件挂载显示时触发此回调。 |
+| onDisappear(callback: () => void) | 否 | 组件卸载消失时触发此回调。 |
## 示例
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md
index 4745e9e02cb7669f1f7a85fec8428efabf449122..8de6233baf2968474c35b745a46e6a56ddd62238 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md
@@ -1,6 +1,7 @@
# 触摸事件
> **说明：**
+>
> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
@@ -18,21 +19,21 @@
## TouchEvent对象说明
-- 属性
- | 属性名称 | 类型 | 描述 |
- | ------------------- | ---------------------------------------- | ------------ |
- | type | TouchType | 触摸事件的类型。 |
- | touches | Array<[TouchObject](#touchobject对象说明)> | 全部手指信息。 |
- | changedTouches | Array<[TouchObject](#touchobject对象说明)> | 当前发生变化的手指信息。 |
- | timestamp | number | 事件时间戳。 |
- | target8+ | [EventTarget](ts-universal-events-click.md#eventtarget8对象说明) | 被触摸元素对象。 |
+### 属性
+| 属性名称 | 类型 | 描述 |
+| ------------------- | ---------------------------------------- | ------------ |
+| type | TouchType | 触摸事件的类型。 |
+| touches | Array<[TouchObject](#touchobject对象说明)> | 全部手指信息。 |
+| changedTouches | Array<[TouchObject](#touchobject对象说明)> | 当前发生变化的手指信息。 |
+| timestamp | number | 事件时间戳。 |
+| target8+ | [EventTarget](ts-universal-events-click.md#eventtarget8对象说明) | 被触摸元素对象。 |
-- 接口
- | 接口名称 | 功能描述 |
- | ---------------------- | ------- |
- | stopPropagation()：void | 阻塞事件冒泡。 |
+### 接口
+| 接口名称 | 功能描述 |
+| ---------------------- | ------- |
+| stopPropagation()：void | 阻塞事件冒泡。 |
## TouchObject对象说明
| 属性名称 | 类型 | 描述 |
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-focus-event.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-focus-event.md
index b816e134e544ffbc07b91d9946fb74ec0527e2d4..d2628f18a01ef13f539c61cdf5dfaf8519731edc 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-focus-event.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-focus-event.md
@@ -1,7 +1,8 @@
# 焦点事件
->  **说明：**
-> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+> **说明：**
+>
+> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
## 权限列表
@@ -11,18 +12,19 @@
## 事件
-| **名称** | **支持冒泡** | **功能描述** |
-| -------- | -------- | -------- |
-| onFocus(callback: () => void) | 否 | 当前组件获取焦点时触发的回调。 |
-| onBlur(callback:() => void) | 否 | 当前组件失去焦点时触发的回调。 |
+| **名称** | **支持冒泡** | **功能描述** |
+| ---------------------------------------- | -------- | --------------- |
+| onFocus(callback: () => void) | 否 | 当前组件获取焦点时触发的回调。 |
+| onBlur(callback:() => void) | 否 | 当前组件失去焦点时触发的回调。 |
->  **说明：**
-> 支持焦点事件的组件：Button、Text、Image、List、Grid。
+> **说明：**
+> 支持焦点事件的组件：Button、Text、Image、List、Grid。
## 示例
-```
+```ts
+// xxx.ets
@Entry
@Component
struct FocusEventExample {
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md
index febe01ccc186e38bb1bebc8a0f1b9524b54227ef..158bafe41994307d23dc4cbd0bca8ff412ad4e8d 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md
@@ -1,6 +1,7 @@
# 鼠标事件
> **说明：**
+>
> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。