hig-patterns

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Apple HIG: Interaction Patterns

Apple HIG:交互模式

Check for
.claude/apple-design-context.md
before asking questions. Use existing context and only ask for information not already covered.
在提问前检查
.claude/apple-design-context.md
。利用已有上下文,仅询问未涵盖的信息。

Key Principles

关键原则

  1. Minimize modality. Use modality only when it is critical to get attention, a task must be completed or abandoned, or saving changes is essential. Prefer non-modal alternatives.
  2. Provide clear feedback. Every action should produce visible, audible, or haptic response. Activity indicators for indeterminate waits, progress bars for determinate, haptics for physical confirmation.
  3. Support undo over confirmation dialogs. Destructive actions should be reversible when possible. Undo is almost always better than "Are you sure?"
  4. Launch quickly. Display a launch screen that transitions seamlessly into the first screen. No splash screens with logos. Restore previous state.
  5. Defer sign-in. Let users explore before requiring account creation. Support Sign in with Apple and passkeys.
  6. Keep onboarding brief. Three screens max. Let users skip. Teach through progressive disclosure and contextual hints.
  7. Use progressive disclosure. Show essentials first, let users drill into details. Don't overwhelm with every option on one screen.
  8. Respect user attention. Consolidate notifications, minimize interruptions, give users control over alerts. Never use notifications for marketing.
  1. 尽量减少模态化。 仅在需要吸引注意、任务必须完成或放弃、或保存更改至关重要时使用模态。优先选择非模态的替代方案。
  2. 提供清晰的反馈。 每个操作都应产生可见、可听或触觉响应。不确定等待时使用活动指示器,确定进度时使用进度条,物理确认时使用触觉反馈。
  3. 支持撤销而非确认对话框。 破坏性操作应尽可能可逆。撤销几乎总是比“您确定吗?”更好。
  4. 快速启动。 显示一个无缝过渡到首个屏幕的启动屏幕。不要使用带有标志的启动闪屏。恢复之前的状态。
  5. 延迟登录。 在要求创建账户之前让用户先探索。支持 Apple 登录和通行密钥。
  6. 保持引导简短。 最多三个屏幕。让用户可跳过。通过渐进式披露和情境提示进行教学。
  7. 使用渐进式披露。 先展示必要内容,让用户深入了解细节。不要在一个屏幕上堆叠所有选项。
  8. 尊重用户注意力。 合并通知,减少打断,让用户控制提醒。绝不要将通知用于营销。

Reference Index

参考索引

ReferenceTopicKey content
charting-data.mdCharting DataData visualization patterns, accessible charts, interactive elements
collaboration-and-sharing.mdCollaboration & SharingShare sheets, activity views, collaborative editing, SharePlay
drag-and-drop.mdDrag and DropDrag sources, drop targets, spring loading, multi-item drag, visual feedback
entering-data.mdEntering DataText fields, pickers, steppers, input validation, keyboard types, autofill
feedback.mdFeedbackAlerts, action sheets, haptic patterns, sound feedback, visual indicators
file-management.mdFile ManagementDocument browser, file providers, iCloud integration, document lifecycle
going-full-screen.mdGoing Full ScreenFull-screen transitions, immersive content, exiting full screen
launching.mdLaunchingLaunch screens, state restoration, cold vs warm launch
live-viewing-apps.mdLive Viewing AppsLive content display, real-time updates, Live Activities, Dynamic Island
loading.mdLoadingActivity indicators, progress views, skeleton screens, lazy loading, placeholders
managing-accounts.mdManaging AccountsSign in with Apple, passkeys, account creation, credential autofill, account deletion
managing-notifications.mdManaging NotificationsPermission requests, grouping, actionable notifications, provisional delivery
modality.mdModalitySheets, alerts, popovers, full-screen modals, when to use each
multitasking.mdMultitaskingiPad Split View, Slide Over, Stage Manager, responsive layout, size class transitions
offering-help.mdOffering HelpContextual tips, onboarding hints, help menus, support links
onboarding.mdOnboardingWelcome screens, feature highlights, progressive onboarding, skip options
playing-audio.mdPlaying AudioAudio sessions, background audio, Now Playing, audio routing, interruptions
playing-haptics.mdPlaying HapticsCore Haptics, UIFeedbackGenerator, haptic patterns, custom haptics
playing-video.mdPlaying VideoVideo player controls, picture-in-picture, AirPlay, full-screen video
printing.mdPrintingPrint dialogs, page setup, AirPrint integration
ratings-and-reviews.mdRatings & ReviewsSKStoreReviewController, timing, frequency limits, in-app feedback
searching.mdSearchingSearch bars, suggestions, scoped search, results display, recents
settings.mdSettingsIn-app vs Settings app, preference organization, toggles, defaults
undo-and-redo.mdUndo and RedoShake to undo, undo/redo stack, multi-level undo
workouts.mdWorkoutsWorkout sessions, live metrics, Always On display, summaries, HealthKit
参考主题关键内容
charting-data.md图表数据数据可视化模式、无障碍图表、交互元素
collaboration-and-sharing.md协作与共享共享表单、活动视图、协作编辑、SharePlay
drag-and-drop.md拖放拖拽源、放置目标、弹簧加载、多项目拖拽、视觉反馈
entering-data.md输入数据文本字段、选择器、步进器、输入验证、键盘类型、自动填充
feedback.md反馈提醒、操作列表、触觉模式、声音反馈、视觉指示器
file-management.md文件管理文档浏览器、文件提供程序、iCloud 集成、文档生命周期
going-full-screen.md进入全屏全屏过渡、沉浸式内容、退出全屏
launching.md启动启动屏幕、状态恢复、冷启动与热启动
live-viewing-apps.md实时查看应用实时内容展示、实时更新、Live Activities、Dynamic Island
loading.md加载活动指示器、进度视图、骨架屏、懒加载、占位符
managing-accounts.md管理账户Apple 登录、通行密钥、账户创建、凭据自动填充、账户删除
managing-notifications.md管理通知权限请求、分组、可操作通知、临时投递
modality.md模态Sheets、提醒、弹出框、全屏模态,各自使用时机
multitasking.md多任务iPad Split View、Slide Over、Stage Manager、响应式布局、尺寸类别转换
offering-help.md提供帮助情境提示、引导提示、帮助菜单、支持链接
onboarding.md引导欢迎屏幕、功能亮点、渐进式引导、跳过选项
playing-audio.md播放音频音频会话、后台音频、正在播放、音频路由、中断处理
playing-haptics.md播放触觉Core Haptics、UIFeedbackGenerator、触觉模式、自定义触觉
playing-video.md播放视频视频播放器控件、画中画、AirPlay、全屏视频
printing.md打印打印对话框、页面设置、AirPrint 集成
ratings-and-reviews.md评分与评论SKStoreReviewController、时机、频率限制、应用内反馈
searching.md搜索搜索栏、建议、范围搜索、结果展示、最近项目
settings.md设置应用内设置 vs 设置应用、偏好组织、开关、默认值
undo-and-redo.md撤销与重做摇动撤销、撤销/重做栈、多级撤销
workouts.md健身训练训练会话、实时指标、全天候显示、摘要、HealthKit

