如何在 swiftUI 生命周期中为三列视图添加工具栏分隔符
how to add a toolbar divider for a three column view in swiftUI life cycle
我正在寻找一种方法来实现像 Mail.app 这样的三列布局的工具栏。 Notes.app 使用几乎相同的工具栏,两个应用程序之间唯一重要的区别是 Notes.app 看起来像 WindowStyle
是 HiddenTitleBarWindowStyle
而 Mail.app 看起来像 Default|TitleBarWindowStyle
.
以下应该是正确的:
- 如果侧边栏已折叠,则会显示列表和详细信息视图
- 将列表与详细视图分开的分界线一直向上穿过工具栏。 (这可以通过
HiddenTitleBarWindowStyle
来实现)
- 如果 Title 太长无法放入导航列表,垂直分界线将被打破:列表仍然像以前一样从 Detail View 中分离出来,但现在 Toolbar 看起来像一个
DefaultWindowStyle
工具栏中只有一条类似于 Divider()
的小线。
我需要 WindowStyle
、WindowToolbarStyle
和 .toolbar
配置的哪种组合才能实现此设置?
编辑
我注意到无法删除 Notes.app 显示的分隔线。不过,我没有在文档中找到对任何此类元素的引用。
代码示例
我已将问题归结为主要包含工具栏内容的简单应用程序。在我的原始代码中,我使用了两个嵌套的 NavigationView
,而对于示例,我只使用了一个 NavigationView
和两个列表。然而 Toolbar
结果是一样的。
带有 DefaultWindowStyle
的工具栏
import SwiftUI
@main
struct ToolbarTestApp: App {
var body: some Scene {
WindowGroup {
ContentView(titleBarIsHidden: true)
}
.windowToolbarStyle(UnifiedWindowToolbarStyle())
.commands {
SidebarCommands()
}
}
}
struct ContentView: View {
@State var destination: String = "Toolbar Test"
@State var detail: String = ""
var body: some View {
NavigationView {
List {
Button(action: {self.destination = "Item with the identifier: 1"}, label: {
Text("Item 1")
})
.buttonStyle(DefaultButtonStyle())
Button(action: {self.destination = "Item 2"}, label: {
Text("Item 2")
})
.buttonStyle(DefaultButtonStyle())
}
.listStyle(SidebarListStyle())
List {
NavigationLink(
destination: DetailView(text: "\(destination) – \(detail)").onAppear{self.detail = "Detail 1"},
label: {
Text("\(destination) – Detail 1")
})
NavigationLink(
destination: DetailView(text: "\(destination) – \(detail)").onAppear{self.detail = "Detail 2"},
label: {
Text("\(destination) – Detail 2")
})
}
.listStyle(InsetListStyle())
Text("\(destination) – \(detail)")
}
.navigationTitle(destination)
.navigationSubtitle(detail)
.toolbar(id: "nav") {
ToolbarItem(id: "plus", placement: ToolbarItemPlacement.principal, showsByDefault: true) {
HStack {
Button(action: {print("pressed")}, label: {
Image(systemName: "plus.circle")
})
}
}
ToolbarItem(id: "spacer", placement: ToolbarItemPlacement.confirmationAction, showsByDefault: true) {
HStack {
Spacer()
}
}
ToolbarItem(id: "sidebar.end", placement: ToolbarItemPlacement.confirmationAction, showsByDefault: true) {
Button(action: {print("pressed")}, label: {
Image(systemName: "sidebar.right")
})
}
}
}
}
此示例将导致 Toolbar
永远不会显示将整个 Toolbar
分成两部分的分隔线。此外,第一个 ToolbarItem
位于 Toolbar
的中心。我尝试了所有 ToolbarItemPlacement
但 none 导致该项目移动到与标题相邻的最左侧。
带有 HiddenTitleBarWindowStyle
的工具栏
@main
struct ToolbarTestApp: App {
var body: some Scene {
WindowGroup {
ContentViewForHiddenTitleBar()
}
.windowStyle(HiddenTitleBarWindowStyle()) // added hidden title style
.windowToolbarStyle(UnifiedWindowToolbarStyle())
.commands {
SidebarCommands()
}
}
}
struct ContentViewForHiddenTitleBar: View {
@State var destination: String = "Toolbar Test"
@State var detail: String = ""
var body: some View {
NavigationView {
List {
Button(action: {self.destination = "Item with the identifier: 1"}, label: {
Text("Item 1")
})
.buttonStyle(DefaultButtonStyle())
Button(action: {self.destination = "Item 2"}, label: {
Text("Item 2")
})
.buttonStyle(DefaultButtonStyle())
}
.listStyle(SidebarListStyle())
// add geometry reader to trim title width in toolbar
GeometryReader { geometry in
List {
NavigationLink(
destination: DetailView(text: "\(destination) – \(detail)").onAppear{self.detail = "Detail 1"},
label: {
Text("\(destination) – Detail 1")
})
NavigationLink(
destination: DetailView(text: "\(destination) – \(detail)").onAppear{self.detail = "Detail 2"},
label: {
Text("\(destination) – Detail 2")
})
}
// there is no title anymore so let's fake it.
.toolbar(id: "list navigation") {
ToolbarItem(id: "title", placement: ToolbarItemPlacement.navigation, showsByDefault: true) {
VStack(alignment: .leading) {
Text(destination)
.font(.headline)
.frame(maxWidth: .infinity, alignment: .leading)
Text(detail)
.font(.subheadline)
.opacity(0.6)
.frame(maxWidth: .infinity, alignment: .leading)
}
.frame(width: geometry.size.width)
}
}
}
.listStyle(InsetListStyle())
Text("\(destination) – \(detail)")
}
.navigationTitle(destination)
.navigationSubtitle(detail)
.toolbar(id: "nav") {
// primary action will place the item next to the divider line.
ToolbarItem(id: "plus", placement: ToolbarItemPlacement.primaryAction, showsByDefault: true) {
HStack {
Button(action: {print("pressed")}, label: {
Image(systemName: "plus.circle")
})
}
}
ToolbarItem(id: "spacer", placement: ToolbarItemPlacement.confirmationAction, showsByDefault: true) {
HStack {
Spacer()
}
}
ToolbarItem(id: "sidebar.end", placement: ToolbarItemPlacement.confirmationAction, showsByDefault: true) {
Button(action: {print("pressed")}, label: {
Image(systemName: "sidebar.right")
})
}
}
}
}
此示例将导致 Toolbar
始终显示全高分隔线。即使标题太长。因此添加了一个GeometryReader
。这很好,直到侧边栏崩溃。 ToolbarItems
的位置将不正确。此外,在自定义 Toolbar
时,可能会删除标题,这应该是不可能的。
默认的标题栏样式就可以了,您只需将工具栏项附加到顶部 NavigationView 的子视图即可,例如:
var body: some View {
NavigationView {
List {
...
}
.listStyle(SidebarListStyle())
.toolbar {
ToolbarItem {
Button(action: { }, label: {
Image(systemName: "sidebar.right")
})
}
}
List {
...
}
.listStyle(InsetListStyle())
.toolbar {
ToolbarItem {
Button(action: { }, label: {
Image(systemName: "plus.circle")
})
}
}
Text("\(destination) – \(detail)")
}
.navigationTitle(destination)
.navigationSubtitle(detail)
}
我没有将任何工具栏项附加到第三列(Text
),但您可以 — 只需确保将相同的工具栏项附加到您的 DetailViews,因为它的工具栏将替换文本的工具栏当用户导航时。 (如果你不确定我的意思,试试看,你很快就会明白我在说什么:)
我正在寻找一种方法来实现像 Mail.app 这样的三列布局的工具栏。 Notes.app 使用几乎相同的工具栏,两个应用程序之间唯一重要的区别是 Notes.app 看起来像 WindowStyle
是 HiddenTitleBarWindowStyle
而 Mail.app 看起来像 Default|TitleBarWindowStyle
.
以下应该是正确的:
- 如果侧边栏已折叠,则会显示列表和详细信息视图
- 将列表与详细视图分开的分界线一直向上穿过工具栏。 (这可以通过
HiddenTitleBarWindowStyle
来实现) - 如果 Title 太长无法放入导航列表,垂直分界线将被打破:列表仍然像以前一样从 Detail View 中分离出来,但现在 Toolbar 看起来像一个
DefaultWindowStyle
工具栏中只有一条类似于Divider()
的小线。
我需要 WindowStyle
、WindowToolbarStyle
和 .toolbar
配置的哪种组合才能实现此设置?
编辑
我注意到无法删除 Notes.app 显示的分隔线。不过,我没有在文档中找到对任何此类元素的引用。
代码示例
我已将问题归结为主要包含工具栏内容的简单应用程序。在我的原始代码中,我使用了两个嵌套的 NavigationView
,而对于示例,我只使用了一个 NavigationView
和两个列表。然而 Toolbar
结果是一样的。
带有 DefaultWindowStyle
的工具栏
import SwiftUI
@main
struct ToolbarTestApp: App {
var body: some Scene {
WindowGroup {
ContentView(titleBarIsHidden: true)
}
.windowToolbarStyle(UnifiedWindowToolbarStyle())
.commands {
SidebarCommands()
}
}
}
struct ContentView: View {
@State var destination: String = "Toolbar Test"
@State var detail: String = ""
var body: some View {
NavigationView {
List {
Button(action: {self.destination = "Item with the identifier: 1"}, label: {
Text("Item 1")
})
.buttonStyle(DefaultButtonStyle())
Button(action: {self.destination = "Item 2"}, label: {
Text("Item 2")
})
.buttonStyle(DefaultButtonStyle())
}
.listStyle(SidebarListStyle())
List {
NavigationLink(
destination: DetailView(text: "\(destination) – \(detail)").onAppear{self.detail = "Detail 1"},
label: {
Text("\(destination) – Detail 1")
})
NavigationLink(
destination: DetailView(text: "\(destination) – \(detail)").onAppear{self.detail = "Detail 2"},
label: {
Text("\(destination) – Detail 2")
})
}
.listStyle(InsetListStyle())
Text("\(destination) – \(detail)")
}
.navigationTitle(destination)
.navigationSubtitle(detail)
.toolbar(id: "nav") {
ToolbarItem(id: "plus", placement: ToolbarItemPlacement.principal, showsByDefault: true) {
HStack {
Button(action: {print("pressed")}, label: {
Image(systemName: "plus.circle")
})
}
}
ToolbarItem(id: "spacer", placement: ToolbarItemPlacement.confirmationAction, showsByDefault: true) {
HStack {
Spacer()
}
}
ToolbarItem(id: "sidebar.end", placement: ToolbarItemPlacement.confirmationAction, showsByDefault: true) {
Button(action: {print("pressed")}, label: {
Image(systemName: "sidebar.right")
})
}
}
}
}
此示例将导致 Toolbar
永远不会显示将整个 Toolbar
分成两部分的分隔线。此外,第一个 ToolbarItem
位于 Toolbar
的中心。我尝试了所有 ToolbarItemPlacement
但 none 导致该项目移动到与标题相邻的最左侧。
带有 HiddenTitleBarWindowStyle
的工具栏
@main
struct ToolbarTestApp: App {
var body: some Scene {
WindowGroup {
ContentViewForHiddenTitleBar()
}
.windowStyle(HiddenTitleBarWindowStyle()) // added hidden title style
.windowToolbarStyle(UnifiedWindowToolbarStyle())
.commands {
SidebarCommands()
}
}
}
struct ContentViewForHiddenTitleBar: View {
@State var destination: String = "Toolbar Test"
@State var detail: String = ""
var body: some View {
NavigationView {
List {
Button(action: {self.destination = "Item with the identifier: 1"}, label: {
Text("Item 1")
})
.buttonStyle(DefaultButtonStyle())
Button(action: {self.destination = "Item 2"}, label: {
Text("Item 2")
})
.buttonStyle(DefaultButtonStyle())
}
.listStyle(SidebarListStyle())
// add geometry reader to trim title width in toolbar
GeometryReader { geometry in
List {
NavigationLink(
destination: DetailView(text: "\(destination) – \(detail)").onAppear{self.detail = "Detail 1"},
label: {
Text("\(destination) – Detail 1")
})
NavigationLink(
destination: DetailView(text: "\(destination) – \(detail)").onAppear{self.detail = "Detail 2"},
label: {
Text("\(destination) – Detail 2")
})
}
// there is no title anymore so let's fake it.
.toolbar(id: "list navigation") {
ToolbarItem(id: "title", placement: ToolbarItemPlacement.navigation, showsByDefault: true) {
VStack(alignment: .leading) {
Text(destination)
.font(.headline)
.frame(maxWidth: .infinity, alignment: .leading)
Text(detail)
.font(.subheadline)
.opacity(0.6)
.frame(maxWidth: .infinity, alignment: .leading)
}
.frame(width: geometry.size.width)
}
}
}
.listStyle(InsetListStyle())
Text("\(destination) – \(detail)")
}
.navigationTitle(destination)
.navigationSubtitle(detail)
.toolbar(id: "nav") {
// primary action will place the item next to the divider line.
ToolbarItem(id: "plus", placement: ToolbarItemPlacement.primaryAction, showsByDefault: true) {
HStack {
Button(action: {print("pressed")}, label: {
Image(systemName: "plus.circle")
})
}
}
ToolbarItem(id: "spacer", placement: ToolbarItemPlacement.confirmationAction, showsByDefault: true) {
HStack {
Spacer()
}
}
ToolbarItem(id: "sidebar.end", placement: ToolbarItemPlacement.confirmationAction, showsByDefault: true) {
Button(action: {print("pressed")}, label: {
Image(systemName: "sidebar.right")
})
}
}
}
}
此示例将导致 Toolbar
始终显示全高分隔线。即使标题太长。因此添加了一个GeometryReader
。这很好,直到侧边栏崩溃。 ToolbarItems
的位置将不正确。此外,在自定义 Toolbar
时,可能会删除标题,这应该是不可能的。
默认的标题栏样式就可以了,您只需将工具栏项附加到顶部 NavigationView 的子视图即可,例如:
var body: some View {
NavigationView {
List {
...
}
.listStyle(SidebarListStyle())
.toolbar {
ToolbarItem {
Button(action: { }, label: {
Image(systemName: "sidebar.right")
})
}
}
List {
...
}
.listStyle(InsetListStyle())
.toolbar {
ToolbarItem {
Button(action: { }, label: {
Image(systemName: "plus.circle")
})
}
}
Text("\(destination) – \(detail)")
}
.navigationTitle(destination)
.navigationSubtitle(detail)
}
我没有将任何工具栏项附加到第三列(Text
),但您可以 — 只需确保将相同的工具栏项附加到您的 DetailViews,因为它的工具栏将替换文本的工具栏当用户导航时。 (如果你不确定我的意思,试试看,你很快就会明白我在说什么:)