diff --git a/zh-cn/application-dev/reference/arkui-js/js-components-common-customizing-font.md b/zh-cn/application-dev/reference/arkui-js/js-components-common-customizing-font.md
index 6d606014dca47e07053bfe0af523bfdfba829908..d3fab563616168ac3fc532cd674af5e4f8f9bbfb 100644
--- a/zh-cn/application-dev/reference/arkui-js/js-components-common-customizing-font.md
+++ b/zh-cn/application-dev/reference/arkui-js/js-components-common-customizing-font.md
@@ -1,13 +1,11 @@
# 自定义字体样式
+自定义字体可以是从项目中的字体文件中加载的字体,字体格式支持ttf和otf。
+
> **说明:**
+>
> 从API version 4开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
-font-face用于定义字体样式。应用可以在style中定义font-face来指定相应的字体名和字体资源,然后在font-family样式中引用该字体。
-
-
-自定义字体可以是从项目中的字体文件中加载的字体,字体格式支持ttf和otf。
-
## 定义font-face
@@ -48,6 +46,7 @@ font-face用于定义字体样式。应用可以在style中定义font-face来指
页面样式:
```css
+/*xxx.css*/
@font-face {
font-family: HWfont;
src: url("/common/HWfont.ttf");
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-checkbox.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-checkbox.md
index b49d1b2d32db61963199b0015df186731474419c..b16f9057e8ea6513b64cdf3ade64563dba03216b 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-checkbox.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-checkbox.md
@@ -1,14 +1,10 @@
# Checkbox
-> **说明:**
-> 该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
-
-
提供多选框组件,通常用于某选项的打开或关闭。
-## 权限列表
-
-无
+> **说明:**
+>
+> 该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 子组件
@@ -16,29 +12,33 @@
## 接口
-Checkbox( name?: string, group?: string )
+Checkbox( option?: {name?: string, group?: string })
-- 参数
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | --------| --------| ------ | -------- | -------- |
- | name | string | 否 | - | 多选框名称。 |
- | group | string | 否 | - | 多选框的群组名称。 |
+**参数:**
+| 参数名 | 参数类型 | 必填 | 参数描述 |
+| --------| --------| ------ | -------- |
+| name | string | 否 | 多选框名称。 |
+| group | string | 否 | 多选框的群组名称。 |
## 属性
+除支持[通用属性](ts-universal-attributes-size.md)外,还支持以下属性:
+
-| 名称 | 参数类型 | 默认值 | 描述 |
-| ------------- | ------- | ------ | -------- |
-| select | boolean | false | 设置多选框是否选中。 |
-| selectedColor | [ResourceColor](../../ui/ts-types.md) | - | 设置多选框选中状态颜色。 |
+| 名称 | 参数类型 | 描述 |
+| ------------- | ------- | -------- |
+| select | boolean | 设置多选框是否选中。
默认值:false |
+| selectedColor | [ResourceColor](../../ui/ts-types.md) | 设置多选框选中状态颜色。 |
## 事件
-| 名称 | 功能描述 |
+支持[通用事件](ts-universal-events-click.md)外,还支持以下事件:
+
+| 名称 | 功能描述 |
| ----------| -------- |
-|onChange(callback: (value: boolean) => void) | 当选中状态发生变化时,触发该回调。
- value为true时,表示已选中。
- value为false时,表示未选中。 |
-
+|onChange(callback: (value: boolean) => void) | 当选中状态发生变化时,触发该回调。
- value为true时,表示已选中。
- value为false时,表示未选中。 |
+
## 示例
```ts
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-checkboxgroup.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-checkboxgroup.md
index 8e74180569272bb4127286c4e789e220884b6ed4..2645b7bc25d0c920c27b7f69b051763640892b2a 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-checkboxgroup.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-checkboxgroup.md
@@ -1,13 +1,10 @@
# CheckboxGroup
-> **说明:**
-> 该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
-
多选框群组,用于控制多选框全选或者不全选状态。
-## 权限列表
-
-无
+> **说明:**
+>
+> 该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 子组件
@@ -19,31 +16,38 @@ CheckboxGroup( group?: string )
创建多选框群组,可以控制群组内的Checkbox全选或者不全选,相同group的Checkbox和CheckboxGroup为同一群组。
-- 参数
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | group | string | 否 | - | 群组名称。|
+**参数:**
-## 属性
-| 名称 | 参数类型 | 默认值 | 描述 |
+| 参数名 | 参数类型 | 必填 | 参数描述 |
| -------- | -------- | -------- | -------- |
-| selectAll | boolean | false | 设置是否全选。 |
-| selectedColor | [ResourceColor](../../ui/ts-types.md) | - | 设置被选中或部分选中状态的颜色。 |
+| group | string | 否 | 群组名称。|
+
+## 属性
+
+除支持[通用属性](ts-universal-attributes-size.md)外,还支持以下属性:
+
+| 名称 | 参数类型 | 描述 |
+| -------- | -------- | -------- |
+| selectAll | boolean | 设置是否全选。
默认值:false |
+| selectedColor | [ResourceColor](../../ui/ts-types.md) | 设置被选中或部分选中状态的颜色。 |
## 事件
+除支持[通用事件](ts-universal-events-click.md)外,还支持以下事件:
+
| 名称 | 功能描述 |
| -------- | -------- |
| onChange (callback: (names: Array<string>, status: SelectStatus) => void ) |CheckboxGroup的选中状态或群组内的Checkbox的选中状态发生变化时,触发回调。
- names:群组内所有被选中的多选框名称。
- status:选中状态。|
-- SelectStatus枚举说明
- | 名称 | 描述 |
- | ----- | -------------------- |
- | All | 群组多选择框全部选择。 |
- | Part | 群组多选择框部分选择。 |
- | None | 群组多选择框全部没有选择。 |
+## SelectStatus枚举说明
+
+| 名称 | 描述 |
+| ----- | -------------------- |
+| All | 群组多选择框全部选择。 |
+| Part | 群组多选择框部分选择。 |
+| None | 群组多选择框全部没有选择。 |
## 示例
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-ability-component.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-ability-component.md
index c0e8b56e0b224a632cd98281e452c6da68d632b9..86c6d07bdfa37959bf8e15714ade8ce4786e2c22 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-container-ability-component.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-ability-component.md
@@ -1,14 +1,13 @@
# AbilityComponent
+独立显示Ability的容器。
+
> **说明:**
>
> 该组件从API Version 9开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
>
> 本组件均为系统接口,三方应用不支持调用。
-
-独立显示Ability的容器。
-
## 使用约束
AbilityComponent为独立层次渲染,不能再之上叠加其他显示内容。
@@ -26,26 +25,26 @@ AbilityComponent需设置且只能设置width、height,且width、height不支
## 接口
-AbilityComponent(value: {want : Want})
+AbilityComponent(want: Want)
**参数:**
-| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
-| -------- | -------- | -------- | -------- | -------- |
-| want | [Want](../../reference/apis/js-apis-application-Want.md) | 是 | - | 默认加载的Ability描述。 |
+| 参数名 | 参数类型 | 必填 | 参数描述 |
+| -------- | -------- | -------- | -------- |
+| want | [Want](../apis/js-apis-application-Want.md) | 是 | 默认加载的Ability描述。 |
## 事件
### onConnect
-onConnect() => void
+onConnect(callback:() => void)
AbilityComponent环境启动完成时的回调,之后可使用AbilityComponent的方法。
### onDisconnect
-onDisconnect() => void
+onDisconnect(callback:() => void)
AbilityComponent环境销毁时的回调。
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-column.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-column.md
index 7a8d588ffe3b33d02b8b6a35d3b352148ce9664a..ac60827aef336f708577ad25200708118bbf0cce 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-container-column.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-column.md
@@ -1,15 +1,10 @@
# Column
-> **说明:**
-> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
-
-
沿垂直方向布局的容器。
-
-## 权限列表
-
-无
+> **说明:**
+>
+> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 子组件
@@ -19,21 +14,22 @@
## 接口
-Column(value?:{space?: Length})
-
+Column(value?:{space?: string | number })
-- 参数
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | space | Length | 否 | 0 | 纵向布局元素间距。 |
+**参数:**
+| 参数名 | 参数类型 | 必填 | 参数描述 |
+| -------- | -------- | -------- | -------- |
+| space | string \| number | 否 | 纵向布局元素间距。 |
## 属性
-| 名称 | 参数类型 | 默认值 | 描述 |
-| -------- | -------- | -------- | -------- |
-| alignItems | [HorizontalAlign](ts-appendix-enums.md#horizontalalign) | HorizontalAlign.Center | 设置子组件在水平方向上的对齐格式。 |
-| justifyContent8+ | [FlexAlign](ts-container-flex.md) | FlexAlign.Start | 设置子组件在垂直方向上的对齐格式。 |
+除支持[通用属性](ts-universal-attributes-size.md)外,还支持以下属性:
+
+| 名称 | 参数类型 | 描述 |
+| -------- | -------- | -------- |
+| alignItems | [HorizontalAlign](ts-appendix-enums.md#horizontalalign) | 设置子组件在水平方向上的对齐格式。
默认值:HorizontalAlign.Center |
+| justifyContent8+ | [FlexAlign](ts-container-flex.md) | 设置子组件在垂直方向上的对齐格式。
默认值:FlexAlign.Start |
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 834917593487e19a4dc6d990c0047000c9410f29..a23c17552d46553a65d1e95b9002cdb75ab345e3 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,15 +1,10 @@
# TabContent
-> **说明:**
-> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
-
-
仅在Tabs中使用,对应一个切换页签的内容视图。
-
-## 权限列表
-
-无
+> **说明:**
+>
+> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 子组件
@@ -24,16 +19,16 @@ TabContent()
## 属性
-不支持触摸热区设置。
+除支持[通用属性](ts-universal-attributes-size.md)外,还支持以下属性:
-| 名称 | 参数类型 | 默认值 | 描述 |
-| -------- | -------- | -------- | -------- |
-| tabBar | string \| Resource \| {
icon?: string \| Resource,
text?: string \| Resource
}
\| [CustomBuilder](../../ui/ts-types.md)8+ | - | 设置TabBar上显示内容。
CustomBuilder: 构造器,内部可以传入组件(API8版本以上适用)。
> **说明:**
> 如果icon采用svg格式图源,则要求svg图源删除其自有宽高属性值。如采用带有自有宽高属性的svg图源,icon大小则是svg本身内置的宽高属性值大小。 |
+| 名称 | 参数类型 | 描述 |
+| -------- | -------- | -------- |
+| tabBar | string \| Resource \| {
icon?: string \| Resource,
text?: string \| Resource
}
\| [CustomBuilder](../../ui/ts-types.md)8+ | 设置TabBar上显示内容。
CustomBuilder: 构造器,内部可以传入组件(API8版本以上适用)。
> **说明:**
> 如果icon采用svg格式图源,则要求svg图源删除其自有宽高属性值。如采用带有自有宽高属性的svg图源,icon大小则是svg本身内置的宽高属性值大小。 |
> **说明:**
> - TabContent组件不支持设置通用宽度属性,其宽度默认撑满Tabs父组件。
->
> - TabContent组件不支持设置通用高度属性,其高度由Tabs父组件高度与TabBar组件高度决定。
+> - TabContent组件不支持[触摸热区设置](ts-universal-attributes-touch-target.md)。
## 示例
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 628dd15c7a7b3ba4d9a5214af9330d3d698766b5..520b1c3dace9db32feb920313a9314fa9c7ab4e1 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,15 +1,10 @@
# Tabs
-> **说明:**
-> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
-
-
一种可以通过页签进行内容视图切换的容器组件,每个页签对应一个内容视图。
-
-## 权限列表
-
-无
+> **说明:**
+>
+> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 子组件
@@ -17,46 +12,50 @@
包含子组件[TabContent](ts-container-tabcontent.md)。
-## 接口说明
+## 接口
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 | 否 | 指定页签位置来创建Tabs容器组件。
默认值:BarPosition.Start |
+| index | number | 否 | 指定初次初始页签索引。
默认值:0 |
+| controller | [TabsController](#tabscontroller) | 否 | 设置Tabs控制器。 |
+
+## BarPosition枚举说明
+
+| 名称 | 描述 |
+| -------- | -------- |
+| Start | vertical属性方法设置为true时,页签位于容器左侧;vertical属性方法设置为false时,页签位于容器顶部。 |
+| End | vertical属性方法设置为true时,页签位于容器右侧;vertical属性方法设置为false时,页签位于容器底部。 |
## 属性
-不支持触摸热区设置。
+不支持[触摸热区设置](ts-universal-attributes-touch-target.md),除支持[通用属性](ts-universal-attributes-size.md)外,还支持以下属性:
-| 名称 | 参数类型 | 默认值 | 描述 |
-| -------- | -------- | -------- | -------- |
-| vertical | boolean | false | 设置为false是为横向Tabs,设置为true时为纵向Tabs。 |
-| scrollable | boolean | true | 设置为true时可以通过滑动页面进行页面切换,为false时不可滑动切换页面。 |
-| barMode | BarMode | BarMode.Fixed | TabBar布局模式,具体描述见BarMode枚举说明。 |
-| barWidth | number \| string8+ | - | TabBar的宽度值。 |
-| barHeight | number \| string8+ | - | TabBar的高度值。 |
-| animationDuration | number | 200 | TabContent滑动动画时长。 |
+| 名称 | 参数类型 | 描述 |
+| -------- | -------- | -------- |
+| vertical | boolean | 设置为false是为横向Tabs,设置为true时为纵向Tabs。
默认值:false |
+| scrollable | boolean | 设置为true时可以通过滑动页面进行页面切换,为false时不可滑动切换页面。
默认值:true |
+| barMode | BarMode | TabBar布局模式,具体描述见BarMode枚举说明。
默认值:BarMode.Fixed |
+| barWidth | number \| string8+ | TabBar的宽度值。 |
+| barHeight | number \| string8+ | TabBar的高度值。 |
+| animationDuration | number | TabContent滑动动画时长。
默认值:200 |
-- BarMode枚举说明
- | 名称 | 描述 |
- | -------- | -------- |
- | Scrollable | TabBar使用实际布局宽度, 超过总长度后可滑动。 |
- | Fixed | 所有TabBar平均分配宽度。 |
+## BarMode枚举说明
+| 名称 | 描述 |
+| -------- | -------- |
+| Scrollable | TabBar使用实际布局宽度, 超过总长度后可滑动。 |
+| Fixed | 所有TabBar平均分配宽度。 |
## 事件
+除支持[通用事件](ts-universal-events-click.md)外,还支持以下事件:
+
| 名称 | 功能描述 |
| -------- | -------- |
| onChange(callback: (index: number) => void) | Tab页签切换后触发的事件。 |
@@ -78,10 +77,11 @@ changeIndex(value: number): void
控制Tabs切换到指定页签。
-- 参数
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | value | number | 是 | - | 页签在Tabs里的索引值,索引值从0开始。 |
+**参数:**
+
+| 参数名 | 参数类型 | 必填 | 参数描述 |
+| -------- | -------- | -------- | -------- |
+| value | number | 是 | 页签在Tabs里的索引值,索引值从0开始。 |
## 示例
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 70d9312592886a74b4600f6c0c1d58a17253365a..52a1d73e4dd21394005f89a87abfb7361091c9ca 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
@@ -3,12 +3,8 @@
用于绘制圆形的组件。
> **说明:**
-> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
-
-
-## 权限列表
-
-无
+>
+> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 子组件
@@ -18,26 +14,23 @@
## 接口
-Circle(options?: {width: Length, height: Length})
+Circle(options?: {width: string | number, height: string | number })
-- 参数
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | options | Object | 否 | - | 见options参数说明。 |
-
-- options参数说明
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | width | Length | 是 | - | 宽度。 |
- | height | Length | 是 | - | 高度。 |
+**参数:**
+| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
+| -------- | -------- | -------- | -------- | -------- |
+| width | string \| number | 是 | - | 宽度。 |
+| height | string \| number | 是 | - | 高度。 |
## 属性
+仅支持以下属性:
+
| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
| -------- | -------- | -------- | -------- | -------- |
-| width | Length | 0 | 否 | 圆所在矩形的宽度。 |
-| height | Length | 0 | 否 | 圆所在矩形的高度。 |
+| width | string \| number | 0 | 否 | 圆所在矩形的宽度。 |
+| height | string \| number | 0 | 否 | 圆所在矩形的高度。 |
## 示例
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 4a59a33dd391fbe053a231537fccef3a244170fa..0ca66e5dab70bb423141c5ea320a516856b4537a 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
@@ -3,7 +3,8 @@
提供显示动画接口。
> **说明:**
-> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
+>
+> 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
| 接口名称 | 功能描述 |
@@ -13,21 +14,22 @@
## AnimationOptions对象说明
-- 属性
- | 属性名称 | 属性类型 | 默认值 | 描述 |
- | -------- | -------- | -------- | -------- |
- | duration | number | 1000 | 动画持续时间,单位为毫秒。 |
- | tempo | number | 1.0 | 动画的播放速度,值越大动画播放越快,值越小播放越慢,为0时无动画效果。 |
- | curve | Curve \| Curves | Linear | 动画曲线。 |
- | delay | number | 0 | 单位为ms(毫秒),默认不延时播放。 |
- | iterations | number | 1 | 默认播放一次,设置为-1时表示无限次播放。 |
- | playMode | [PlayMode](ts-appendix-enums.md#playmode) | Normal | 设置动画播放模式,默认播放完成后重头开始播放。 |
+### 属性
+| 属性名称 | 属性类型 | 描述 |
+| -------- | -------- | -------- |
+| duration | number | 动画持续时间,单位为毫秒。
默认值:1000 |
+| tempo | number | 动画的播放速度,值越大动画播放越快,值越小播放越慢,为0时无动画效果。
默认值:1.0 |
+| curve | Curve \| Curves | 动画曲线。
默认值:Curve.Linear |
+| delay | number | 单位为ms(毫秒),默认不延时播放。
默认值:0 |
+| iterations | number | 默认播放一次,设置为-1时表示无限次播放。
默认值:1 |
+| playMode | [PlayMode](ts-appendix-enums.md#playmode) | 设置动画播放模式,默认播放完成后重头开始播放。
默认值:PlayMode.Normal |
-- 接口
- | 名称 | 功能描述 |
- | -------- | -------- |
- | onFinish() => void | 动效播放完成回调。 |
+### 接口
+
+| 名称 | 功能描述 |
+| -------- | -------- |
+| onFinish() => void | 动效播放完成回调。 |
## 示例
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 80518566206655e4905c445b247c8b3d9a231460..c16671bfe38e198b0d055f189e5f08f4293dc0b1 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
@@ -3,6 +3,7 @@
用于播放单个视频并控制其播放状态的组件。
> **说明:**
+>
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 权限列表
@@ -27,50 +28,53 @@
## 接口
-Video(value: VideoOptions)
+Video(value: {src?: string | Resource, currentProgressRate?: number | string | PlaybackSpeed, previewUri?: string | PixelMap | Resource, controller?: VideoController})
-- VideoOptions类型接口说明
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | ------------------- | ---------------------------------------- | ---- | ---------------------------------------- | ---------------------------------------- |
- | src | string \| [Resource](../../ui/ts-types.md) | 否 | - | 视频播放源的路径,支持本地视频路径和网络路径。
支持在resources下面的video或rawfile文件夹里放置媒体资源。
支持dataability://的路径前缀,用于访问通过Data Ability提供的视频路径,具体路径信息详见[Data Ability说明](../../ability/fa-dataability.md)。 |
- | currentProgressRate | number \| string \| 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) | 否 | - | 控制器。 |
+**参数:**
+| 参数名 | 参数类型 | 必填 | 参数描述 |
+| ------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
+| src | string \| [Resource](../../ui/ts-types.md) | 否 | 视频播放源的路径,支持本地视频路径和网络路径。
支持在resources下面的video或rawfile文件夹里放置媒体资源。
支持dataability://的路径前缀,用于访问通过Data Ability提供的视频路径,具体路径信息详见[Data Ability说明](../../ability/fa-dataability.md)。
**说明:**
视频支持的规格是:mp4、mkv、webm、TS。 |
+| currentProgressRate | number \| string \| PlaybackSpeed8+ | 否 | 视频播放倍速。
**说明:**
number取值仅支持:0.75,1.0,1.25,1.75,2.0。
默认值:1.0 \| PlaybackSpeed.Speed_Forward_1_00_X |
+| previewUri | string \| PixelMap8+ \| [Resource](../../ui/ts-types.md) | 否 | 预览图片的路径。 |
+| controller | [VideoController](#videocontroller) | 否 | 控制器。 |
-- PlaybackSpeed8+类型接口说明
- | 名称 | 描述 |
- | -------------------- | --------- |
- | Speed_Forward_0_75_X | 0.75倍速播放。 |
- | Speed_Forward_1_00_X | 1倍速播放。 |
- | Speed_Forward_1_25_X | 1.25倍速播放。 |
- | Speed_Forward_1_75_X | 1.75倍速播放。 |
- | Speed_Forward_2_00_X | 2倍速播放。 |
+## PlaybackSpeed8+枚举说明
+| 名称 | 描述 |
+| -------------------- | --------- |
+| Speed_Forward_0_75_X | 0.75倍速播放。 |
+| Speed_Forward_1_00_X | 1倍速播放。 |
+| Speed_Forward_1_25_X | 1.25倍速播放。 |
+| Speed_Forward_1_75_X | 1.75倍速播放。 |
+| Speed_Forward_2_00_X | 2倍速播放。 |
## 属性
-| 名称 | 参数类型 | 默认值 | 描述 |
-| --------- | ---------------------------------------- | ----- | --------------- |
-| muted | boolean | false | 是否静音。 |
-| autoPlay | boolean | false | 是否自动播放。 |
-| controls | boolean | true | 控制视频播放的控制栏是否显示。 |
-| objectFit | [ImageFit](ts-basic-components-image.md) | Cover | 设置视频显示模式。 |
-| loop | boolean | false | 是否单个视频循环播放。 |
+除支持[通用属性](ts-universal-attributes-size.md)外,还支持以下属性:
+| 名称 | 参数类型 | 描述 |
+| --------- | ---------------------------------------- | ----------------------------------------------- |
+| muted | boolean | 是否静音。
默认值:false |
+| autoPlay | boolean | 是否自动播放。
默认值:false |
+| controls | boolean | 控制视频播放的控制栏是否显示。
默认值:true |
+| objectFit | [ImageFit](ts-basic-components-image.md) | 设置视频显示模式。
默认值:Cover |
+| loop | boolean | 是否单个视频循环播放。
默认值:false |
## 事件
-| 名称 | 功能描述 |
-| ---------------------------------------- | ---------------------------------------- |
-| onStart() => void | 播放时触发该事件。 |
-| onPause() => void | 暂停时触发该事件。 |
-| onFinish() => void | 播放结束时触发该事件。 |
-| onError() => void | 播放失败时触发该事件。 |
-| onPrepared(event?: { duration: number }) => void | 视频准备完成时触发该事件,通过duration可以获取视频时长,单位为秒(s)。 |
-| onSeeking(event?: { time: number }) => void | 操作进度条过程时上报时间信息,单位为s。 |
-| onSeeked(event?: { time: number }) => void | 操作进度条完成后,上报播放时间信息,单位为s。 |
-| onUpdate(event?: { time: number }) => void | 播放进度变化时触发该事件,单位为s,更新时间间隔为250ms。 |
+除支持[通用事件](ts-universal-events-click.md)外,还支持以下事件:
+
+| 名称 | 功能描述 |
+| ------------------------------------------------------------ | ------------------------------------------------------------ |
+| onStart(event:() => void) | 播放时触发该事件。 |
+| onPause(event:() => void) | 暂停时触发该事件。 |
+| onFinish(event:() => void) | 播放结束时触发该事件。 |
+| onError(event:() => void) | 播放失败时触发该事件。 |
+| onPrepared(callback:(event?: { duration: number }) => void) | 视频准备完成时触发该事件,通过duration可以获取视频时长,单位为秒(s)。 |
+| onSeeking(callback:(event?: { duration: number }) => void) | 操作进度条过程时上报时间信息,单位为s。 |
+| onSeeked(callback:(event?: { duration: number }) => void) | 操作进度条完成后,上报播放时间信息,单位为s。 |
+| onUpdate(callback:(event?: { duration: number }) => void) | 播放进度变化时触发该事件,单位为s,更新时间间隔为250ms。 |
## VideoController
@@ -109,10 +113,11 @@ setCurrentTime(value: number)
指定视频播放的进度位置。
-- 参数
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | ----- | ------ | ---- | ---- | --------- |
- | value | number | 是 | - | 视频播放进度位置。 |
+**参数:**
+
+| 参数名 | 参数类型 | 必填 | 参数描述 |
+| ------ | -------- | ---- | --------------------------- |
+| value | number | 是 | 视频播放进度位置,单位为s。 |
### requestFullscreen
@@ -120,10 +125,11 @@ requestFullscreen(value: boolean)
请求全屏播放。
-- 参数
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | ----- | ------ | ---- | ----- | ------- |
- | value | boolean | 是 | false | 是否全屏播放。 |
+**参数:**
+
+| 参数名 | 参数类型 | 必填 | 参数描述 |
+| ----- | ------ | ---- | ------- |
+| value | boolean | 是 | 是否全屏播放。
默认值:false |
### exitFullscreen
@@ -137,19 +143,21 @@ setCurrentTime(value: number, seekMode: SeekMode)
指定视频播放的进度位置,并指定跳转模式。
-- 参数
- | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
- | -------- | -------- | ---- | ---- | --------- |
- | value | number | 是 | - | 视频播放进度位置。 |
- | seekMode | SeekMode | 是 | - | 跳转模式。 |
-
-- SeekMode8+类型接口说明
- | 名称 | 描述 |
- | ---------------- | -------------- |
- | PreviousKeyframe | 跳转到前一个最近的关键帧。 |
- | NextKeyframe | 跳转到后一个最近的关键帧。 |
- | ClosestKeyframe | 跳转到最近的关键帧。 |
- | Accurate | 精准跳转,不论是否为关键帧。 |
+**参数:**
+
+| 参数名 | 参数类型 | 必填 | 参数描述 |
+| -------- | -------- | ---- | ------------------ |
+| value | number | 是 | 视频播放进度位置。 |
+| seekMode | SeekMode | 是 | 跳转模式。 |
+
+## SeekMode8+枚举说明
+
+| 名称 | 描述 |
+| ---------------- | -------------- |
+| PreviousKeyframe | 跳转到前一个最近的关键帧。 |
+| NextKeyframe | 跳转到后一个最近的关键帧。 |
+| ClosestKeyframe | 跳转到最近的关键帧。 |
+| Accurate | 精准跳转,不论是否为关键帧。 |
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-border-image.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-border-image.md
index e77aee7ca14c25a4c1e05d554f067f5a10bf45b9..9d79e66d36821a40aeb9d9b7126808c9c99998fc 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-border-image.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-border-image.md
@@ -7,38 +7,38 @@
> 从API Version 9开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
-## 权限列表
+## 属性
-无
+| 名称 | 参数类型 | 描述 |
+| -------- | -------- | -------- |
+| source | string \| [Resource](../../ui/ts-types.md#resource类型) \| [linearGradient](ts-universal-attributes-gradient-color.md) | 边框图源或者渐变色设置。 |
+| slice | [Length](../../ui/ts-types.md#length)\| EdgeWidth | 设置图片边框切割宽度。
默认值:0 |
+| width | [Length](../../ui/ts-types.md#length)\| EdgeWidth | 设置图片边框宽度。
默认值:0 |
+| outset | [Length](../../ui/ts-types.md#length)\| EdgeWidth | 设置边框图片向外延伸距离。
默认值:0 |
+| RepeatMode | RepeatMode | 设置边框图片的重复方式。
默认值:RepeatMode.Stretch |
+| fill | boolean | 设置边框图片中心填充。
默认值:false |
+## EdgeWidth枚举说明
-## 属性
+引用该对象时,至少传入一个参数。
+
+
+
+| 名称 | 参数类型 | 必填 |描述 |
+| -------- | -------- |-------- |-------- |
+| left | [Length](../../ui/ts-types.md#length) | 否 | 左侧距离参数。 |
+| right | [Length](../../ui/ts-types.md#length) | 否 | 右侧距离参数。 |
+| top | [Length](../../ui/ts-types.md#length) | 否 | 上侧距离参数。 |
+| bottom | [Length](../../ui/ts-types.md#length) | 否 | 下侧距离参数。 |
+## RepeatMode枚举说明
-| 名称 | 参数类型 | 默认值 | 描述 |
-| -------- | -------- | -------- | -------- |
-| source | string \| [Resource](../../ui/ts-types.md#resource类型) \| [linearGradient](ts-universal-attributes-gradient-color.md) | - | 边框图源或者渐变色设置。 |
-| slice | Length \| EdgeWidth | 0 | 设置图片边框切割宽度。 |
-| width | Length \| EdgeWidth | 0 | 设置图片边框宽度。 |
-| outset | Length \| EdgeWidth | 0 | 设置边框图片向外延伸距离。 |
-| RepeatMode | RepeatMode | RepeatMode.Stretch | 设置边框图片的重复方式。 |
-| fill | boolean | false | 设置边框图片中心填充。 |
-- EdgeWidth对象说明
-
- 引用该对象时,至少传入一个参数。
- | 名称 | 参数类型 | 必填 | 默认值 |描述 |
- | -------- | -------- |-------- |-------- |-------- |
- | left | Length | 否 | 0 | 左侧距离参数。 |
- | right | Length | 否 | 0 | 右侧距离参数。 |
- | top | Length | 否 | 0 | 上侧距离参数。 |
- | bottom | Length | 否 | 0 | 下侧距离参数。 |
-- RepeatMode枚举说明
- | 名称 | 描述 |
- | -------- | -------- |
- | Repeat | 被切割图片重复铺平在图片边框上,超出的部分会被剪裁。|
- | Stretch | 被切割图片以拉伸填充的方式铺满图片边框。 |
- | Round | 被切割图片以整数次平铺在图片边框上,无法以整数次平铺时压缩被切割图片。 |
- | Space | 被切割图片以整数次平铺在图片边框上,无法以整数次平铺时以空白填充。 |
+| 名称 | 描述 |
+| -------- | -------- |
+| Repeat | 被切割图片重复铺平在图片边框上,超出的部分会被剪裁。|
+| Stretch | 被切割图片以拉伸填充的方式铺满图片边框。 |
+| Round | 被切割图片以整数次平铺在图片边框上,无法以整数次平铺时压缩被切割图片。 |
+| Space | 被切割图片以整数次平铺在图片边框上,无法以整数次平铺时以空白填充。 |
## 示例
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 b68b34b6ee28fdc00b4a4fc4d7b47214fc12df19..3c830ec6f320f179419359787d4b42137d492fff 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
@@ -9,75 +9,60 @@
> 从API Version 9开始,父节点的border显示在子节点内容之上。
-## 权限列表
-
-无
-
-
## 属性
-| 名称 | 参数类型 | 默认值 | 描述 |
-| ------------ | ------------- | ----------------------- | ------------------------ |
-| border | BorderOptions | - | 统一边框样式设置接口。 |
-| borderStyle | [BorderStyle](ts-appendix-enums.md#borderstyle) | BorderStyle.Solid | 设置元素的边框样式。 |
-| borderWidth | Length | 0 | 设置元素的边框宽度。 |
-| borderColor | [ResourceColor](../../ui/ts-types.md) | - | 设置元素的边框颜色。 |
-| borderRadius | Length \| BorderRadiuses9+ | 0 | 设置元素的边框圆角半径。 |
-
-- BorderOptions属性说明
-
- | 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
- | -------- | ------------------------------------------------------------ | ----------------- | ---- | ---------- |
- | width | [Length](../../ui/ts-types.md#长度类型) \| EdgeWidth9+ | 0 | 否 | 边框宽度。 |
- | color | [ResourceColor](../../ui/ts-types.md) \| EdgeColor9+ | 'Black' | 否 | 边框颜色。 |
- | radius | [Length](../../ui/ts-types.md#长度类型) \| BorderRadiuses9+ | 0 | 否 | 边框角度。 |
- | style | [BorderStyle](ts-appendix-enums.md#borderstyle) \| EdgeStyle9+ | BorderStyle.Solid | 否 | 边框样式。 |
-
+| 名称 | 参数类型 | 描述 |
+| ------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
+| border | {
width?: [Length](../../ui/ts-types.md#长度类型) \| EdgeWidth9+,
color?: [ResourceColor](../../ui/ts-types.md) \| EdgeColor9+,
radius?: [Length](../../ui/ts-types.md#长度类型) \| BorderRadiuses9+,
style?: [BorderStyle](ts-appendix-enums.md#borderstyle) \| EdgeStyle9+
} | 统一边框样式设置接口。
- width:设置边框宽度。
- color:设置边框颜色。
- radius:设置边框圆角半径。
- style:设置边框样式。 |
+| borderStyle | [BorderStyle](ts-appendix-enums.md#borderstyle) \| EdgeStyle9+ | 设置元素的边框样式。
默认值:BorderStyle.Solid |
+| borderWidth | [Length](../../ui/ts-types.md) \| EdgeWidth9+ | 设置元素的边框宽度。 |
+| borderColor | [ResourceColor](../../ui/ts-types.md) \| EdgeColor9+ | 设置元素的边框颜色。 |
+| borderRadius | [Length](../../ui/ts-types.md) \| BorderRadiuses9+ | 设置元素的边框圆角半径。 |
-- EdgeWidth9+对象说明
+## EdgeWidth9+对象说明
- 引入该对象时,至少传入一个参数。
+引入该对象时,至少传入一个参数。
- | 名称 | 参数类型 | 必填 | 默认值 | 描述 |
- | ------ | -------- | ---- | ------ | -------------- |
- | left | length | 否 | 0 | 左侧边框宽度。 |
- | right | length | 否 | 0 | 右侧边框宽度。 |
- | top | length | 否 | 0 | 上侧边框宽度。 |
- | bottom | length | 否 | 0 | 下侧边框宽度。 |
+| 名称 | 参数类型 | 必填 | 描述 |
+| ------ | ------------------------------------- | ---- | -------------- |
+| left | [Length](../../ui/ts-types.md#length) | 否 | 左侧边框宽度。 |
+| right | [Length](../../ui/ts-types.md#length) | 否 | 右侧边框宽度。 |
+| top | [Length](../../ui/ts-types.md#length) | 否 | 上侧边框宽度。 |
+| bottom | [Length](../../ui/ts-types.md#length) | 否 | 下侧边框宽度。 |
-- EdgeColor9+对象说明
+## EdgeColor9+对象说明
- 引入该对象时,至少传入一个参数。
+引入该对象时,至少传入一个参数。
- | 名称 | 参数类型 | 必填 | 默认值 | 描述 |
- | ------ | ------------------------------------- | ---- | ------- | -------------- |
- | left | [ResourceColor](../../ui/ts-types.md) | 否 | 'Black' | 左侧边框颜色。 |
- | right | [ResourceColor](../../ui/ts-types.md) | 否 | 'Black' | 右侧边框颜色。 |
- | top | [ResourceColor](../../ui/ts-types.md) | 否 | 'Black' | 上侧边框颜色。 |
- | bottom | [ResourceColor](../../ui/ts-types.md) | 否 | 'Black' | 下侧边框颜色。 |
+| 名称 | 参数类型 | 必填 | 描述 |
+| ------ | ------------------------------------- | ---- | -------------- |
+| left | [ResourceColor](../../ui/ts-types.md) | 否 | 左侧边框颜色。 |
+| right | [ResourceColor](../../ui/ts-types.md) | 否 | 右侧边框颜色。 |
+| top | [ResourceColor](../../ui/ts-types.md) | 否 | 上侧边框颜色。 |
+| bottom | [ResourceColor](../../ui/ts-types.md) | 否 | 下侧边框颜色。 |
-- BorderRadiuses9+对象说明
+## BorderRadiuses9+对象说明
- 引用该对象时,至少传入一个参数。
+引用该对象时,至少传入一个参数。
- | 名称 | 参数类型 | 必填 | 默认值 | 描述 |
- | ----------- | -------- | ---- | ------ | ---------------- |
- | topLeft | length | 否 | 0 | 左上角圆角半径。 |
- | topRight | length | 否 | 0 | 右上角圆角半径。 |
- | bottomLeft | length | 否 | 0 | 左下角圆角半径。 |
- | bottomRight | length | 否 | 0 | 右下角圆角半径。 |
+| 名称 | 参数类型 | 必填 | 描述 |
+| ----------- | ------------------------------------- | ---- | ---------------- |
+| topLeft | [Length](../../ui/ts-types.md#length) | 否 | 左上角圆角半径。 |
+| topRight | [Length](../../ui/ts-types.md#length) | 否 | 右上角圆角半径。 |
+| bottomLeft | [Length](../../ui/ts-types.md#length) | 否 | 左下角圆角半径。 |
+| bottomRight | [Length](../../ui/ts-types.md#length) | 否 | 右下角圆角半径。 |
-- EdgeStyle9+对象说明
+## EdgeStyle9+对象说明
- 引入该对象时,至少传入一个参数。
+引入该对象时,至少传入一个参数。
- | 名称 | 参数类型 | 必填 | 默认值 | 描述 |
- | ------ | ----------- | ---- | ----------------- | -------------- |
- | left | [BorderStyle](ts-appendix-enums.md#borderstyle) | 否 | BorderStyle.Solid | 左侧边框样式。 |
- | right | [BorderStyle](ts-appendix-enums.md#borderstyle) | 否 | BorderStyle.Solid | 右侧边框样式。 |
- | top | [BorderStyle](ts-appendix-enums.md#borderstyle) | 否 | BorderStyle.Solid | 上侧边框样式。 |
- | bottom | [BorderStyle](ts-appendix-enums.md#borderstyle) | 否 | BorderStyle.Solid | 下侧边框样式。 |
+| 名称 | 参数类型 | 必填 | 描述 |
+| ------ | ----------------------------------------------- | ---- | -------------- |
+| left | [BorderStyle](ts-appendix-enums.md#borderstyle) | 否 | 左侧边框样式。 |
+| right | [BorderStyle](ts-appendix-enums.md#borderstyle) | 否 | 右侧边框样式。 |
+| top | [BorderStyle](ts-appendix-enums.md#borderstyle) | 否 | 上侧边框样式。 |
+| bottom | [BorderStyle](ts-appendix-enums.md#borderstyle) | 否 | 下侧边框样式。 |
## 示例
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 16b62a14b26ee3f5598a8797153c7df0482872f2..1e25d39568514ee8d9239ea370aedc3e3304a1cb 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
@@ -3,23 +3,19 @@
自定义组件的走焦效果,可设置组件是否走焦和具体的走焦顺序,tab键或者方向键切换焦点。
> **说明:**
+>
> 从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
-## 权限列表
-
-无
-
-
## 属性
-| **名称** | **参数类型** | **默认值** | **描述** |
-| -------------------- | -------- | ------- | ---------------------------------------- |
-| focusable | boolean | false | 设置当前组件是否可以获焦。 |
-| tabIndex9+ | number | 0 | 自定义组件tab键走焦能力,走焦顺序为:tabIndex大于0的组件依次递增走焦, tabIndex等于0的组件按组件树先后顺序走焦。
- tabIndex >= 0:表示元素是可聚焦的,并且可以通过tab键走焦来访问到该元素,按照tabIndex的数值递增而先后获焦。如果多个元素拥有相同的tabIndex,按照元素在当前组件树中的先后顺序获焦
- tabIndex < 0(通常是tabIndex = -1):表示元素是可聚焦的,但是不能通过tab键走焦来访问到该元素。 |
-| defaultFocus9+ | boolean | false | 设置当前组件是否为当前页面上的默认焦点,仅在初次创建的页面第一次进入时生效。 |
-| groupDefaultFocus9+ | boolean | false | 设置当前组件是否为当前组件所在容器获焦时的默认焦点,仅在初次创建容器节点第一次获焦时生效。
**说明:** 必须与tabIndex联合使用,当某个容器设置了tabIndex,且容器内某子组件设置了groupDefaultFocus,当该容器首次获焦时,会自动将焦点转移至该组件上。 |
-| focusOnTouch9+ | boolean | false | 设置当前组件是否支持点击获焦能力。
**说明:** 仅在组件可点击时才能正常获取焦点。 |
+| **名称** | **参数类型** | **描述** |
+| -------------------- | -------- | ---------------------------------------- |
+| focusable | boolean | 设置当前组件是否可以获焦。
默认值:false |
+| tabIndex9+ | number | 自定义组件tab键走焦能力,走焦顺序为:tabIndex大于0的组件依次递增走焦, tabIndex等于0的组件按组件树先后顺序走焦。
- tabIndex >= 0:表示元素是可聚焦的,并且可以通过tab键走焦来访问到该元素,按照tabIndex的数值递增而先后获焦。如果多个元素拥有相同的tabIndex,按照元素在当前组件树中的先后顺序获焦
- tabIndex < 0(通常是tabIndex = -1):表示元素是可聚焦的,但是不能通过tab键走焦来访问到该元素。
默认值:0 |
+| defaultFocus9+ | boolean | 设置当前组件是否为当前页面上的默认焦点,仅在初次创建的页面第一次进入时生效。
默认值:false |
+| groupDefaultFocus9+ | boolean | 设置当前组件是否为当前组件所在容器获焦时的默认焦点,仅在初次创建容器节点第一次获焦时生效。
默认值:false
**说明:** 必须与tabIndex联合使用,当某个容器设置了tabIndex,且容器内某子组件设置了groupDefaultFocus,当该容器首次获焦时,会自动将焦点转移至该组件上。
|
+| focusOnTouch9+ | boolean | 设置当前组件是否支持点击获焦能力。
默认值:false
**说明:** 仅在组件可点击时才能正常获取焦点。 |
## focusControl9+
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 58ecb13d98fd2899ef08e3cb5c14dc84e989a2b5..5b585a65b09b163afc25758c9fa33cf10edc933d 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,35 +1,35 @@
# 触摸热区设置
-> **说明:**
-> 从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
-
-
适用于支持通用点击事件、通用触摸事件、通用手势处理的组件。
-
-## 权限列表
-
-无
+> **说明:**
+>
+> 从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 属性
-| 名称 | 参数类型 | 默认值 | 描述 |
-| -------- | -------- | -------- | -------- |
-| 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%'
} |
### Rectangle对象说明
- | 名称 | 类型 | 必填 | 默认值 | 描述 |
- | -------- | -------- | -------- | -------- | -------- |
- | x | Length | 否 | 0vp | 触摸点相对于组件本身左边沿的X坐标。 |
- | y | Length | 否 | 0vp | 触摸点相对于组件本身左边沿的Y坐标。 |
- | width | Length | 否 | 100% | 触摸热区范围的宽度。 |
- | height | Length | 否 | 100% | 触摸热区范围的高度。 |
+| 名称 | 类型 | 必填 | 描述 |
+| -------- | -------- | -------- | -------- |
+| x | [Length](../../ui/ts-types.md) | 否 | 触摸点相对于组件本身左边沿的X坐标。
默认值:0vp |
+| y | [Length](../../ui/ts-types.md) | 否 | 触摸点相对于组件本身左边沿的Y坐标。
默认值:0vp |
+| width | [Length](../../ui/ts-types.md) | 否 | 触摸热区范围的宽度。
默认值:100% |
+| height | [Length](../../ui/ts-types.md) | 否 | 触摸热区范围的高度。
默认值:100% |
> **说明:**
- > 当x和y都设置为正值时,表示组件的触摸热区的范围整体往组件本身右下角偏移,偏移的大小可通过数值来设置。
+ >
+ > x和y可以设置正负值百分比。当x设置为'100%'时表示热区往右偏移组件本身宽度大小,当x设置为'-100%'时表示热区往左偏移组件本身宽度大小。当y设置为'100%'时表示热区往下偏移组件本身高度大小,当y设置为'-100%'时表示热区往上偏移组件本身高度大小。
+ >
+ > width和height只能设置正值百分比。width:'100%'表示热区宽度设置为该组件本身的宽度。比如组件本身宽度是100vp,那么'100%'表示热区宽度也为100vp。height:'100%'表示热区高度设置为该组件本身的高度。
+ >
+ > 百分比是相对于组件本身来度量的。
## 示例