How to use custom style for macOS app ToolbarItem (the sidebar toggle button)?

Question

This is what I want to achieve for the sidebar toggle button:

When hovering:

When not hovering:

This is what I have now (macOS 26):

When hovering:

When not hovering:

I want to remove the border around the button and apply my custom hovering effect, like the images of what I want to achieve above, but no matter what I do, the border of the button is still there (I asked Claude to try many different ways, but nothing works), I think that Apple baked it into the SwiftUI by default

I also tried to create the custom toolbar, but in that case, the buttons Close, Minimize, and Maximize disappear, and I have no way to bring them back.

So how to handle this?

kakaiikaka · Accepted Answer · 2025-11-19 07:35:59Z

1

You need .sharedBackgroundVisibility(.hidden) modifier

struct ContentView: View {
    var body: some View {
        VStack {
            Text("Main Application Content Goes Here")
                .foregroundColor(.white)
                .frame(maxWidth: .infinity, maxHeight: .infinity)
        }
        .toolbar {
            ToolbarItem(placement: .primaryAction) {
                Button("Share", systemImage: "square.and.arrow.up") {
                    
                }
            }.sharedBackgroundVisibility(.hidden) /*< That's the key */
        }
    }
}

answered Nov 19 at 7:35

kakaiikaka

6,66116 silver badges24 bronze badges

Sign up to request clarification or add additional context in comments.

2 Comments

0xh8h Nov 19 at 8:34

This is the way (only works in Mac OS 26, I guess that previous versions do not have this issue). Thanks a lot

kakaiikaka Nov 19 at 8:53

yes, that comes together with the new glass effect modifier. Please accept the answer if it solves your problem.

Collectives™ on Stack Overflow

How to use custom style for macOS app ToolbarItem (the sidebar toggle button)?

1 Answer 1

2 Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

1 Answer 1

2 Comments

Your Answer

Sign up or log in

Post as a guest

Related