diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-attributes-sheet-transition.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-attributes-sheet-transition.md index 54a8c9defbc42e30eb16050df7329d81893568f5..0c73f368ec7366b2ad1473dc54f5669425e7d18e 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-attributes-sheet-transition.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-attributes-sheet-transition.md @@ -225,7 +225,7 @@ bindSheet(isShow: Optional\, builder: CustomBuilder, options?: SheetOp | TRANSLATE_AND_RESIZE | 1 | 设置半模态先上抬面板避让软键盘;
当上抬至最大高度仍不足以避让软键盘时,则通过压缩整体内容完成避让。
**原子化服务API:** 从API version 13开始,该接口支持在原子化服务中使用。| | RESIZE_ONLY | 2 | 设置半模态通过压缩整体内容避让软键盘。
**原子化服务API:** 从API version 13开始,该接口支持在原子化服务中使用。| | TRANSLATE_AND_SCROLL | 3 | 设置半模态先上抬面板避让软键盘;
当上抬至最大高度仍不足以避让软键盘时,则通过滚动内容完成避让。
**原子化服务API:** 从API version 13开始,该接口支持在原子化服务中使用。| -| POPUP_SHEET20+ | 4 | 设置半模态popup样式弹窗避让软键盘。
1. 避让软键盘时,在popup样式弹窗当前显示位置无法容纳弹窗尺寸的前提下,遵循先垂直翻转避让,后尝试90°水平旋转避让的规则调整显示位置,以预设方向为下方为例,调整避让顺序依次为:下、上、右、左。
2. 如果设置的对齐方式导致组件布局超出窗口范围,将根据该对齐方式在水平或垂直方向上进行位移,直至组件完全显示在窗口内。
3. 避让软键盘时,如果在四个方向上均无法容纳当前的popup样式弹窗,处理方式遵循开发者设置的placementOnTarget属性:
(1)若属性值为true,将依据设定的placement,向其镜像方向平移,直至弹窗能够完全显示。
(2)若属性值为false,则在四个方向中,选择能够完全展示弹窗宽度且剩余高度最大的方向,通过调整半模态高度以适应当前方向,确保弹窗能够放下,同时保持预设placement对应的对齐方式不变。
**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。| +| POPUP_SHEET20+ | 4 | 设置半模态popup样式弹窗避让软键盘。
1. 避让软键盘时,在popup样式弹窗当前显示位置无法容纳弹窗尺寸的前提下,遵循先垂直翻转避让,后尝试90°水平旋转避让的规则调整显示位置,以预设方向为下方为例,调整避让顺序依次为:下、上、右、左。
2. 如果设置的对齐方式导致组件布局超出窗口范围,将根据该对齐方式在水平或垂直方向上进行位移,直至组件完全显示在窗口内。
3. 避让软键盘时,如果在四个方向上均无法容纳当前的popup样式弹窗,处理方式遵循开发者设置的placementOnTarget属性:
(1)若属性值为true,将依据设定的placement,向其镜像方向平移,直至弹窗能够完全显示。
(2)若属性值为false,则在四个方向中,选择能够完全展示弹窗宽度且剩余高度最大的方向,通过调整半模态高度以适应当前方向,确保弹窗能够放下,同时保持预设placement对应的对齐方式不变。
4. 若此时半模态不是跟手样式,则不具备避让软键盘能力。
**原子化服务API:** 从API version 20开始,该接口支持在原子化服务中使用。| > **说明:** > diff --git a/zh-cn/application-dev/ui/arkts-navigation-introduction.md b/zh-cn/application-dev/ui/arkts-navigation-introduction.md index 16443631c61640cbfc5c1ec50ccac15ef6c388ef..3879f09334046599242b4893b1dd9cbc083d8bd9 100644 --- a/zh-cn/application-dev/ui/arkts-navigation-introduction.md +++ b/zh-cn/application-dev/ui/arkts-navigation-introduction.md @@ -1,6 +1,6 @@ # 组件导航和页面路由概述 -页面是指由控件、布局、视觉元素等构成的可视化交互单元,承载着特定功能逻辑与信息展示,是用户与应用进行操作交互的核心界面载体。一个完整的应用往往由多个页面组成,组件导航(Navigation)和页面路由(@ohos.router)均提供了应用内的页面跳转能力。 +页面是指由布局、组件、交互逻辑等构成的可视化交互单元,承载着特定功能逻辑与信息展示,是用户与应用进行操作交互的核心界面载体。一个完整的应用往往由多个页面组成,组件导航(Navigation)和页面路由(@ohos.router)均提供了应用内的页面跳转能力。 - 在组件导航(Navigation)框架下,“页面”通过NavDestination组件承载,特指一个NavDestination组件包含的内容。 - 在页面路由(@ohos.router)框架下,“页面”特指@Entry装饰的自定义组件。