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

Dock Badge

程序坞角标

程序坞角标(Dock Badge)是显示在 App 程序坞图标上的小型信息,通常用来呈现即使窗口关闭后仍有用的数量。

动手试试看
也有人这样说 Dock Badge程序坞角标app icon badgeNSDockTile badgeLabel

动手试试看

生活中的例子

邮件 App 在程序坞图标显示三封重要未读邮件。看完后才会清除数量。

主要部分

  1. 01状态信号
  2. 02可理解信息
  3. 03时间或进度
  4. 04恢复方式

什么时候用

只有在数量或简短状态需要处理,而且所有 App 窗口关闭或被遮挡时仍有用,才显示角标。

什么时候不要用

不要显示只为好看的总数、敏感信息或快速变化的系统数值。角标应该能帮助用户判断是否要回到 App。

代码里的名称

NSApplication.dockTile.badgeLabel

上线前要检查

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

可以直接复制的需求

预期结果:在原生 macOS 应用中使用或检查 程序坞角标 (Dock Badge),并遵守平台惯例。 用户场景:邮件 App 在程序坞图标显示三封重要未读邮件。看完后才会清除数量。 macOS 概念或控件:程序坞角标 (Dock Badge)。 适用理由:只有在数量或简短状态需要处理,而且所有 App 窗口关闭或被遮挡时仍有用,才显示角标。 不应使用的情况:不要显示只为好看的总数、敏感信息或快速变化的系统数值。角标应该能帮助用户判断是否要回到 App。 平台要求:列出支持的 macOS 版本。说明哪些部分由 AppKit 或 SwiftUI 负责,以及两者如何连接。定义窗口、菜单、焦点、键盘、状态保存、恢复与多窗口行为。 平台无障碍与韧性:使用正确的无障碍功能接口(Accessibility API)。检查 VoiceOver 与全键盘控制(Full Keyboard Access)。支持多语言、对比度与减少动态效果,并在重新打开后保留用户状态。 验收标准:在支持的 macOS 版本,用键盘与 VoiceOver 检查行为。窗口缩放、焦点、状态恢复,以及 AppKit 或 SwiftUI 集成都符合 macOS 惯例。 证据与限制(证据边界):它只代表该来源的官方说法。其他平台或团队可能有不同用法。 待确认:支持的 macOS 版本、AppKit 或 SwiftUI 架构、窗口模式、沙盒与应用权限限制、数据保留规则,以及无障碍目标。

检查这份需求

请 AI 编程助手检查当前如何使用 程序坞角标 (Dock Badge)。 定义:程序坞角标(Dock Badge)是显示在 App 程序坞图标上的小型信息,通常用来呈现即使窗口关闭后仍有用的数量。 生产环境检查:检查支持的 macOS 版本,以及 AppKit 或 SwiftUI 集成。检查符合平台惯例的焦点与键盘操作。再检查 VoiceOver、全键盘控制、窗口缩放和多窗口状态。需要时,也要检查恢复、多语言与减少动态效果。 修改程序前,先列出看到的证据、缺口、严重程度,以及最小且安全的修正。

B
这个术语有多正式?

官方指南或术语

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

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

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

证据来源与适用范围

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

自行复制

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