diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-router.md b/zh-cn/application-dev/reference/apis/js-apis-system-router.md index 4f2d3e9c136268dfa8147a38f5ea54f7b4ba61bd..ee3167d8c5a5058aa854ef4de817262409acd242 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-router.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-router.md @@ -374,12 +374,12 @@ export default { **系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full -| 名称 | 参数类型 | 必填 | 说明 | -| -------- | ------------------------ | ---- | ------------------------- | -| message | string | 是 | 询问对话框内容。 | -| success | (errMsg: string) => void | 否 | 弹出对话框时调用，errMsg表示返回信息。 | -| fail | (errMsg: string) => void | 否 | 接口调用失败的回调函数，errMsg表示返回信息。 | -| complete | () => void | 否 | 接口调用结束的回调函数。 | +| 名称 | 参数类型 | 必填 | 说明 | +| -------- | ------------------------ | ---- | -------------------------------------------------- | +| message | string | 是 | 询问对话框内容。 | +| success | (errMsg: string) => void | 否 | 用户选择对话框确认按钮时触发，errMsg表示返回信息。 | +| cancel | (errMsg: string) => void | 否 | 用户选择对话框取消按钮时触发，errMsg表示返回信息。 | +| complete | () => void | 否 | 接口调用结束的回调函数。 | ## DisableAlertBeforeBackPageOptions6+ @@ -387,11 +387,11 @@ export default { **系统能力：** 以下各项对应的系统能力均为SystemCapability.ArkUI.ArkUI.Full -| 名称 | 参数类型 | 必填 | 说明 | -| -------- | ------------------------ | ---- | ------------------------- | -| success | (errMsg: string) => void | 否 | 弹出对话框时调用，errMsg表示返回信息。 | -| fail | (errMsg: string) => void | 否 | 接口调用失败的回调函数，errMsg表示返回信息。 | -| complete | () => void | 否 | 接口调用结束的回调函数。 | +| 名称 | 参数类型 | 必填 | 说明 | +| -------- | ------------------------ | ---- | -------------------------------------------------- | +| success | (errMsg: string) => void | 否 | 关闭询问对话框能力成功时触发，errMsg表示返回信息。 | +| cancel | (errMsg: string) => void | 否 | 关闭询问对话框能力失败时触发，errMsg表示返回信息。 | +| complete | () => void | 否 | 接口调用结束的回调函数。 | ## ParamsInterface diff --git a/zh-cn/application-dev/reference/arkui-js/js-components-custom-lifecycle.md b/zh-cn/application-dev/reference/arkui-js/js-components-custom-lifecycle.md index cc3df2f58e4dbcd02f394b23450733ef0619d0a9..ecb22b4bc241b5811fd4bded4893d9f8f18d361a 100644 --- a/zh-cn/application-dev/reference/arkui-js/js-components-custom-lifecycle.md +++ b/zh-cn/application-dev/reference/arkui-js/js-components-custom-lifecycle.md @@ -7,15 +7,15 @@ 我们为自定义组件提供了一系列生命周期回调方法，便于开发者管理自定义组件的内部逻辑。生命周期主要包括：onInit，onAttached，onDetached，onLayoutReady，onDestroy，onPageShow和onPageHide。下面我们依次介绍一下各个生命周期回调的时机。 -| 属性 | 类型 | 描述 | 触发时机 | -| ------------- | -------- | ----------- | ---------------------------------------- | -| onInit | Function | 初始化自定义组件 | 自定义组件初始化生命周期回调，当自定义组件创建时，触发该回调，主要用于自定义组件中必须使用的数据初始化，该回调只会触发一次调用。 | +| 属性 | 类型 | 描述 | 触发时机 | +| ------------- | -------- | ------------------ | ------------------------------------------------------------ | +| onInit | Function | 初始化自定义组件 | 自定义组件初始化生命周期回调，当自定义组件创建时，触发该回调，主要用于自定义组件中必须使用的数据初始化，该回调只会触发一次调用。 | | onAttached | Function | 自定义组件装载 | 自定义组件被创建后，加入到Page组件树时，触发该回调，该回调触发时，表示组件将被进行显示，该生命周期可用于初始化显示相关数据，通常用于加载图片资源、开始执行动画等场景。 | -| onLayoutReady | Function | 自定义组件布局完成 | 自定义组件插入Page组件树后，将会对自定义组件进行布局计算，调整其内容元素尺寸与位置，当布局计算结束后触发该回调。 | -| onDetached | Function | 自定义组件摘除 | 自定义组件摘除时，触发该回调，常用于停止动画或异步逻辑停止执行的场景。 | -| onDestroy | Function | 自定义组件销毁 | 自定义组件销毁时，触发该回调，常用于资源释放。 | -| onPageShow | Function | 自定义组件Page显示 | 自定义组件所在Page显示后，触发该回调。 | -| onPageHide | Function | 自定义组件Page隐藏 | 自定义组件所在Page隐藏后，触发该回调。 | +| onLayoutReady | Function | 自定义组件布局完成 | 自定义组件插入Page组件树后，将会对自定义组件进行布局计算，调整其内容元素尺寸与位置，当布局计算结束后触发该回调。 | +| onDetached | Function | 自定义组件摘除 | 自定义组件摘除时，触发该回调，常用于停止动画或异步逻辑停止执行的场景。 | +| onDestroy | Function | 自定义组件销毁 | 自定义组件销毁时，触发该回调，常用于资源释放。 | +| onShow | Function | 自定义组件Page显示 | 自定义组件所在Page显示后，触发该回调。 | +| onHide | Function | 自定义组件Page隐藏 | 自定义组件所在Page隐藏后，触发该回调。 | ## 示例 @@ -42,10 +42,10 @@ export default { onDetached() { this.value = "" }, - onPageShow() { + onShow() { console.log("Page显示") }, - onPageHide() { + onHide() { console.log("Page隐藏") } } diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pangesture.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pangesture.md index f2b094307eb23c403c4f648af1a96d61dfb36cb7..7939fba7352e40b25d9ee36f2dfa937eb95a0972 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pangesture.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-gestures-pangesture.md @@ -20,7 +20,7 @@ PanGesture(options?: { fingers?: number, direction?: PanDirection, distance?: nu | -------- | -------- | -------- | -------- | -------- | | fingers | number | 否 | 1 | 触发滑动的最少手指数，最小为1指， 最大取值为10指。 | | direction | PanDirection | 否 | All | 设置滑动方向，此枚举值支持逻辑与(&)和逻辑或（\|）运算。 | - | distance | number | 否 | 5.0 | 最小滑动识别距离，单位为vp。 | + | distance | number | 否 | 5.0 | 最小滑动识别距离，单位为vp。
**说明：**
> tab滑动与该拖动手势事件同时存在时，可将distance值设为1，使拖动更灵敏，避免造成事件错乱。 | - PanDirection枚举说明 | 名称 | 描述 | diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-grid.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-grid.md index 33bf7bb58f141752048bb1e30877f4346ac801fb..0401d38367b3c09f8174606908984252e272e7bd 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-grid.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-grid.md @@ -20,7 +20,7 @@ ## 接口 -Grid(value:{scroller?: Scroller}) +Grid(scroller?: Scroller) - 参数 | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-list.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-list.md index d756e0ac5fcec68c24af72cadab277a4b6bf0c61..34102de39f2434a91437ac29a5f120119a4187aa 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-list.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-list.md @@ -1,7 +1,9 @@ # List > **说明：** -> 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 +> +> - 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 +> - 该组件回弹的前提是要有滚动。内容小于一屏时，没有回弹效果。 列表包含一系列相同宽度的列表项。适合连续、多行呈现同类数据，例如图片和文本。 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md index 3f2a4faffe3fab95adc83ca860e5c757e59e2a5a..72792ad454d0aed28fa9b4a6ae51c8fd54c48a5b 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md @@ -1,8 +1,9 @@ # Scroll > **说明：** -> - 该组件从API version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 -> - 该组件嵌套List子组件滚动时，若List不设置宽高，则默认全部加载，在对性能有要求的场景下建议指定List的宽高。 +> - 该组件从API version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 +> - 该组件嵌套List子组件滚动时，若List不设置宽高，则默认全部加载，在对性能有要求的场景下建议指定List的宽高。 +> - 该组件回弹的前提是要有滚动。内容小于一屏时，没有回弹效果。 可滚动的容器组件，当子组件的布局尺寸超过父组件的视口时，内容可以滚动。 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 ba5a8047dcf53ccec1e2a3bb6cdb824f7ae8b87d..baf16cb7ff9ba8ed80e75e93ad5ef9eb8f344ec9 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 @@ -15,7 +15,7 @@ 无 -# 接口 +## 接口 Path(value?: { width?: number | string; height?: number | string; commands?: string }) 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 b01a7f2515243a94ada35d211cba355e5fe368c0..8634db63c4621927e776bacd531b4368b7983317 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 @@ -4,7 +4,7 @@ > 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 -通过CustomDialogController类显示自定义弹窗。 +通过CustomDialogController类显示自定义弹窗。使用弹窗组件时，可优先考虑自定义弹窗，便于自定义弹窗的样式与内容。 ## 接口 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 d453fccbf7e28e42ba94543632911fefef5db5a7..cefa991c4e730c86ac24f0fd4d2df86da92b815a 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 @@ -18,9 +18,9 @@ | -------- | -------- | -------- | -------- | -------- | | 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
} | - | 否 | 设置组件转场时的缩放效果，为插入时起点和删除时终点的值。
**说明：**
> 中心点为0时，默认的是组件的左上角
> centerX、centerY设置百分比时，是基于自身布局的尺寸缩放的 | - | rotate | {
x?: number,
y?: number,
z?: number,
angle?: Angle,
centerX?: Length,
centerY?: Length
} | - | 否 | 设置组件转场时的旋转效果，为插入时起点和删除时终点的值。
**说明：**
> 中心点为0时，默认的是组件的左上角 | + | translate | {
x? : number,
y? : number,
z? : number
} | - | 否 | 设置组件转场时的平移效果，为插入时起点和删除时终点的值。
**说明：**
> x、y、z分别是横向、纵向、竖向的平移距离 | + | scale | {
x? : number,
y? : number,
z? : number,
centerX? : number,
centerY? : number
} | - | 否 | 设置组件转场时的缩放效果，为插入时起点和删除时终点的值。
**说明：**
> x、y、z分别是横向、纵向、竖向放大倍数（或缩小到原来的多少）
> centerX、centerY缩放中心点
> 中心点为0时，默认的是组件的左上角
| + | rotate | {
x?: number,
y?: number,
z?: number,
angle?: Angle,
centerX?: Length,
centerY?: Length
} | - | 否 | 设置组件转场时的旋转效果，为插入时起点和删除时终点的值。
**说明：**
> x、y、z分别是横向、纵向、竖向的旋转向量
> centerX,centerY指旋转中心点
> 中心点为0时，默认的是组件的左上角 | - TransitionType枚举说明 | 名称 | 描述 | diff --git a/zh-cn/application-dev/ui/ui-ts-layout-mediaquery.md b/zh-cn/application-dev/ui/ui-ts-layout-mediaquery.md index 85b9d19fd65520302a9889724eb4e69f86f915ab..a57eebc7332161fec6af29482d70de9c769c4b70 100644 --- a/zh-cn/application-dev/ui/ui-ts-layout-mediaquery.md +++ b/zh-cn/application-dev/ui/ui-ts-layout-mediaquery.md @@ -43,9 +43,9 @@ listener.on('change', onPortrait) `(max-height: 800)` ：当高度小于800时条件成立 -`(height <= 800) ` ：当高度小于800时条件成立 +`(height <= 800) ` ：当高度小于等于800时条件成立 -`screen and (device-type: tv) or (resolution < 2)` ：包含多个媒体特征的多条件复杂语句查询 +`screen and (device-type: tv) or (resolution < 2)` ：包含多个媒体特征的多条件复杂语句查询 ### 媒体类型(media-type)