macOS インターフェイス さらに詳細 B · 公式のガイダンス プラットフォーム: macOS

Dock Badge

Dock Badge

Dock Badgeは、アプリのDockアイコンに付く小さな数字などのことです。アプリの画面を閉じていても、役立つ数を示してくれます。

例を試してみる
そう呼ぶかもしれません Dock BadgeアプリアイコンバッジNSDockTile badgeLabel

例を試してみる

実際の例

メールアプリは、Dock アイコンに3つの未読の優先メッセージを表示するよ。メッセージを読んだら、その数は消えるよ。

主な部分

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

以下の場合に使用します

アクションが必要な小さなカウントやステータスに使用します。すべてのアプリウィンドウが閉じられたり隠されたりしても意味がある状態であるべきです。

以下の場合は使用しないでください

虚栄の合計値、個人の値、急速に変化するシステム数値を表示しないでください。バッジは、アプリに戻るかどうかを判断するのに役立つものであるべきです。

コードで使用する名前

NSApplication.dockTile.badgeLabel

出荷前に

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.

コピーできるリクエスト

Outcome:Complete the task with Dock Badge (Dock Badge)。 User context:メールアプリは、Dock アイコンに3つの未読の優先メッセージを表示するよ。メッセージを読んだら、その数は消えるよ。 macOS concept or control:Dock Badge (Dock Badge)。 Why it fits:アクションが必要な小さなカウントやステータスに使用します。すべてのアプリウィンドウが閉じられたり隠されたりしても意味がある状態であるべきです。 Do not use it when:虚栄の合計値、個人の値、急速に変化するシステム数値を表示しないでください。バッジは、アプリに戻るかどうかを判断するのに役立つものであるべきです。 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):その情報源にとって公式です。他のプラットフォームやチームはその用語を別の方法で使用する場合があります。 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.

このリクエストを確認する

Review how Dock Badge (Dock Badge) is used now. Definition: Dock Badgeは、アプリのDockアイコンに付く小さな数字などのことです。アプリの画面を閉じていても、役立つ数を示してくれます。 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
この用語はどれくらい公式か?

公式のガイダンス

指定されたプラットフォーム、フレームワーク、プロジェクト、または専門グループには、この用語に関する公式ガイドがあります。

その情報源にとって公式です。他のプラットフォームやチームはその用語を別の方法で使用する場合があります。

範囲
ソースがカバーするもののみ:正式名、定義、プラットフォームAPI、実装、使用ガイド
ドキュメントステータス
安定
チェックオン
2026-07-30

証拠の情報源と範囲

権威のある情報源 · Apple · 安定 NSDockTile 範囲: 正式名、定義、プラットフォームAPI、実装、使用ガイド ここでの役割: 指定された範囲内の権威 ソースの範囲: 正式名, 定義, プラットフォームAPI, 実装, 使用ガイド 背景ソース Apple Human Interface Guidelines — Designing for macOS ここでの役割: 定義ではなく有用な背景情報

自分でコピーする

ブラウザはこれをコピーできませんでした。下のリクエストを選択して自分でコピーしてください。