-| 名称 | 描述 |
-| -------- | -------- |
-| TOP | 窗口的上边缘 |
+| 名称 | 描述 |
+| ------ | ------ |
+| TOP | 窗口的上边缘 |
| BOTTOM | 窗口的下边缘 |
-| START | 窗口的左边缘 |
-| END | 窗口的右边缘 |
+| START | 窗口的左边缘 |
+| END | 窗口的右边缘 |
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-progress.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-progress.md
index 11107f9c944bd327916d74bab34354dd058a95db..e8860c1c628ec2fe1836bf63e2acdf40494bae97 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-progress.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-progress.md
@@ -4,7 +4,7 @@
> **说明:**
>
-> 该组件从API version7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
+> 该组件从API version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 子组件
@@ -22,46 +22,46 @@ Progress(options: {value: number, total?: number, type?: ProgressType})
**参数:**
-| 参数名 | 参数类型 | 必填 | 参数描述 |
-| -------- | -------- | -------- | -------- |
-| value | number | 是 | 指定当前进度值。设置小于0的数值时置为0,设置大于total的数值时置为total。
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
-| total | number | 否 | 指定进度总长。
默认值:100
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
-| type8+ | [ProgressType](#progresstype枚举说明) | 否 | 指定进度条类型。
默认值:ProgressType.Linear
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
-| styledeprecated | [ProgressStyle](#progressstyle枚举说明) | 否 | 指定进度条样式。
该参数从API version8开始废弃,建议使用type替代。
默认值:ProgressStyle.Linear |
+| 参数名 | 参数类型 | 必填 | 参数描述 |
+| -------------------------- | ----------------------------------- | ---- | ---------------------------------------- |
+| value | number | 是 | 指定当前进度值。设置小于0的数值时置为0,设置大于total的数值时置为total。
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
+| total | number | 否 | 指定进度总长。
默认值:100
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
+| type8+ | [ProgressType](#progresstype枚举说明) | 否 | 指定进度条类型。
默认值:ProgressType.Linear
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
+| styledeprecated | [ProgressStyle](#progressstyle枚举说明) | 否 | 指定进度条样式。
该参数从API version8开始废弃,建议使用type替代。
默认值:ProgressStyle.Linear |
## ProgressType枚举说明
从API version 9开始,该接口支持在ArkTS卡片中使用。
-| 名称 | 描述 |
-| -------- | -------- |
-| Linear | 线性样式。从API version9开始,高度大于宽度的时候自适应垂直显示。 |
-| Ring8+ | 环形无刻度样式,环形圆环逐渐显示至完全填充效果。 |
-| Eclipse8+ | 圆形样式,显示类似月圆月缺的进度展示效果,从月牙逐渐变化至满月。|
-| ScaleRing8+ | 环形有刻度样式,显示类似时钟刻度形式的进度展示效果。从API version9开始,刻度外圈出现重叠的时候自动转换为环形无刻度进度条。|
-| Capsule8+ | 胶囊样式,头尾两端圆弧处的进度展示效果与Eclipse相同;中段处的进度展示效果与Linear相同。高度大于宽度的时候自适应垂直显示。 |
+| 名称 | 描述 |
+| ---------------------- | ---------------------------------------- |
+| Linear | 线性样式。从API version9开始,高度大于宽度的时候自适应垂直显示。 |
+| Ring8+ | 环形无刻度样式,环形圆环逐渐显示至完全填充效果。 |
+| Eclipse8+ | 圆形样式,显示类似月圆月缺的进度展示效果,从月牙逐渐变化至满月。 |
+| ScaleRing8+ | 环形有刻度样式,显示类似时钟刻度形式的进度展示效果。从API version9开始,刻度外圈出现重叠的时候自动转换为环形无刻度进度条。 |
+| Capsule8+ | 胶囊样式,头尾两端圆弧处的进度展示效果与Eclipse相同;中段处的进度展示效果与Linear相同。高度大于宽度的时候自适应垂直显示。 |
## ProgressStyle枚举说明
从API version 9开始,该接口支持在ArkTS卡片中使用。
-| 名称 | 描述 |
-| --------- | ------------------------------------------------------------ |
-| Linear | 线性样式。 |
-| Ring | 环形无刻度样式,环形圆环逐渐显示至完全填充效果。 |
-| Eclipse | 圆形样式,显示类似月圆月缺的进度展示效果,从月牙逐渐变化至满月。|
-| ScaleRing | 环形有刻度样式,显示类似时钟刻度形式的进度展示效果。|
+| 名称 | 描述 |
+| --------- | ---------------------------------------- |
+| Linear | 线性样式。 |
+| Ring | 环形无刻度样式,环形圆环逐渐显示至完全填充效果。 |
+| Eclipse | 圆形样式,显示类似月圆月缺的进度展示效果,从月牙逐渐变化至满月。 |
+| ScaleRing | 环形有刻度样式,显示类似时钟刻度形式的进度展示效果。 |
| Capsule | 胶囊样式,头尾两端圆弧处的进度展示效果与Eclipse相同;中段处的进度展示效果与Linear相同。高度大于宽度的时候自适应垂直显示。 |
## 属性
除支持[通用属性](ts-universal-attributes-size.md)外,还支持以下属性:
-| 名称 | 参数类型 | 描述 |
-| -------- | -------- | -------- |
-| value | number | 设置当前进度值。设置小于0的数值时置为0,设置大于total的数值时置为total。非法数值不生效。
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
-| color | [ResourceColor](ts-types.md#resourcecolor) | 设置进度条前景色。
默认值:'\#ff007dff'
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
-| backgroundColor | [ResourceColor](ts-types.md#resourcecolor) | 设置进度条底色。
默认值:'\#19182431'
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
+| 名称 | 参数类型 | 描述 |
+| ------------------ | ---------------------------------------- | ---------------------------------------- |
+| value | number | 设置当前进度值。设置小于0的数值时置为0,设置大于total的数值时置为total。非法数值不生效。
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
+| color | [ResourceColor](ts-types.md#resourcecolor) | 设置进度条前景色。
默认值:'\#ff007dff'
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
+| backgroundColor | [ResourceColor](ts-types.md#resourcecolor) | 设置进度条底色。
默认值:'\#19182431'
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| style8+ | {
strokeWidth?: [Length](ts-types.md#length),
scaleCount?: number,
scaleWidth?: [Length](ts-types.md#length)
} | 定义组件的样式。
- strokeWidth: 设置进度条宽度(不支持百分比设置)。从API version9开始,环形进度条设置宽度大于等于半径时,默认修改宽度至半径值的二分之一。
默认值:4.0Vp
- scaleCount: 设置环形进度条总刻度数。
默认值:120
- scaleWidth: 设置环形进度条刻度粗细(不支持百分比设置),刻度粗细大于进度条宽度时,为系统默认粗细。
默认值:2.0Vp
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
## 事件
@@ -128,4 +128,4 @@ struct ProgressExample {
}
```
-
+
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 3c802c467da98f84c6bd19fe70a7e3d508605f24..346bc1d33a8bc147dcda59fb1244b37780bed252 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
@@ -4,7 +4,7 @@
> **说明:**
>
-> 该组件从API Version 9开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
+> 该组件从API Version 9开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
>
> 本组件为系统接口。
@@ -29,9 +29,9 @@ AbilityComponent(want: Want)
**参数:**
-| 参数名 | 参数类型 | 必填 | 参数描述 |
-| -------- | -------- | -------- | -------- |
-| want | [Want](../apis/js-apis-app-ability-want.md) | 是 | 默认加载的Ability描述。 |
+| 参数名 | 参数类型 | 必填 | 参数描述 |
+| ---- | ---------------------------------------- | ---- | --------------- |
+| want | [Want](../apis/js-apis-app-ability-want.md) | 是 | 默认加载的Ability描述。 |
## 事件
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-custom-component-lifecycle.md b/zh-cn/application-dev/reference/arkui-ts/ts-custom-component-lifecycle.md
index 8dcec486d10a74248d65439c879a27d93e031595..08b271b86a0ee0c42ee0b0ace6e12befcb3085a5 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-custom-component-lifecycle.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-custom-component-lifecycle.md
@@ -1,12 +1,11 @@
# 自定义组件的生命周期
-
自定义组件的生命周期回调函数用于通知用户该自定义组件的生命周期,这些回调函数是私有的,在运行时由开发框架在特定的时间进行调用,不能从应用程序中手动调用这些回调函数。
-
>**说明:**
>
->允许在生命周期函数中使用Promise和异步回调函数,比如网络资源获取,定时器设置等;
+>- 本模块首批接口从API version 7开始支持,后续版本的新增接口,采用上角标单独标记接口的起始版本。
+>- 允许在生命周期函数中使用Promise和异步回调函数,比如网络资源获取,定时器设置等。
## aboutToAppear
@@ -123,8 +122,8 @@ onRecycle?(params: { [key: string]: unknown }): void
**参数:**
-| 参数名 | 类型 | 说明 |
-| ------ | -------------------------- | -------------------- |
+| 参数名 | 类型 | 说明 |
+| ------ | -------------------------- | ---------- |
| params | { [key: string]: unknown } | 自定义组件的构造参数 |
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-pixel-units.md b/zh-cn/application-dev/reference/arkui-ts/ts-pixel-units.md
index 0e1e2016c6be59f061970aecd5203858aab30718..7bbb1c7dba31c2caa7e5b1557e5e340977d15d8b 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-pixel-units.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-pixel-units.md
@@ -1,13 +1,17 @@
# 像素单位
-为开发者提供4种像素单位,框架采用vp为基准数据单位。
+ArkUI为开发者提供4种像素单位,框架采用vp为基准数据单位。
+>**说明:**
+>
+>本模块首批接口从API version 7开始支持,后续版本的新增接口,采用上角标单独标记接口的起始版本。
-| 名称 | 描述 |
-| ---- | ------------------------------------------------------------ |
-| px | 屏幕物理像素单位。 |
+
+| 名称 | 描述 |
+| ---- | ---------------------------------------- |
+| px | 屏幕物理像素单位。 |
| vp | 屏幕密度相关像素,根据屏幕像素密度转换为屏幕物理像素,当数值不带单位时,默认单位vp。在实际宽度为1440物理像素的屏幕上,1vp约等于3px。 |
-| fp | 字体像素,与vp类似适用屏幕密度变化,随系统字体大小设置变化。 |
+| fp | 字体像素,与vp类似适用屏幕密度变化,随系统字体大小设置变化。 |
| lpx | 视窗逻辑像素单位,lpx单位为实际屏幕宽度与逻辑宽度(通过designWidth配置)的比值,designWidth默认值为720。当designWidth为720时,在实际宽度为1440物理像素的屏幕上,1lpx为2px大小。 |
@@ -15,12 +19,12 @@
提供其他单位与px单位互相转换的方法。
-| 接口 | 描述 |
-| --------------------------------------------------- | ------------------------------------------------------------ |
-| vp2px(value : number) : number | 将vp单位的数值转换为以px为单位的数值。
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
-| px2vp(value : number) : number | 将px单位的数值转换为以vp为单位的数值。
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
-| fp2px(value : number) : number | 将fp单位的数值转换为以px为单位的数值。
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
-| px2fp(value : number) : number | 将px单位的数值转换为以fp为单位的数值。
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
+| 接口 | 描述 |
+| ---------------------------------------- | ---------------------------------------- |
+| vp2px(value : number) : number | 将vp单位的数值转换为以px为单位的数值。
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
+| px2vp(value : number) : number | 将px单位的数值转换为以vp为单位的数值。
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
+| fp2px(value : number) : number | 将fp单位的数值转换为以px为单位的数值。
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
+| px2fp(value : number) : number | 将px单位的数值转换为以fp为单位的数值。
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| lpx2px(value : number) : number | 将lpx单位的数值转换为以px为单位的数值。
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| px2lpx(value : number) : number | 将px单位的数值转换为以lpx为单位的数值。
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-types.md b/zh-cn/application-dev/reference/arkui-ts/ts-types.md
index d87732370e2f9d0d7afb941faaca1562dc3be1d5..dcd84c0ef0a5b0d9cdcd92117d9acbd09b426b8c 100644
--- a/zh-cn/application-dev/reference/arkui-ts/ts-types.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-types.md
@@ -1,5 +1,9 @@
# 类型定义
+>**说明:**
+>
+>本模块首批接口从API version 7开始支持,后续版本的新增接口,采用上角标单独标记接口的起始版本。
+
## Resource
资源引用类型,用于设置组件属性的值。
@@ -24,49 +28,49 @@
长度类型,用于描述尺寸单位。
-| 类型 | 说明 |
-| -------- | -------------------------------------- |
-| string | 需要显式指定像素单位,如'10px',也可设置百分比字符串,如'100%'。 |
-| number | 默认单位vp。 |
-| [Resource](#resource) | 资源引用类型,引入系统资源或者应用资源中的尺寸。 |
+| 类型 | 说明 |
+| --------------------- | -------------------------------------- |
+| string | 需要显式指定像素单位,如'10px',也可设置百分比字符串,如'100%'。 |
+| number | 默认单位vp。 |
+| [Resource](#resource) | 资源引用类型,引入系统资源或者应用资源中的尺寸。 |
## ResourceStr
字符串类型,用于描述字符串入参可以使用的类型。
-| 类型 | 说明 |
-| -------- | ---------------------------- |
-| string | 字符串类型。 |
+| 类型 | 说明 |
+| --------------------- | ------------------------- |
+| string | 字符串类型。 |
| [Resource](#resource) | 资源引用类型,引入系统资源或者应用资源中的字符串。 |
## Padding
内边距类型,用于描述组件不同方向的内边距。
-| 名称 | 类型 | 必填 | 说明 |
-| ------ | ------ | ---- | --------------- |
-| top | [Length](#length) | 否 | 上内边距,组件内元素距组件顶部的尺寸。 |
-| right | [Length](#length) | 否 | 右内边距,组件内元素距组件右边界的尺寸。 |
-| bottom | [Length](#length) | 否 | 下内边距,组件内元素距组件底部的尺寸。 |
-| left | [Length](#length) | 否 | 左内边距,组件内元素距组件左边界的尺寸。 |
+| 名称 | 类型 | 必填 | 说明 |
+| ------ | ----------------- | ---- | -------------------- |
+| top | [Length](#length) | 否 | 上内边距,组件内元素距组件顶部的尺寸。 |
+| right | [Length](#length) | 否 | 右内边距,组件内元素距组件右边界的尺寸。 |
+| bottom | [Length](#length) | 否 | 下内边距,组件内元素距组件底部的尺寸。 |
+| left | [Length](#length) | 否 | 左内边距,组件内元素距组件左边界的尺寸。 |
## Margin
外边距类型,用于描述组件不同方向的外边距。
-| 名称 | 类型 | 必填 | 说明 |
-| ------ | ------ | ---- | --------------- |
-| top | [Length](#length) | 否 | 上外边距,组件顶部距组件外元素的尺寸。 |
-| right | [Length](#length) | 否 | 右外边距,组件右边界距组件外元素的尺寸。 |
-| bottom | [Length](#length) | 否 | 下外边距,组件底部距组件外元素的尺寸。 |
-| left | [Length](#length) | 否 | 坐外边距,组件左边界距组件外元素的尺寸。 |
+| 名称 | 类型 | 必填 | 说明 |
+| ------ | ----------------- | ---- | -------------------- |
+| top | [Length](#length) | 否 | 上外边距,组件顶部距组件外元素的尺寸。 |
+| right | [Length](#length) | 否 | 右外边距,组件右边界距组件外元素的尺寸。 |
+| bottom | [Length](#length) | 否 | 下外边距,组件底部距组件外元素的尺寸。 |
+| left | [Length](#length) | 否 | 坐外边距,组件左边界距组件外元素的尺寸。 |
## EdgeWidths9+
边框宽度类型,用于描述组件边框不同方向的宽度。
-| 名称 | 类型 | 必填 | 说明 |
-| ------ | ------ | ---- | -------- |
+| 名称 | 类型 | 必填 | 说明 |
+| ------ | ----------------- | ---- | -------- |
| top | [Length](#length) | 否 | 组件上边框宽度。 |
| right | [Length](#length) | 否 | 组件右边框宽度。 |
| bottom | [Length](#length) | 否 | 组件下边框宽度。 |
@@ -76,8 +80,8 @@
圆角类型,用于描述组件边框圆角半径。
-| 名称 | 类型 | 必填 | 说明 |
-| ----------- | ------ | ---- | ---------- |
+| 名称 | 类型 | 必填 | 说明 |
+| ----------- | ----------------- | ---- | ---------- |
| topLeft | [Length](#length) | 否 | 组件左上角圆角半径。 |
| topRight | [Length](#length) | 否 | 组件右上角圆角半径。 |
| bottomLeft | [Length](#length) | 否 | 组件左下角圆角半径。 |
@@ -87,8 +91,8 @@
边框颜色,用于描述组件边框四条边的颜色。
-| 名称 | 类型 | 必填 | 说明 |
-| ------ | ------------- | ---- | -------- |
+| 名称 | 类型 | 必填 | 说明 |
+| ------ | ------------------------------- | ---- | -------- |
| top | [ResourceColor](#resourcecolor) | 否 | 组件上边框颜色。 |
| right | [ResourceColor](#resourcecolor) | 否 | 组件右边框颜色。 |
| bottom | [ResourceColor](#resourcecolor) | 否 | 组件下边框颜色。 |
@@ -98,8 +102,8 @@
边框样式,用于描述组件边框四条边的样式。
-| 名称 | 类型 | 必填 | 说明 |
-| ------ | ----------- | ---- | -------- |
+| 名称 | 类型 | 必填 | 说明 |
+| ------ | ---------------------------------------- | ---- | -------- |
| top | [BorderStyle](ts-appendix-enums.md#borderstyle) | 否 | 组件上边框样式。 |
| right | [BorderStyle](ts-appendix-enums.md#borderstyle) | 否 | 组件右边框样式。 |
| bottom | [BorderStyle](ts-appendix-enums.md#borderstyle) | 否 | 组件下边框样式。 |
@@ -110,8 +114,8 @@
相对布局完成位置坐标偏移量。
-| 名称 | 类型 | 必填 | 说明 |
-| ---- | ------ | ---- | -------- |
+| 名称 | 类型 | 必填 | 说明 |
+| ---- | ----------------- | ---- | -------- |
| dx | [Length](#length) | 是 | 水平方向偏移量。 |
| dy | [Length](#length) | 是 | 竖直方向偏移量。 |
@@ -119,27 +123,27 @@
颜色类型,用于描述资源颜色类型。
-| 类型 | 说明 |
-| ---------------------------------------- | ------------------------------------------------- |
-| [Color](ts-appendix-enums.md#color) | 颜色枚举值。 |
-| number | HEX格式颜色,支持rgb。示例:0xffffff。 |
-| string | rgb或者argb格式颜色。示例:'#ffffff', '#ff000000', 'rgb(255, 100, 255)', 'rgba(255, 100, 255, 0.5)'。 |
-| [Resource](#resource) | 使用引入资源的方式,引入系统资源或者应用资源中的颜色。 |
+| 类型 | 说明 |
+| ----------------------------------- | ---------------------------------------- |
+| [Color](ts-appendix-enums.md#color) | 颜色枚举值。 |
+| number | HEX格式颜色,支持rgb。示例:0xffffff。 |
+| string | rgb或者argb格式颜色。示例:'#ffffff', '#ff000000', 'rgb(255, 100, 255)', 'rgba(255, 100, 255, 0.5)'。 |
+| [Resource](#resource) | 使用引入资源的方式,引入系统资源或者应用资源中的颜色。 |
## ColoringStrategy
智能取色枚举类型,用于设置前景色。
-| 名称 | 描述 |
-| --------- | ------- |
-| INVERT | 设置前景色为控件背景色的反色。|
+| 名称 | 描述 |
+| ------ | --------------- |
+| INVERT | 设置前景色为控件背景色的反色。 |
## LengthConstrain
长度约束,用于对组件最大、最小长度做限制。
-| 名称 | 类型 | 必填 | 说明 |
-| --------- | ------ | ---- | ------- |
+| 名称 | 类型 | 必填 | 说明 |
+| --------- | ----------------- | ---- | ------- |
| minLength | [Length](#length) | 是 | 组件最小长度。 |
| maxLength | [Length](#length) | 是 | 组件最大长度。 |
@@ -148,12 +152,12 @@
设置文本样式。
-| 名称 | 类型 | 必填 | 说明 |
-| ------ | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
-| size | [Length](#length) | 否 | 设置文本尺寸,Length为number类型时,使用fp单位。不支持设置百分比字符串。 |
-| weight | [FontWeight](ts-appendix-enums.md#fontweight) \| number \| string | 否 | 设置文本的字体粗细,number类型取值[100, 900],取值间隔为100,默认为400,取值越大,字体越粗。 |
-| family | string \| [Resource](#resource) | 否 | 设置文本的字体列表。使用多个字体,使用','进行分割,优先级按顺序生效。例如:'Arial, sans-serif'。当前只支持'sans-serif'字体。 |
-| style | [FontStyle](ts-appendix-enums.md#fontstyle) | 否 | 设置文本的字体样式。 |
+| 名称 | 类型 | 必填 | 说明 |
+| ------ | ---------------------------------------- | ---- | ---------------------------------------- |
+| size | [Length](#length) | 否 | 设置文本尺寸,Length为number类型时,使用fp单位。不支持设置百分比字符串。 |
+| weight | [FontWeight](ts-appendix-enums.md#fontweight) \| number \| string | 否 | 设置文本的字体粗细,number类型取值[100, 900],取值间隔为100,默认为400,取值越大,字体越粗。 |
+| family | string \| [Resource](#resource) | 否 | 设置文本的字体列表。使用多个字体,使用','进行分割,优先级按顺序生效。例如:'Arial, sans-serif'。当前只支持'sans-serif'字体。 |
+| style | [FontStyle](ts-appendix-enums.md#fontstyle) | 否 | 设置文本的字体样式。 |
## Area8+
@@ -170,8 +174,8 @@
位置类型,用于表示一个坐标点。
-| 名称 | 类型 | 必填 | 说明 |
-| ---- | ------ | ---- | --------------------------- |
+| 名称 | 类型 | 必填 | 说明 |
+| ---- | ----------------- | ---- | --------------------------- |
| x | [Length](#length) | 否 | x轴坐标,作为返回值时,类型为number,单位vp。 |
| y | [Length](#length) | 否 | y轴坐标,作为返回值时,类型为number,单位vp。 |
@@ -179,8 +183,8 @@
设置约束尺寸,组件布局时,进行尺寸范围限制。
-| 名称 | 类型 | 必填 | 说明 |
-| --------- | ------ | ---- | ------- |
+| 名称 | 类型 | 必填 | 说明 |
+| --------- | ----------------- | ---- | ------- |
| minWidth | [Length](#length) | 否 | 元素最小宽度。 |
| maxWidth | [Length](#length) | 否 | 元素最大宽度。 |
| minHeight | [Length](#length) | 否 | 元素最小高度。 |
@@ -190,8 +194,8 @@
设置宽高尺寸。
-| 名称 | 类型 | 必填 | 说明 |
-| ------ | ------ | ---- | ----- |
+| 名称 | 类型 | 必填 | 说明 |
+| ------ | ----------------- | ---- | ----- |
| width | [Length](#length) | 否 | 元素宽度。 |
| height | [Length](#length) | 否 | 元素高度。 |
@@ -202,9 +206,9 @@
| 名称 | 类型 | 必填 | 说明 |
| ------ | ---------------------------------------- | ---- | ------- |
-| width | [Length](#length) \| [EdgeWidths](#edgewidths9)9+ | 否 | 边框宽度。 |
+| width | [Length](#length) \| [EdgeWidths](#edgewidths9)9+ | 否 | 边框宽度。 |
| color | [ResourceColor](#resourcecolor) \| [EdgeColors](#edgecolors9)9+ | 否 | 边框颜色。 |
-| radius | [Length](#length) \| [BorderRadiuses](#borderradiuses9)9+ | 否 | 边框圆角半径。 |
+| radius | [Length](#length) \| [BorderRadiuses](#borderradiuses9)9+ | 否 | 边框圆角半径。 |
| style | [BorderStyle](ts-appendix-enums.md#borderstyle) \| EdgeStyles9+ | 否 | 边框样式。 |
## ColorFilter9+
@@ -228,19 +232,19 @@
像素扩展属性集合,用于描述像素扩展的信息。
-| 名称 | 类型 | 必填 | 说明 |
-| ----------- | ------ | ---- | ---------- |
-| left | [Length](#length) | 否 | 组件图像左边沿扩展距离。 |
-| right | [Length](#length) | 否 | 组件图像右边沿像素扩展距离。 |
-| top | [Length](#length) | 否 | 组件图像上边沿像素扩展距离。 |
+| 名称 | 类型 | 必填 | 说明 |
+| ------ | ----------------- | ---- | -------------- |
+| left | [Length](#length) | 否 | 组件图像左边沿扩展距离。 |
+| right | [Length](#length) | 否 | 组件图像右边沿像素扩展距离。 |
+| top | [Length](#length) | 否 | 组件图像上边沿像素扩展距离。 |
| bottom | [Length](#length) | 否 | 组件图像下边沿像素扩展距离。 |
## ModalTransition10+
全屏模态转场方式枚举类型,用于设置全屏模态转场类型。
-| 名称 | 描述 |
-| --------- | ------- |
-| None | 全屏模态无转场动画。 |
-| Default | 全屏模态上下切换动画。 |
-| Alpha | 全屏模态透明度渐变动画。 |
\ No newline at end of file
+| 名称 | 描述 |
+| ------- | ------------ |
+| None | 全屏模态无转场动画。 |
+| Default | 全屏模态上下切换动画。 |
+| Alpha | 全屏模态透明度渐变动画。 |
\ No newline at end of file
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 5a2b9b53f2d27ff44773cb54118b39094ef76172..56b6a74004dd87f289ee82996ee06f903c51bdb7 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
@@ -10,10 +10,10 @@
## 属性
-| 名称 | 参数说明 | 描述 |
-| -------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
-| width | [Length](ts-types.md#length) | 设置组件自身的宽度,缺省时使用元素自身内容需要的宽度。若子组件的宽大于父组件的宽,则会画出父组件的范围。
从API version 9开始,该接口支持在ArkTS卡片中使用。
从API version 10开始,该接口支持calc计算特性。 |
-| height | [Length](ts-types.md#length) | 设置组件自身的高度,缺省时使用元素自身内容需要的高度。若子组件的高大于父组件的高,则会画出父组件的范围。
从API version 9开始,该接口支持在ArkTS卡片中使用。
从API version 10开始,该接口支持calc计算特性。 |
+| 名称 | 参数说明 | 描述 |
+| -------------- | ---------------------------------------- | ---------------------------------------- |
+| width | [Length](ts-types.md#length) | 设置组件自身的宽度,缺省时使用元素自身内容需要的宽度。若子组件的宽大于父组件的宽,则会画出父组件的范围。
从API version 9开始,该接口支持在ArkTS卡片中使用。
从API version 10开始,该接口支持calc计算特性。 |
+| height | [Length](ts-types.md#length) | 设置组件自身的高度,缺省时使用元素自身内容需要的高度。若子组件的高大于父组件的高,则会画出父组件的范围。
从API version 9开始,该接口支持在ArkTS卡片中使用。
从API version 10开始,该接口支持calc计算特性。 |
| size | {
width?: [Length](ts-types.md#length),
height?: [Length](ts-types.md#length)
} | 设置高宽尺寸。
从API version 9开始,该接口支持在ArkTS卡片中使用。
从API version 10开始,该接口支持calc计算特性。 |
| padding | [Padding](ts-types.md#padding) \| [Length](ts-types.md#length) | 设置内边距属性。
参数为Length类型时,四个方向内边距同时生效。
默认值:0
padding设置百分比时,上下左右内边距均以父容器的width作为基础值。
从API version 9开始,该接口支持在ArkTS卡片中使用。
从API version 10开始,该接口支持calc计算特性。 |
| margin | [Margin](ts-types.md#margin) \| [Length](ts-types.md#length) | 设置外边距属性。
参数为Length类型时,四个方向外边距同时生效。
默认值:0
margin设置百分比时,上下左右外边距均以父容器的width作为基础值。
从API version 9开始,该接口支持在ArkTS卡片中使用。
从API version 10开始,该接口支持calc计算特性。 |
@@ -21,14 +21,14 @@
## constraintSize取值对width/height影响
-|大小排列|结果|
-|-----|------|
-|minWidth/minHeight < width/height< maxWidth/maxHeight|width/height|
-|minWidth/minHeight < maxWidth/maxHeight < width/height| maxWidth/maxHeight|
-|maxWidth/maxHeight < minWidth/minHeight < width/height| minWidth/minHeight|
-|maxWidth/maxHeight < width/height< minWidth/minHeight| minWidth/minHeight|
-|width/height < maxWidth/maxHeight < minWidth/minHeight| minWidth/minHeight|
-|width/height < minWidth/minHeight < maxWidth/maxHeight| minWidth/minHeight|
+| 大小排列 | 结果 |
+| ---------------------------------------- | ------------------ |
+| minWidth/minHeight < width/height< maxWidth/maxHeight | width/height |
+| minWidth/minHeight < maxWidth/maxHeight < width/height | maxWidth/maxHeight |
+| maxWidth/maxHeight < minWidth/minHeight < width/height | minWidth/minHeight |
+| maxWidth/maxHeight < width/height< minWidth/minHeight | minWidth/minHeight |
+| width/height < maxWidth/maxHeight < minWidth/minHeight | minWidth/minHeight |
+| width/height < minWidth/minHeight < maxWidth/maxHeight | minWidth/minHeight |
## 示例
```ts
diff --git a/zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-syntax-css.md b/zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-syntax-css.md
index 809c934f24978bb4ef2350a1be405676b9174d34..73d3376deb8aa579b4d690ddd985c2df84dcfc0d 100644
--- a/zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-syntax-css.md
+++ b/zh-cn/application-dev/reference/js-service-widget-ui/js-service-widget-syntax-css.md
@@ -23,7 +23,7 @@ CSS是描述HML页面结构的样式语言。所有组件均存在系统默认
每个页面目录下存在一个与布局hml文件同名的css文件,用来描述该hml页面中组件的样式,决定组件应该如何显示。
1. 内部样式,支持使用style、class属性来控制组件的样式。例如:
-
+
```html
@@ -31,7 +31,7 @@ CSS是描述HML页面结构的样式语言。所有组件均存在系统默认
```
-
+
```css
/* index.css */
.container {
@@ -40,7 +40,7 @@ CSS是描述HML页面结构的样式语言。所有组件均存在系统默认
```
2. 文件导入,合并外部样式文件。例如,在common目录中定义样式文件style.css,并在index.css中进行导入:
-
+
```css
/* style.css */
.title {
@@ -48,7 +48,7 @@ CSS是描述HML页面结构的样式语言。所有组件均存在系统默认
}
```
-
+
```css
/* index.css */
@import '../../common/style.css';
@@ -62,10 +62,10 @@ CSS是描述HML页面结构的样式语言。所有组件均存在系统默认
css选择器用于选择需要添加样式的元素,支持的选择器如下表所示:
-| 选择器 | 样例 | 样例描述 |
-| -------- | -------- | -------- |
+| 选择器 | 样例 | 样例描述 |
+| ------ | ---------- | ------------------------- |
| .class | .container | 用于选择class="container"的组件。 |
-| \#id | \#titleId | 用于选择id="titleId"的组件。 |
+| \#id | \#titleId | 用于选择id="titleId"的组件。 |
示例:
diff --git a/zh-cn/application-dev/ui/arkts-common-components-button.md b/zh-cn/application-dev/ui/arkts-common-components-button.md
index 08a05ae17b2bbe6319e71977ab261e5a60153a5a..cbea2f3c17714f2bc637d1318095039f063640d1 100644
--- a/zh-cn/application-dev/ui/arkts-common-components-button.md
+++ b/zh-cn/application-dev/ui/arkts-common-components-button.md
@@ -156,6 +156,7 @@ Button('Ok', { type: ButtonType.Normal, stateEffect: true })
## 场景示例
- 用于启动操作。
+
可以用按钮启动任何用户界面元素,按钮会根据用户的操作触发相应的事件。例如,在List容器里通过点击按钮进行页面跳转。
```ts
@@ -195,6 +196,7 @@ Button('Ok', { type: ButtonType.Normal, stateEffect: true })
- 用于表单的提交。
+
在用户登录/注册页面,使用按钮进行登录或注册操作。
```ts
@@ -218,6 +220,7 @@ Button('Ok', { type: ButtonType.Normal, stateEffect: true })

- 悬浮按钮
+
在可以滑动的界面,滑动时按钮始终保持悬浮状态。
```ts
@@ -258,4 +261,4 @@ Button('Ok', { type: ButtonType.Normal, stateEffect: true })
}
```
- 
+ 
diff --git a/zh-cn/application-dev/ui/figures/GIF.gif b/zh-cn/application-dev/ui/figures/floating_button.gif
similarity index 100%
rename from zh-cn/application-dev/ui/figures/GIF.gif
rename to zh-cn/application-dev/ui/figures/floating_button.gif