Interface macOS Plus de détails B · Orientation officielle Plateforme: macOS

Dock Badge

Dock Badge

Un Dock Badge est une petite valeur sur l'icône d'une app dans le Dock. Il montre souvent un chiffre utile même quand les fenêtres de l'app sont fermées.

Essayez un exemple
Vous pourriez l'appeler Dock Badgebadge d'icône d'applicationNSDockTile badgeLabel

Essayez un exemple

Un vrai exemple

Une application de mail affiche trois messages prioritaires non lus sur son icône dans le Dock. Elle enlève le chiffre une fois les messages lus.

Parties principales

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

Utilisez-le lorsque

Utilisez-le pour un petit compte ou un statut nécessitant une action. Il doit encore avoir de l'importance même lorsque toutes les fenêtres de l'application sont fermées ou masquées.

Ne l'utilisez pas lorsque

Ne montrez pas un total de vanité, une valeur privée ou un numéro de système changeant rapidement. Un badge doit aider quelqu'un à décider de revenir à l'application.

Nom utilisé dans le code

NSApplication.dockTile.badgeLabel

Avant d'expédier

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.

Demande que vous pouvez copier

Outcome: Complete the task with Dock Badge (Dock Badge). User context: Une application de mail affiche trois messages prioritaires non lus sur son icône dans le Dock. Elle enlève le chiffre une fois les messages lus. macOS concept or control: Dock Badge (Dock Badge). Why it fits: Utilisez-le pour un petit compte ou un statut nécessitant une action. Il doit encore avoir de l'importance même lorsque toutes les fenêtres de l'application sont fermées ou masquées. Do not use it when: Ne montrez pas un total de vanité, une valeur privée ou un numéro de système changeant rapidement. Un badge doit aider quelqu'un à décider de revenir à l'application. 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): C'est officiel pour cette source. D'autres plateformes ou équipes peuvent utiliser le terme d'une autre manière. 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.

Vérifiez cette demande

Review how Dock Badge (Dock Badge) is used now. Definition: Un Dock Badge est une petite valeur sur l'icône d'une app dans le Dock. Il montre souvent un chiffre utile même quand les fenêtres de l'app sont fermées. 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
Ce terme est-il officiel ?

Orientation officielle

La plateforme, le framework, le projet ou le groupe d'experts nommé dispose d'un guide officiel pour ce terme.

C'est officiel pour cette source. D'autres plateformes ou équipes peuvent utiliser le terme d'une autre manière.

Portée
Seulement ce que couvre la source:nom canonique、définition、API de la plateforme、mise en œuvre、guide d'utilisation
Statut du document
stable
Coché activé
2026-07-30

Sources et portée des preuves

Source faisant autorité · Apple · stable NSDockTile Portée: nom canonique、définition、API de la plateforme、mise en œuvre、guide d'utilisation Rôle ici: Autorité dans le cadre indiqué La source couvre: nom canonique, définition, API de la plateforme, mise en œuvre, guide d'utilisation Source de l’arrière-plan Apple Human Interface Guidelines — Designing for macOS Rôle ici: Contexte utile, pas une définition

Copiez-le vous-même

Le navigateur n'a pas pu copier ceci. Sélectionnez la requête ci-dessous et copiez-la vous-même.