diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-navigation.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-navigation.md index 32548953c2cce04d3ee87a054a1fc999373c249a..b445868e846fd3b876afb35d73d60432cb277314 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-navigation.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-navigation.md @@ -1718,7 +1718,7 @@ Navigation自定义标题。 | 名称 | 说明 | | ----- | ------------------------------------------------------------ | | Stack | 导航栏与内容区独立显示，相当于两个页面。 | -| Split | 导航栏与内容区分两栏显示。
以下navBarWidthRange的值用[minNavBarWidth,maxNavBarWidth]表示
1.当navBarWidth属性的值，在navBarWidthRange属性的值范围以外时，navBarWidth按如下规则显示：
navBarWidth < minNavBarWidth时，navBarWidth修正为minNavBarWidth;
navBarWidth > maxNavBarWidth，且组件宽度 - minContentWidth - 分割线宽度(1vp) > maxNavBarWidth时，navBarWidth修正为maxNavBarWidth;
navBarWidth > maxNavBarWidth，且组件宽度 - minContentWidth - 分割线宽度(1vp) < minNavBarWidth时，navBarWidth修正为minNavBarWidth;
navBarWidth > maxNavBarWidth，且组件宽度 - minContentWidth - 分割线宽度(1vp)在navBarWidthRange范围内，navBarWidth修正为组件宽度 - 分割线宽度(1vp) - minContentWidth。
2.当navBarWidth属性的值，在navBarWidthRange属性的值范围以内时，navBarWidth按如下规则显示：
minNavBarWidth + minContentWidth + 分割线宽度(1vp) >= 组件宽度时，navBarWidth修正为minNavBarWidth；
minNavBarWidth + minContentWidth + 分割线宽度(1vp) < 组件宽度，且navBarWidth + minContentWidth + 分割线宽度(1vp) >= 组件宽度时，navBarWidth修正为组件宽度 - 分割线宽度(1vp) - minContentWidth;
minNavBarWidth + minContentWidth + 分割线宽度(1vp) < 组件宽度，且navBarWidth + minContentWidth + 分割线宽度(1vp) < 组件宽度时，navBarWidth为设置的值。
3.缩小组件尺寸时，先缩小内容区的尺寸至minContentWidth，然后再缩小导航栏的尺寸至minNavBarWidth。若继续缩小，先缩小内容区，内容区消失后再缩小导航栏。
4.设置导航栏为固定尺寸时，若持续缩小组件尺寸，导航栏最后压缩显示。
5.若只设置了navBarWidth属性，则导航栏宽度为navBarWidth，且分割线不可拖动。
6.分割线的热区左右各2vp，建议避让4vp以上。
7.Split模式下，内容区若只存在一个页面，则页面左上角不会显示返回按钮。 | +| Split | 导航栏与内容区分两栏显示。
以下navBarWidthRange的值用[minNavBarWidth,maxNavBarWidth]表示
1.当navBarWidth属性的值，在navBarWidthRange属性的值范围以外时，navBarWidth按如下规则显示：
navBarWidth < minNavBarWidth时，navBarWidth修正为minNavBarWidth;
navBarWidth > maxNavBarWidth，且组件宽度 - minContentWidth - 分割线宽度(1vp) > maxNavBarWidth时，navBarWidth修正为maxNavBarWidth;
navBarWidth > maxNavBarWidth，且组件宽度 - minContentWidth - 分割线宽度(1vp) < minNavBarWidth时，navBarWidth修正为minNavBarWidth;
navBarWidth > maxNavBarWidth，且组件宽度 - minContentWidth - 分割线宽度(1vp)在navBarWidthRange范围内，navBarWidth修正为组件宽度 - 分割线宽度(1vp) - minContentWidth。
2.当navBarWidth属性的值，在navBarWidthRange属性的值范围以内时，navBarWidth按如下规则显示：
minNavBarWidth + minContentWidth + 分割线宽度(1vp) >= 组件宽度时，navBarWidth修正为minNavBarWidth；
minNavBarWidth + minContentWidth + 分割线宽度(1vp) < 组件宽度，且navBarWidth + minContentWidth + 分割线宽度(1vp) >= 组件宽度时，navBarWidth修正为组件宽度 - 分割线宽度(1vp) - minContentWidth;
minNavBarWidth + minContentWidth + 分割线宽度(1vp) < 组件宽度，且navBarWidth + minContentWidth + 分割线宽度(1vp) < 组件宽度时，navBarWidth为设置的值。
3.缩小组件尺寸时，先缩小内容区的尺寸至minContentWidth，然后再缩小导航栏的尺寸至minNavBarWidth。若继续缩小，先缩小内容区，内容区消失后再缩小导航栏。
4.设置导航栏为固定尺寸时，若持续缩小组件尺寸，导航栏最后压缩显示。
5.若只设置了navBarWidth属性，则导航栏宽度为navBarWidth，且分割线不可拖动。
6.分割线的热区左右各2vp，建议避让4vp以上。
7.Split模式下，内容区若只存在一个页面，则页面左上角不会显示返回按钮。
8.在平板模式下，mode默认为Split模式，页面左上角不会显示返回按钮，如果需要显示返回按钮需要将mode属性固定设置为Stack。 | | Auto | API version 9之前：窗口宽度>=520vp时，采用Split模式显示；窗口宽度<520vp时，采用Stack模式显示。
API version 10及以上：窗口宽度>=600vp时，采用Split模式显示；窗口宽度<600vp时，采用Stack模式显示，600vp等于minNavBarWidth(240vp) + minContentWidth (360vp)。 | ## NavigationOperation11+枚举说明 @@ -2548,9 +2548,9 @@ export struct PageTwo { } ``` ```ts -// CustomNavigationUtils.ets -// 自定义接口，用来保存某个页面相关的转场动画回调和参数 // src/main/pages/CustomNavigationUtils.ets +// 自定义接口，用来保存某个页面相关的转场动画回调和参数 + export interface AnimateCallback { finish: ((isPush: boolean, isExit: boolean) => void | undefined) | undefined; start: ((isPush: boolean, isExit: boolean) => void | undefined) | undefined; diff --git a/zh-cn/application-dev/ui/arkts-navigation-navigation.md b/zh-cn/application-dev/ui/arkts-navigation-navigation.md index e519d0c5d9387b67af4b0ff64415b8835fe8b678..4a1b37c38c3ba563b972641b8bd910e2f01cb1c6 100644 --- a/zh-cn/application-dev/ui/arkts-navigation-navigation.md +++ b/zh-cn/application-dev/ui/arkts-navigation-navigation.md @@ -4,7 +4,7 @@ [Navigation](../reference/apis-arkui/arkui-ts/ts-basic-components-navigation.md)是路由导航的根视图容器，一般作为页面（@Entry）的根容器，包括单栏（Stack）、分栏（Split）和自适应（Auto）三种显示模式。Navigation组件适用于模块内和跨模块的路由切换，通过组件级路由能力实现更加自然流畅的转场体验，并提供多种标题栏样式来呈现更好的标题和内容联动效果。一次开发，多端部署场景下，Navigation组件能够自动适配窗口显示大小，在窗口较大的场景下自动切换分栏展示效果。 -Navigation组件主要包含​导航页和子页。导航页由标题栏（包含菜单栏）、内容区和工具栏组成，可以通过[hideNavBar](../reference/apis-arkui/arkui-ts/ts-basic-components-navigation.md#hidenavbar9)属性进行隐藏，导航页不存在页面栈中，与子页，以及子页之间可以通过路由操作进行切换。 +Navigation组件主要包含​导航页和子页。导航页由标题栏（包含菜单栏）、内容区和工具栏组成，可以通过[hideNavBar](../reference/apis-arkui/arkui-ts/ts-basic-components-navigation.md#hidenavbar9)属性进行隐藏，导航页不存在[页面栈](../reference/apis-arkui/arkui-ts/ts-basic-components-navigation.md#navpathstack10)中，与子页，以及子页之间可以通过路由操作进行切换。 在API version 9上，Navigation需要配合[NavRouter](../reference/apis-arkui/arkui-ts/ts-basic-components-navrouter.md)组件实现页面路由。从API version 10开始，更推荐使用[NavPathStack](../reference/apis-arkui/arkui-ts/ts-basic-components-navigation.md#navpathstack10)实现页面路由。 @@ -804,7 +804,7 @@ NavDestination之间切换时可以通过[geometryTransition](../reference/apis- | 配置项 | 说明 | |---|---| - | name | 跳转页面名称。| + | name | 可自定义的跳转页面名称。| | pageSourceFile | 跳转目标页在包内的路径，相对src目录的相对路径。| | buildFunction | 跳转目标页的入口函数名称，必须以@Builder修饰。 | | data | 应用自定义字段。可以通过配置项读取接口getConfigInRouteMap获取。|