Pattern Selection Guide

模式选择指南

User GoalRecommended PatternAvoid
First app experienceBrief onboarding (max 3 screens) + progressive disclosureLong tutorials, mandatory sign-up
Waiting for contentSkeleton screens or progress indicatorsBlocking spinners with no context
Confirming destructive actionUndo supportExcessive "Are you sure?" dialogs
Collecting user inputInline validation, smart defaults, autofillModal forms for simple inputs
Requesting permissionsContextual, just-in-time with explanationRequesting all permissions at launch
Providing feedbackHaptics + visual indicatorSilent actions with no confirmation
Organizing preferencesIn-app settings for frequent itemsBurying all settings in system Settings app
用户目标推荐模式避免
首次应用体验简短引导(最多 3 屏)+ 渐进式披露冗长教程、强制注册
等待内容骨架屏或进度指示器无上下文的阻塞式加载圈
确认破坏性操作撤销支持过多的“您确定吗?”对话框
收集用户输入内联验证、智能默认值、自动填充对简单输入使用模态表单
请求权限情境化、即时且附带说明启动时请求所有权限
提供反馈触觉 + 视觉指示器无确认的静默操作
组织偏好应用内设置(针对常用项)将所有设置埋藏在系统设置应用中

Output Format

输出格式

  1. Recommended pattern with rationale, citing the relevant reference file.
  2. Step-by-step implementation covering each screen or state.
  3. Platform variations for targeted platforms.
  4. Common pitfalls that violate HIG for this pattern.
  1. 推荐模式及理由,引用相关的参考文件。
  2. 分步实施,涵盖每个屏幕或状态。
  3. 平台差异,针对目标平台。
  4. 常见陷阱,即违反 HIG 的该模式常见问题。

Questions to Ask

需要询问的问题

  1. Where in the app does this pattern appear? What comes before and after?
  2. Which platforms?
  3. Designing from scratch or improving an existing flow?
  4. Does this involve sensitive actions? (Destructive operations, payments, permissions)
  1. 此模式在应用中的什么位置出现?前后是什么?
  2. 针对哪些平台?
  3. 是从头设计还是改进现有流程?
  4. 是否涉及敏感操作?(破坏性操作、支付、权限)

Related Skills

相关技能

  • hig-foundations -- Accessibility, color, typography, and privacy principles underlying every pattern
  • hig-platforms -- Platform-specific pattern implementations
  • hig-components-layout -- Structural components (tab bars, sidebars, split views) for navigation patterns
  • hig-components-content -- Content display within patterns (charts, collections, search results)

  • hig-foundations -- 每个模式所基于的无障碍、色彩、排版和隐私原则
  • hig-platforms -- 平台特定的模式实现
  • hig-components-layout -- 用于导航模式的结构组件(标签栏、侧边栏、分屏视图)
  • hig-components-content -- 模式中的内容展示(图表、集合、搜索结果)