macOS 界面 深入了解 B · 官方指南或术语 平台: macOS

Visual Effect Material

视觉效果材质

视觉效果材质(Visual Effect Material)是 macOS 的表面样式,会混合并模糊后方内容,也会根据窗口状态和浅色或深色外观调整。

动手试试看
也有人这样说 Visual Effect Material视觉效果材质vibrancymaterialNSVisualEffectView

动手试试看

视觉效果材质
材质会采样后方场景清晰可读仍是首要条件

生活中的例子

侧边栏看起来和下方桌面、文档相连。标签仍有足够对比度。

主要部分

  1. 01背景混合区域
  2. 02自适应模糊与色调
  3. 03可选的鲜明前景处理
  4. 04窗口、外观与无障碍响应

什么时候用

当侧边栏或工具区要和背景区分,又想保留后方内容线索时使用,并让系统自动适应浅色、深色、活动和非活动状态。

什么时候不要用

避免只为装饰而模糊、堆叠多层半透明表面,或放入在降低透明度与窗口失焦时会失去对比的前景细节。

代码里的名称

AppKit NSVisualEffectView / SwiftUI Material

上线前要检查

检查支持的 macOS 版本,以及 AppKit 或 SwiftUI 集成。检查符合平台惯例的焦点与键盘操作。再检查 VoiceOver、全键盘控制、窗口缩放和多窗口状态。需要时,也要检查恢复、多语言与减少动态效果。

可以直接复制的需求

预期结果:在原生 macOS 应用中使用或检查 视觉效果材质 (Visual Effect Material),并遵守平台惯例。 用户场景:侧边栏看起来和下方桌面、文档相连。标签仍有足够对比度。 macOS 概念或控件:视觉效果材质 (Visual Effect Material)。 适用理由:当侧边栏或工具区要和背景区分,又想保留后方内容线索时使用,并让系统自动适应浅色、深色、活动和非活动状态。 不应使用的情况:避免只为装饰而模糊、堆叠多层半透明表面,或放入在降低透明度与窗口失焦时会失去对比的前景细节。 平台要求:列出支持的 macOS 版本。说明哪些部分由 AppKit 或 SwiftUI 负责,以及两者如何连接。定义窗口、菜单、焦点、键盘、状态保存、恢复与多窗口行为。 平台无障碍与韧性:使用正确的无障碍功能接口(Accessibility API)。检查 VoiceOver 与全键盘控制(Full Keyboard Access)。支持多语言、对比度与减少动态效果,并在重新打开后保留用户状态。 验收标准:在支持的 macOS 版本,用键盘与 VoiceOver 检查行为。窗口缩放、焦点、状态恢复,以及 AppKit 或 SwiftUI 集成都符合 macOS 惯例。 证据与限制(证据边界):它只代表该来源的官方说法。其他平台或团队可能有不同用法。 待确认:支持的 macOS 版本、AppKit 或 SwiftUI 架构、窗口模式、沙盒与应用权限限制、数据保留规则,以及无障碍目标。

检查这份需求

请 AI 编程助手检查当前如何使用 视觉效果材质 (Visual Effect Material)。 定义:视觉效果材质(Visual Effect Material)是 macOS 的表面样式,会混合并模糊后方内容,也会根据窗口状态和浅色或深色外观调整。 生产环境检查:检查支持的 macOS 版本,以及 AppKit 或 SwiftUI 集成。检查符合平台惯例的焦点与键盘操作。再检查 VoiceOver、全键盘控制、窗口缩放和多窗口状态。需要时,也要检查恢复、多语言与减少动态效果。 修改程序前,先列出看到的证据、缺口、严重程度,以及最小且安全的修正。

B
这个术语有多正式?

官方指南或术语

列出的平台、框架、项目或专业组织,发布了这个术语的官方指南。

它只代表该来源的官方说法。其他平台或团队可能有不同用法。

适用范围
只包含来源有说明的内容:正式名称、定义、平台 API、实现、使用指南
文档状态
稳定
核验日期
2026-07-30

证据来源与适用范围

正式来源 · Apple · 稳定 Materials 适用范围: 正式名称、定义、平台 API、实现、使用指南 本页用途: 只支持写明的范围 来源涵盖内容: 正式名称, 定义, 平台 API, 实现, 使用指南 背景资料 Apple Human Interface Guidelines — Designing for macOS 本页用途: 提供背景,不是正式定义

自行复制

浏览器无法自动复制。请选择下方文字,再自行复制。