SwiftUI禁用状态按钮的系统默认标签颜色是什么

核心结论 #

别白费功夫手动找固定色值了，SwiftUI 禁用态的按钮标签根本没有通用的固定色值和透明度参数：系统会根据当前明暗模式、父视图背景色、无障碍设置（高对比度、降低透明度）、按钮样式类型动态调整显示效果，手动比对固定参数永远没法覆盖所有场景，后续系统UI迭代后还会直接失效。

自定义按钮样式的正确实现方式 #

要100%匹配系统原生按钮的禁用态视觉效果，完全不需要手动计算色值，遵循以下规则即可：

• 不要硬编码禁用态的标签颜色，优先使用系统提供的语义化层级颜色
• 从环境中读取isEnabled状态，对应使用不同层级的前景样式
• 背景色优先使用系统内置的填充语义色，不要自己调灰度值

代码示例 #

以下是和系统原生视觉完全一致的自定义按钮样式实现：

import SwiftUI

struct SystemDefaultButtonStyle: ButtonStyle {
    @Environment(\.isEnabled) private var isEnabled
    
    func makeBody(configuration: Configuration) -> some View {
        configuration.label
            // 前景色自动适配可用/禁用状态，无需手动调透明度
            .foregroundStyle(isEnabled ? .primary : .secondary)
            // 按压态透明度和系统原生效果保持一致
            .opacity(configuration.isPressed ? 0.3 : 1)
            // 如果实现带边框的按钮样式，背景用系统语义填充色
            .padding(.horizontal, 14)
            .padding(.vertical, 7)
            .background {
                RoundedRectangle(cornerRadius: 8)
                    .fill(isEnabled ? Color.accentColor.opacity(0.12) : Color(.tertiarySystemFill))
            }
    }
}

// 扩展方便调用
extension ButtonStyle where Self == SystemDefaultButtonStyle {
    static var systemMatch: SystemDefaultButtonStyle { .init() }
}

单独取色方案 #

如果需要在按钮之外的场景使用和禁用按钮标签一致的颜色，可以用以下动态语义色，它会自动适配明暗模式：

// 等价于系统默认plain样式按钮禁用态的标签颜色
let disabledLabelColor = Color.secondary.opacity(0.4)

注意这个值仅在纯白/纯黑默认背景下和plain按钮禁用态完全一致，在非默认背景下系统会自动调整透明度做对比度适配，这种场景建议直接把对应元素放到和按钮相同的视图层级中，不手动设置前景色，让系统自动继承环境的禁用态显示效果即可。

不同系统按钮样式的禁用态参数参考 #

如果需要匹配特定样式的原生按钮，可以参考以下iOS 17版本下的实测参数（均为语义色，会自动适配明暗模式）：

• 默认plain样式：标签为Color.secondary，叠加0.4透明度
• bordered普通样式：标签为Color.secondary，叠加0.5透明度，背景为Color(.tertiarySystemFill)
• borderedProminent高亮样式：标签为白色叠加0.6透明度，背景为accentColor叠加0.2透明度

你提供的测试视图运行效果也符合上述规则：

别硬记上面的透明度参数，这只是当前系统版本的实测值，后续版本可能调整，优先使用语义色让系统自动适配才是长期稳定的方案。

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