1.7 辅助视图修饰符

原文链接: https://developer.apple.com/documentation/swiftui/view-auxiliary-views

1.7 辅助视图修饰符

添加并配置工具栏、上下文菜单之类的辅助视图。

概述

用这些修饰符管理呈现上下文相关控件和信息的辅助视图。例如，你可以向导航栏添加标题和按钮、管理状态栏、创建上下文菜单，以及为许多不同种类的视图添加角标。

导航标题

• 配置应用的导航标题 —— 用导航标题显示界面当前的导航状态。
• navigationTitle(_:) —— 用本地化字符串资源为该视图配置用于导航的标题。
• navigationSubtitle(_:) —— 用本地化字符串资源为该视图配置用于导航的副标题。

导航标题配置

• navigationDocument(_:) —— 为该视图配置用于导航的文稿。
• navigationDocument(_:preview:) —— 为该视图配置用于导航的文稿。

导航栏

• navigationBarBackButtonHidden(_:) —— 为该视图隐藏导航栏的返回按钮。
• navigationBarTitleDisplayMode(_:) —— 为该视图配置标题显示模式。

导航栈与栏

• navigationDestination(for:destination:) —— 在导航栈中，把目标视图与所呈现的数据类型关联起来。
• navigationDestination(isPresented:destination:) —— 把目标视图与一个绑定关联起来，用该绑定把视图推入 NavigationStack。
• navigationDestination(item:destination:) —— 在导航栈或导航分栏视图中，把目标视图与某个绑定值关联起来
• navigationSplitViewColumnWidth(_:) —— 为包含该视图的那一栏设置固定的偏好宽度。
• navigationSplitViewColumnWidth(min:ideal:max:) —— 为包含该视图的那一栏设置灵活的偏好宽度。
• navigationLinkIndicatorVisibility(_:) —— 配置导航链接是否显示展开指示符。
• navigationTransition(_:) —— 为该视图设置导航过渡样式。

滚动视图边缘

• scrollEdgeEffectStyle(_:for:) —— 为该层级中可滚动视图配置滚动边缘效果样式。
• scrollEdgeEffectHidden(_:for:) —— 隐藏该层级中可滚动视图的滚动边缘效果。

标签页视图

• defaultAdaptableTabBarPlacement(_:) —— 为使用可自适应侧边栏样式的标签页视图指定标签页的默认放置位置。
• defaultTabBarPlacement(_:) —— 在标签栏无法在不同呈现形式之间自适应、只能显示一种形式的平台上，为 sidebarAdaptable 样式的 TabView 中的标签页指定偏好的放置位置。
• sectionActions(content:) —— 为某个分区添加自定义操作。
• tabBarMinimizeBehavior(_:) —— 设置标签栏最小化的行为。
• tabViewBottomAccessory(content:) —— 把某个视图放置为标签页视图的底部配件。
• tabViewBottomAccessory(isEnabled:content:) —— 把某个视图放置为标签页视图的底部配件。用这个修饰符动态显示和隐藏该配件视图。
• tabViewCustomization(_:) —— 指定要应用到标签页视图侧边栏呈现形式上的自定义项。
• tabViewSearchActivation(_:) —— 配置搜索标签页中搜索的激活与取消激活行为。
• tabViewSidebarHeader(content:) —— 为标签页视图的侧边栏添加自定义页眉。
• tabViewSidebarFooter(content:) —— 为标签页视图的侧边栏添加自定义页脚。
• tabViewSidebarBottomBar(content:) —— 为标签页视图的侧边栏添加自定义底栏。

工具栏

• toolbar(content:) —— 用指定的条目填充工具栏或导航栏。
• toolbar(id:content:) —— 用指定的条目填充工具栏或导航栏，并允许用户自定义。
• toolbar(_:for:) —— 指定由 SwiftUI 管理的某个栏的可见性。
• contentToolbar(for:content:) —— 用你提供的视图填充指定内容视图类型的工具栏。
• toolbar(removing:) —— 移除默认存在的工具栏项
• toolbarVisibility(_:for:) —— 指定由 SwiftUI 管理的某个栏的可见性。
• toolbarBackground(_:for:) —— 指定由 SwiftUI 管理的某个栏背景的偏好形状样式。
• toolbarBackgroundVisibility(_:for:) —— 指定由 SwiftUI 管理的某个栏上背景的偏好可见性。
• toolbarItemHidden(_:) —— 在控件组工具栏项中隐藏某个视图。
• toolbarForegroundStyle(_:for:) —— 指定由 SwiftUI 管理的各个栏的偏好前景样式。
• toolbarColorScheme(_:for:) —— 指定由 SwiftUI 管理的某个栏的偏好配色方案。
• toolbarOverflowMenu(content:) —— 配置工具栏的溢出菜单。
• toolbarRole(_:) —— 为填充工具栏的内容配置语义角色。
• toolbarMinimizationBehavior(_:for:) —— 为指定的栏设置最小化行为。
• toolbarMinimizationRestoration(_:for:) —— 为指定的栏设置最小化期间的恢复行为。
• toolbarMinimizationSafeAreaAdjustment(_:for:) —— 为指定的栏设置最小化期间的安全区域调整。
• toolbarTitleMenu(content:) —— 配置工具栏的标题菜单。
• toolbarTitleDisplayMode(_:) —— 为该视图配置工具栏标题显示模式。
• ornament(visibility:attachmentAnchor:contentAlignment:ornament:) —— 呈现一个装饰件。

上下文菜单

• contextMenu(menuItems:) —— 为视图添加上下文菜单。
• contextMenu(menuItems:preview:) —— 为视图添加带自定义预览的上下文菜单。
• contextMenu(forSelectionType:menu:primaryAction:) —— 为视图添加基于条目的上下文菜单。

角标

• badge(_:) —— 用本地化字符串资源为视图生成角标。
• badgeProminence(_:) —— 指定该视图所创建角标的显著程度。

列表

• sectionIndexLabel(_:) —— 设置分区索引中用来指向该分区的标签，通常只有一个字符长。

帮助文本

• help(_:) —— 用你提供的本地化字符串资源为视图添加帮助文本。

状态栏

• statusBarHidden(_:) —— 设置状态栏的可见性。

外部显示器

• sceneAccessory(content:) —— 定义与 self 关联的任何场景配件。

Touch Bar

• touchBar(content:) —— 设置 Touch Bar 显示的内容。
• touchBar(_:) —— 在适用时设置要在 Touch Bar 中显示的 Touch Bar 内容。
• touchBarItemPrincipal(_:) —— 设置对这个 Touch Bar 有特殊意义的主要视图。
• touchBarCustomizationLabel(_:) —— 设置一个用户可见的字符串，用于标识该视图的功能。
• touchBarItemPresence(_:) —— 设置用户自定义视图的行为。