Visual Effect Material
视觉效果材质
视觉效果材质(Visual Effect Material)是 macOS 的表面样式,会混合并模糊后方内容,也会根据窗口状态和浅色或深色外观调整。
生活中的例子
侧边栏看起来和下方桌面、文档相连。标签仍有足够对比度。
主要部分
- 01背景混合区域
- 02自适应模糊与色调
- 03可选的鲜明前景处理
- 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、全键盘控制、窗口缩放和多窗口状态。需要时,也要检查恢复、多语言与减少动态效果。 修改程序前,先列出看到的证据、缺口、严重程度,以及最小且安全的修正。