如何为单个Toolbar按钮设置symbolRenderingMode？

在SwiftUI的NavigationStack工具栏中，单独设置单个按钮的symbolRenderingMode(.hierarchical)和foregroundStyle(.blue)时，按钮图标会显示为单色，无法呈现预期的分层渲染效果。但将按钮放入HStack并添加多个按钮后，自定义样式就能正常生效。

方法1：使用ToolbarItemGroup包裹按钮 #

将单个按钮放入ToolbarItemGroup中，避免系统默认的toolbar按钮样式覆盖自定义设置：

struct ContentView: View {
    var body: some View {
        NavigationStack {
            Text("Text")
                .navigationTitle("Title")
                .toolbar {
                    ToolbarItemGroup(placement: .navigationBarTrailing) {
                        Button("Button", systemImage: "line.3.horizontal.decrease.circle.fill", action: {})
                            .symbolRenderingMode(.hierarchical)
                            .foregroundStyle(.blue)
                    }
                }
        }
    }
}

方法2：自定义Button的Label视图 #

手动构建Button的Label，直接控制图标的渲染模式和颜色，绕过系统默认样式：

struct ContentView: View {
    var body: some View {
        NavigationStack {
            Text("Text")
                .navigationTitle("Title")
                .toolbar {
                    Button(action: {}) {
                        Label("Button", systemImage: "line.3.horizontal.decrease.circle.fill")
                            .symbolRenderingMode(.hierarchical)
                            .foregroundStyle(.blue)
                    }
                }
        }
    }
}

方法3：使用tint替代foregroundStyle #

对于toolbar按钮，系统的tint属性优先级更高，用tint设置颜色配合分层渲染模式：

struct ContentView: View {
    var body: some View {
        NavigationStack {
            Text("Text")
                .navigationTitle("Title")
                .toolbar {
                    Button("Button", systemImage: "line.3.horizontal.decrease.circle.fill", action: {})
                        .symbolRenderingMode(.hierarchical)
                        .tint(.blue)
                }
        }
    }
}

问题原因 #

当Toolbar中直接放置单个Button时，SwiftUI会将其归类为系统样式工具栏按钮，自动应用单色图标的默认渲染规则，覆盖了自定义的symbolRenderingMode和foregroundStyle。而将按钮放入HStack或ToolbarItemGroup后，组件被识别为自定义视图，系统不再强制应用默认单色样式，自定义设置即可正常生效。

内容的提问来源于stack exchange，提问作者Raahs