导航视图修饰符#

Scripting App 提供了一组用于配置导航行为的视图修饰符，允许开发者控制页面标题的展示内容与样式，并自定义返回按钮的显示与否。这些修饰符与 SwiftUI 中的导航系统高度一致，适用于导航栈中的任意视图。

navigationTitle#

1navigationTitle?: string | VirtualNode

设置当前视图在导航栏中显示的标题。

说明#

• 在 iOS 中，当视图被嵌套在导航栈中时，所设置的标题将显示在导航栏中。
• 在 iPadOS 中，主导航目的地的标题也会在多任务切换界面中显示为窗口的标题。

使用方式#

可传入字符串（string）用于简单标题，或传入 VirtualNode（如 Text）以实现更复杂的格式控制。

navigationBarTitleDisplayMode#

1navigationBarTitleDisplayMode?: NavigationBarTitleDisplayMode

设置导航栏标题的展示样式。

枚举类型：NavigationBarTitleDisplayMode#

1type NavigationBarTitleDisplayMode = "automatic" | "large" | "inline"

• automatic：系统根据上下文自动选择合适的标题样式。
• large：以大标题样式显示，通常用于导航栈的根视图。
• inline：将标题与导航栏控件同行显示，采用紧凑布局。

navigationBarBackButtonHidden#

1navigationBarBackButtonHidden?: boolean

控制是否隐藏默认的导航栏返回按钮。

说明#

• 设为 true 时，系统将不显示默认的返回按钮。
• 适用于需要自定义返回行为，或禁止用户返回的界面场景。

示例#

1<VStack
2  navigationTitle={"个人资料"}
3  navigationBarTitleDisplayMode={"inline"}
4  navigationBarBackButtonHidden={true}
5>
6  <Text>欢迎来到个人资料页面</Text>
7</VStack>

在该示例中：

• 设置视图标题为 "个人资料"，并展示在导航栏中。
• 标题采用 inline 紧凑样式。
• 默认的返回按钮被隐藏。