The Toolbar API has been accessible for a substantial interval, having been launched with the discharge of iOS 14. It was a beneficial addition to the SwiftUI framework, enabling builders to include menu objects within the navigation and backside bars. In iOS 16, Apple unveiled extra modifiers to additional improve the customization of toolbars and supply builders with larger management over their look.
On this tutorial, let me present you the way to work with toolbars and handle its customizations.
Utilizing the Toolbar Modifier to Populate Navigation Bar Objects
Whether or not you want to populate objects in navigation bars or toolbars, you may make the most of the .toolbar
modifier to realize this goal. Right here is an instance:
.navigationTitle(“Toolbar Demo”)
.toolbar {
Button {
// motion
} label: {
Picture(systemName: “plus”)
}
Button {
// motion
} label: {
Picture(systemName: “sq..and.arrow.up”)
}
}
}
}
}
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 |
struct ContentView: View {     var physique: some View {         NavigationStack {             Listing(1..<10, id: .self) { index in                 NavigationLink(“Merchandise (index)“) {                     Picture(“legomen”)                         .resizable()                         .ignoresSafeArea()                 }             }              .navigationTitle(“Toolbar Demo”)              .toolbar {                 Button {                     // motion                 } label: {                     Picture(systemName: “plus”)                 }                  Button {                     // motion                 } label: {                     Picture(systemName: “sq..and.arrow.up”)                 }              }         }      } } |
Contained in the closure of toolbar
, we create a pair of normal buttons utilizing system photographs. With out explicitly specifying the location of the buttons, SwiftUI routinely positions them within the top-right nook of the navigation bar.
Utilizing ToolbarItem
If you want to add extra objects to the navigation bar, you may proceed so as to add buttons within the toolbar
closure. Nonetheless, if you wish to management the location of the objects, you may present a set of views with every view wrapped in a ToolbarItem
. Beneath is an instance:
ToolbarItem(placement: .topBarLeading) {
Button {
// motion
} label: {
Picture(systemName: “line.3.horizontal”)
}
}
ToolbarItem(placement: .topBarTrailing) {
Button {
// motion
} label: {
Picture(systemName: “plus”)
}
}
ToolbarItem(placement: .topBarTrailing) {
Button {
// motion
} label: {
Picture(systemName: “sq..and.arrow.up”)
}
}
ToolbarItem(placement: .bottomBar) {
Picture(systemName: “folder”)
}
ToolbarItem(placement: .bottomBar) {
Picture(systemName: “message”)
}
ToolbarItem(placement: .standing) {
Button {
} label: {
Textual content(“Cover Navigation”)
}
.buttonStyle(.borderedProminent)
.controlSize(.extraLarge)
}
}
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 |
.toolbar {     ToolbarItem(placement: .principal) {         Picture(systemName: “individual.crop.circle”)     }      ToolbarItem(placement: .topBarLeading) {         Button {             // motion         } label: {             Picture(systemName: “line.3.horizontal”)         }     }      ToolbarItem(placement: .topBarTrailing) {         Button {             // motion         } label: {             Picture(systemName: “plus”)         }     }      ToolbarItem(placement: .topBarTrailing) {         Button {             // motion         } label: {             Picture(systemName: “sq..and.arrow.up”)         }     }      ToolbarItem(placement: .bottomBar) {         Picture(systemName: “folder”)     }      ToolbarItem(placement: .bottomBar) {         Picture(systemName: “message”)     }      ToolbarItem(placement: .standing) {         Button {          } label: {             Textual content(“Cover Navigation”)         }         .buttonStyle(.borderedProminent)         .controlSize(.extraLarge)     } } |
Every ToolbarItem
allows you to outline the place of the merchandise by using the placement
parameter. So as to add objects within the navigation bar, you may specify the next values:
.topBarLeading
– Locations the merchandise in the forefront of the highest bar..topBarTrailing
– Locations the merchandise within the trailing fringe of the highest bar..precept
– Locations the merchandise within the principal merchandise part,which is the middle of the navigation bar.
So as to add objects within the backside bar, you may set the worth to .bottomBar
and .standing
:
.bottomBar
– Locations the merchandise within the backside toolbar..standing
– In iOS and iPadOS, the system locations standing objects within the middle of the underside toolbar.
Find out how to Cover the Navigation Bar and Backside Bar
Ranging from iOS 16, the toolbar
modifier affords builders the power to handle the visibility of toolbars, together with the navigation bar and backside bar. To cover the navigation bar, you may insert the toolbar
modifier inside NavigationStack
like this:
.toolbar(.hidden, for: .navigationBar) |
If you wish to present an choice for customers to cover/present the navigation bar, you may declare a state variable like beneath:
@State non-public var showNavBar = true |
Then you may replace the .toolbar
modifier like this:
.
.
.
ToolbarItem(placement: .standing) {
Button {
showNavBar.toggle()
} label: {
Textual content(showNavBar ? “Cover Navigation” : “Present Navigation”)
}
.buttonStyle(.borderedProminent)
.controlSize(.extraLarge)
}
}
.toolbar(showNavBar ? .seen : .hidden, for: .navigationBar)
.animation(.easeInOut, worth: showNavBar)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
.toolbar { Â Â Â Â Â Â Â . Â Â Â Â Â Â . Â Â Â Â Â Â . Â Â Â Â Â Â Â ToolbarItem(placement: .standing) { Â Â Â Â Â Â Â Â Button { Â Â Â Â Â Â Â Â Â Â Â Â showNavBar.toggle() Â Â Â Â Â Â Â Â } label: { Â Â Â Â Â Â Â Â Â Â Â Â Textual content(showNavBar ? “Cover Navigation” : “Present Navigation”) Â Â Â Â Â Â Â Â } Â Â Â Â Â Â Â Â .buttonStyle(.borderedProminent) Â Â Â Â Â Â Â Â .controlSize(.extraLarge) Â Â Â Â } } .toolbar(showNavBar ? .seen : .hidden, for: .navigationBar) .animation(.easeInOut, worth: showNavBar) |
To cover the visibility of the underside bar, you may exchange .navigationBar
with .bottomBar
. Right here is an instance:
.toolbar(.hidden, for: .bottomBar) |
Controlling the Visibility of Toolbar Background
SwiftUI affords one other modifier known as toolbarBackground
for builders to regulate the visibility of the toolbar background. To make the navigation bar background clear, you may set the worth of toolbarBackground
to .hidden
:
.toolbarBackground(.hidden, for: .navigationBar) |
To make the background seen, you may set the worth to .seen
. Right here is an instance:
Listing(1..<10, id: .self) { index in     NavigationLink(“Merchandise (index)“) {         Picture(“legomen”)             .resizable()             .ignoresSafeArea()             .toolbarBackground(.seen, for: .navigationBar)     } } |
After making the code modifications, you must see a navigation bar with a blurred background when navigating to the element view.
Toolbar Colour Scheme
You’ll be able to exert extra management over the colour scheme of the navigation bar or backside bar by using the toolbarColorScheme
modifier. As an example, to use darkish mode to the navigation bar of the element view, you may apply the toolbarColorScheme
modifier to the Picture
view as demonstrated beneath:
.toolbarColorScheme(.darkish, for: .navigationBar) |
Now, while you navigate to the element view, the navigation bar modifications to darkish mode.
Abstract
All through this tutorial, we have now coated the basics of the Toolbar APIs and explored the way to populate objects in toolbars. Because the SwiftUI framework continues to evolve, it affords builders an expanded vary of functionalities to customise the looks of navigation and backside bars. These developments allow builders to create extra visually interesting and tailor-made consumer interfaces of their SwiftUI apps.
If you wish to study extra about SwiftUI, you may take a look at our Mastering SwiftUI guide. It’s now absolutely up to date for Xcode 15 and iOS 17.