NavDestination

作为子页面的根容器,用于显示Navigation的内容区。

说明:

该组件从API Version 9开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

子组件

说明:

  • 子组件类型:系统组件和自定义组件,支持渲染控制类型(if/elseForEachLazyForEach)。
  • 子组件个数:多个。

接口

NavDestination()

属性

仅支持backgroundColor通用属性。

名称 参数类型 描述
title string | CustomBuilder | NavigationCommonTitle | NavigationCustomTitle 页面标题。
说明:
使用NavigationCustomTitle类型设置height高度时,titleMode属性不会生效。
字符串超长时,如果不设置副标题,先缩小再换行2行后以...截断。如果设置副标题,先缩小后以...截断。
hideTitleBar boolean 是否显示标题栏。
默认值:false
true: 隐藏标题栏。
false: 显示标题栏。

事件

除支持通用事件外,还支持如下事件:

名称 功能描述
onShown(callback: () => void)10+ 当该NavDestination页面显示时触发此回调。
onHidden(callback: () => void)10+ 当该NavDestination页面隐藏时触发此回调。
onBackPressed(callback: () => boolean)10+ 当与Navigation绑定的页面栈中存在内容时,此回调生效。
当点击返回键时,触发该回调。
返回值为true时,表示重写返回键逻辑,返回值为false时,表示回退到上一个页面。

示例

从API Version 9开始,详见NavRouter组件示例

从API Version 10开始,详见NavPathStack示例