You need to enable JavaScript to run this app. SwiftUI:macOS应用工具栏图标初始灰显仅鼠标悬停后恢复正常问题
优惠活动
大模型
产品
解决方案
定价
更多

SwiftUI:macOS应用工具栏图标初始灰显仅鼠标悬停后恢复正常问题

问题结论

这是SwiftUI在macOS平台的已知渲染Bug,和你的代码实现逻辑无关。该问题在Xcode 12.5.x至13.0多个beta版本中均存在,本质是工具栏图标初始化时未正确加载系统tint色值,仅触发重绘(比如鼠标悬停)后才会恢复正常显示,按钮本身的交互功能从初始化开始就是正常的。该Bug在Xcode 14及更高版本中已经被苹果官方修复,升级开发环境后无需额外修改也可正常显示。

可行修复方案

针对仍需兼容Xcode 12/13版本的场景,可使用以下任意一种方案修复:

  • 方案1:显式指定NavigationView的样式,避免默认样式的渲染异常
    给NavigationView添加对应修饰符即可:
    // Xcode 12及更早版本使用
    .navigationViewStyle(DoubleColumnNavigationViewStyle())
    // Xcode 13+版本可使用
    .navigationViewStyle(.columns)
    
  • 方案2:强制给工具栏按钮设置渲染色值
    给工具栏内的Button添加foregroundColor修饰符,显式指定颜色:
    Button(action: {addNewItem()})
    {
        Label("Select", systemImage: "square.and.pencil")
    }
    .foregroundColor(.accentColor)
    
  • 方案3:给toolbar添加显式的tint修饰符
    在.toolbar修饰符后添加全局tint设置,强制整个工具栏的元素使用系统强调色渲染:
    .toolbar {
        // 原有按钮代码
    }
    .tint(.accentColor)
    

内容的提问来源于stack exchange,提问作者iphaaw

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.12 17:27:04