Interfaz macOS Más detalle B · Guía oficial Plataforma: macOS

Dock Badge

Dock Badge

Un Dock Badge es un número pequeño en el icono de una app en el Dock. Suele mostrar un conteo útil incluso cuando las ventanas de la app están cerradas.

Prueba un ejemplo
Podrías llamarlo Dock Badgedistintivo del ícono de la aplicaciónNSDockTile badgeLabel

Prueba un ejemplo

Un ejemplo real

Una app de correo muestra tres mensajes prioritarios sin leer en su icono del Dock. Quita el contador después de leer los mensajes.

Partes principales

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

Úsalo cuando

Úsalo para un pequeño conteo o estado que requiere acción. Aún debería importar cuando todas las ventanas de la aplicación estén cerradas u ocultas.

No lo uses cuando

No muestres un total de relumbrón, un valor privado o un número del sistema que cambia muy rápido. Una insignia debería ayudar a alguien a decidir si volver a la aplicación.

Nombre usado en código

NSApplication.dockTile.badgeLabel

Antes de lanzarlo

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.

Solicitud que puedes copiar

Outcome: Complete the task with Dock Badge (Dock Badge). User context: Una app de correo muestra tres mensajes prioritarios sin leer en su icono del Dock. Quita el contador después de leer los mensajes. macOS concept or control: Dock Badge (Dock Badge). Why it fits: Úsalo para un pequeño conteo o estado que requiere acción. Aún debería importar cuando todas las ventanas de la aplicación estén cerradas u ocultas. Do not use it when: No muestres un total de relumbrón, un valor privado o un número del sistema que cambia muy rápido. Una insignia debería ayudar a alguien a decidir si volver a la aplicación. 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): Es oficial para esa fuente. Otras plataformas o equipos pueden usar el término de otra manera. 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.

Revisa esta petición

Review how Dock Badge (Dock Badge) is used now. Definition: Un Dock Badge es un número pequeño en el icono de una app en el Dock. Suele mostrar un conteo útil incluso cuando las ventanas de la app están cerradas. 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é tan oficial es este término?

Guía oficial

La plataforma, marco, proyecto o grupo de expertos nombrado tiene una guía oficial para este término.

Es oficial para esa fuente. Otras plataformas o equipos pueden usar el término de otra manera.

Alcance
Solo lo que cubre la fuente:nombre canónico、definición、API de la plataforma、implementación、orientación de uso
Estado del documento
estable
Comprobado el
2026-07-30

Fuentes de evidencia y alcance

Fuente de autoridad · Apple · estable NSDockTile Alcance: nombre canónico、definición、API de la plataforma、implementación、orientación de uso Rol aquí: Autoridad dentro del límite establecido La fuente cubre: nombre canónico, definición, API de la plataforma, implementación, orientación de uso Origen del fondo Apple Human Interface Guidelines — Designing for macOS Rol aquí: Información útil, no una definición

Cópialo tú mismo

El navegador no pudo copiar esto. Selecciona la solicitud a continuación y cópiala tú mismo.