NavDestination
作为子页面的根容器,用于显示Navigation的内容区。
说明:
该组件从API Version 9开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
子组件
说明:
- 子组件类型:系统组件和自定义组件,支持渲染控制类型(if/else、ForEach和LazyForEach)。
- 子组件个数:多个。
接口
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示例。