8 工具栏

原文链接: https://developer.apple.com/documentation/swiftui/toolbars

8 工具栏

为常用命令和控件提供即时访问入口。

概述

依据平台和上下文的不同，系统可能把工具栏放在应用内容的上方或下方。

通过把 toolbar(content:) 视图修饰符应用到应用中的某个视图上，为工具栏添加条目。你也可以用视图修饰符配置工具栏，例如用 toolbar(_:for:) 修饰符设置工具栏的可见性。

关于设计指导，参见 Human Interface Guidelines 中的工具栏。

填充工具栏

• toolbar(content:) —— 用指定的条目填充工具栏或导航栏。
• ToolbarItem —— 表示可以放进工具栏或导航栏的条目的模型。
• ToolbarItemGroup —— 表示可以放进工具栏或导航栏的一组 ToolbarItem 的模型。
• ToolbarItemPlacement —— 定义工具栏项放置位置的结构体。
• toolbarOverflowMenu(content:) —— 配置工具栏的溢出菜单。
• ToolbarOverflowMenu —— 工具栏的溢出菜单。
• ToolbarContent —— 遵循该协议的类型表示可以放在工具栏中各个位置的条目。
• ToolbarContentBuilder —— 从多表达式闭包构造工具栏项集合。
• ToolbarSpacer —— 工具栏中的标准间隔项。
• DefaultToolbarItem —— 表示某个系统组件的工具栏项。

填充可自定义的工具栏

• toolbar(id:content:) —— 用指定的条目填充工具栏或导航栏，并允许用户自定义。
• toolbarItemHidden(_:) —— 在控件组工具栏项中隐藏某个视图。
• CustomizableToolbarContent —— 遵循该协议的类型表示可以放在可自定义工具栏中各个位置的条目。
• ToolbarCustomizationBehavior —— 可自定义工具栏内容的自定义行为。
• ToolbarCustomizationOptions —— 影响可自定义工具栏内容默认自定义行为的选项。
• SearchToolbarBehavior —— 搜索框在工具栏中的行为。

移除默认条目

• toolbar(removing:) —— 移除默认存在的工具栏项
• ToolbarDefaultItemKind —— View 默认添加的工具栏项的种类。

设置工具栏可见性

• toolbar(_:for:) —— 指定由 SwiftUI 管理的某个栏的可见性。
• toolbarVisibility(_:for:) —— 指定由 SwiftUI 管理的某个栏的可见性。
• toolbarBackgroundVisibility(_:for:) —— 指定由 SwiftUI 管理的某个栏上背景的偏好可见性。
• ToolbarPlacement —— 工具栏的放置位置。
• ContentToolbarPlacement

指定工具栏内容的角色

• toolbarRole(_:) —— 为填充工具栏的内容配置语义角色。
• ToolbarRole —— 填充工具栏的内容的用途。

设置工具栏样式

• toolbarBackground(_:for:) —— 指定由 SwiftUI 管理的某个栏背景的偏好形状样式。
• toolbarColorScheme(_:for:) —— 指定由 SwiftUI 管理的某个栏的偏好配色方案。
• toolbarForegroundStyle(_:for:) —— 指定由 SwiftUI 管理的各个栏的偏好前景样式。
• windowToolbarStyle(_:) —— 设置该场景内所定义工具栏的样式。
• WindowToolbarStyle —— 对窗口工具栏外观与行为的规范说明。
• toolbarLabelStyle —— 要应用于工具栏内各控件的标签样式。
• ToolbarLabelStyle —— 工具栏的标签样式。
• SpacerSizing —— 定义间隔元素应如何确定自身大小的类型。

配置工具栏标题显示模式

• toolbarTitleDisplayMode(_:) —— 为该视图配置工具栏标题显示模式。
• ToolbarTitleDisplayMode —— 定义工具栏标题行为的类型。

设置工具栏标题菜单

• toolbarTitleMenu(content:) —— 配置工具栏的标题菜单。
• ToolbarTitleMenu —— 工具栏的标题菜单。

创建装饰件

• ornament(visibility:attachmentAnchor:contentAlignment:ornament:) —— 呈现一个装饰件。
• OrnamentAttachmentAnchor —— 装饰件的附着锚点。

控制条目可见性

• visibilityPriority(_:) —— 定义某个工具栏项的可见性优先级。
• ToolbarItemVisibilityPriority —— 定义工具栏项可见性优先级的值。

最小化工具栏

• toolbarMinimizationBehavior(_:for:) —— 为指定的栏设置最小化行为。
• ToolbarMinimizationBehavior —— 工具栏的最小化行为。
• toolbarMinimizationRestoration(_:for:) —— 为指定的栏设置最小化期间的恢复行为。
• ToolbarMinimizationRestoration —— 工具栏最小化期间的恢复行为。
• toolbarMinimizationSafeAreaAdjustment(_:for:) —— 为指定的栏设置最小化期间的安全区域调整。
• ToolbarMinimizationSafeAreaAdjustment —— 工具栏最小化期间的安全区域调整。