macOS 인터페이스 더 많은 세부 정보 B · 공식 안내 플랫폼: macOS

Dock Badge

Dock Badge

Dock Badge는 앱의 Dock 아이콘에 작게 보이는 숫자예요. 앱 창을 다 닫아도 중요한 알림 개수를 알려주죠.

당신은 이것을 이렇게 부를 수 있습니다 Dock Badge앱 아이콘 배지NSDockTile badgeLabel

예제를 시도해 보세요

실제 예시

메일 앱이 Dock 아이콘에 안 읽은 중요 메일 세 개를 보여줘요. 메일을 읽으면 숫자가 사라져요.

주요 부분

  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 아이콘에 안 읽은 중요 메일 세 개를 보여줘요. 메일을 읽으면 숫자가 사라져요. 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 여기 역할: 정의가 아닌 유용한 배경

직접 복사

브라우저가 이것을 복사할 수 없습니다. 아래 요청을 선택하고 직접 복사하세요.