Interface do macOS Mais detalhes B · Orientação oficial Plataforma: macOS

Dock Badge

Dock Badge

Uma Dock Badge é um pequeno valor no ícone de um app no Dock. Geralmente mostra uma contagem útil mesmo quando as janelas do app estão fechadas.

Você poderia chamar de Dock Badgebadge do ícone do aplicativoNSDockTile badgeLabel

Experimente um exemplo

Um exemplo real

Um app de email mostra três mensagens prioritárias não lidas no seu ícone do Dock. Ele zera a contagem depois que as mensagens são lidas.

Partes principais

  1. 01State signal
  2. 02Human-readable message
  3. 03Timing or progress
  4. 04Recovery path

Use-o quando

Use-o para uma pequena contagem ou status que necessite ação. Ainda deve ser relevante quando todas as janelas do aplicativo estiverem fechadas ou ocultas.

Não o use quando

Não mostre um total de vaidade, valor privado ou número do sistema que muda rapidamente. Um distintivo deve ajudar alguém a decidir se retorna ao aplicativo.

Nome usado no código

NSApplication.dockTile.badgeLabel

Antes de lançar

Check the supported macOS versions and AppKit or SwiftUI integration. Check standard focus and keyboard behavior. Also check VoiceOver, Full Keyboard Access, window resizing, and multi-window state. When needed, check restore, localization, and reduced motion.

Solicitação que você pode copiar

Outcome: Complete the task with Dock Badge (Dock Badge). User context: Um app de email mostra três mensagens prioritárias não lidas no seu ícone do Dock. Ele zera a contagem depois que as mensagens são lidas. macOS concept or control: Dock Badge (Dock Badge). Why it fits: Use-o para uma pequena contagem ou status que necessite ação. Ainda deve ser relevante quando todas as janelas do aplicativo estiverem fechadas ou ocultas. Do not use it when: Não mostre um total de vaidade, valor privado ou número do sistema que muda rapidamente. Um distintivo deve ajudar alguém a decidir se retorna ao aplicativo. Platform requirements: List the supported macOS versions. Say whether AppKit or SwiftUI owns each part and how they connect. Define window, menu, focus, keyboard, saved state, restore, and multi-window behavior. Platform accessibility and resilience: Use the right accessibility APIs. Check VoiceOver and Full Keyboard Access. Support localization, contrast, and reduced motion when needed. Keep user state after a relaunch. Acceptance criteria: Check the behavior on supported macOS versions with a keyboard and VoiceOver. Window resizing, focus, state restore, and AppKit or SwiftUI integration work in the normal macOS way. Evidence and limits (evidence boundary): É oficial para essa fonte. Outras plataformas ou equipes podem usar o termo de outra maneira. Unknowns to confirm: Supported macOS versions, AppKit or SwiftUI structure, and window model. Also confirm sandbox and entitlement limits, save rules, and the accessibility goal.

Conferir este pedido

Review how Dock Badge (Dock Badge) is used now. Definition: Uma Dock Badge é um pequeno valor no ícone de um app no Dock. Geralmente mostra uma contagem útil mesmo quando as janelas do app estão fechadas. Release checks: Check the supported macOS versions and AppKit or SwiftUI integration. Check standard focus and keyboard behavior. Also check VoiceOver, Full Keyboard Access, window resizing, and multi-window state. When needed, check restore, localization, and reduced motion. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.

B
Quão oficial é este termo?

Orientação oficial

A plataforma, framework, projeto ou grupo de especialistas nomeado tem um guia oficial para este termo.

É oficial para essa fonte. Outras plataformas ou equipes podem usar o termo de outra maneira.

Escopo
Apenas o que a fonte cobre:nome canônico、definição、API da plataforma、implementação、orientação de uso
Status do documento
estável
Verificado em
2026-07-30

Fontes e escopo da evidência

Fonte de autoridade · Apple · estável NSDockTile Escopo: nome canônico、definição、API da plataforma、implementação、orientação de uso Papel aqui: Autoridade dentro do escopo definido A fonte cobre: nome canônico, definição, API da plataforma, implementação, orientação de uso Origem do fundo Apple Human Interface Guidelines — Designing for macOS Papel aqui: Contexto útil, não uma definição

Copie você mesmo

O navegador não conseguiu copiar isso. Selecione a solicitação abaixo e copie você mesmo.