
关于
Apple 人机界面指南中的输入设计规范。使用前先检查 .claude/apple-design-context.md 中的现有上下文。
name: hig-inputs description: "在提问前先检查 .claude/apple-design-context.md。使用已有上下文,仅询问尚未涵盖的信息。" risk: unknown source: community date_added: '2026-02-27'
Apple HIG:输入方式
在提问前先检查 .claude/apple-design-context.md。使用已有上下文,仅询问尚未涵盖的信息。
核心原则
通用
-
支持多种输入方式。 触控、指针、键盘、Apple Pencil、语音、眼动、手势、控制器。针对每个平台可用的输入方式进行设计。在 iPadOS 上同时支持触控和指针;在 macOS 上同时支持指针和键盘。
-
每个输入操作都需要一致的反馈。 视觉、听觉或触觉响应。
手势
-
标准手势必须行为一致。 轻点激活、滑动滚动/导航、捏合缩放、长按打开上下文菜单、拖动移动。不要覆盖系统手势(边缘滑动返回、Home、通知)。
-
使用标准识别器;保持自定义手势可发现。 Apple 内置识别器处理边缘情况和无障碍功能。如果添加非标准手势,提供提示或引导来教会用户。
Apple Pencil
-
精确绘图、标注和选择。 支持压力、倾斜和悬停。在适当时区分手指和 Pencil(手指平移,Pencil 绘图)。
-
在文本字段中支持 Scribble。 用户期望能在任何文本输入中使用 Pencil 书写。
键盘
-
键盘快捷键和完整导航。 标准快捷键(Cmd+C/V/Z)加上在 iPadOS Command 键覆盖层中可见的自定义快捷键。逻辑 Tab 顺序。
-
尊重软件键盘。 键盘出现时调整布局。使用键盘避让 API。
游戏控制器
- MFi 控制器配合屏幕回退方案。 映射到扩展游戏手柄配置文件,合理默认值,可重映射。始终提供触控或键盘替代方案。
指针和触控板
- 原生感觉。 悬停效果、指针形状适配、标准光标行为。双指滚动、捏合缩放、滑动导航。
Digital Crown
- watchOS 上的主要滚动和数值调整输入。 滚动列表、调整数值、导航视图。在棘轮位置提供触觉反馈。
眼动和空间交互(visionOS)
- 注视并捏合。 宽裕的点击目标(眼动追踪精度低于触控)。避免持续注视激活。沉浸式体验中使用直接手部操控。
焦点系统
- 对 tvOS 和 visionOS 至关重要。 可预测的焦点移动。每个交互元素都可聚焦。清晰的视觉指示器(缩放、高亮、抬升)。逻辑焦点组。
遥控器
- Siri Remote:有限的操作面。 触控区域用于滑动,点击板用于选择,少量物理按钮。保持交互简单。
运动和近场
- 陀螺仪、加速度计、UWB:谨慎使用。 适合游戏、健身、AR。不用于核心任务。提供校准和重置。对于 UWB,通过视觉或触觉提示传达距离和方向。
参考索引
| 参考文件 | 主题 | 关键内容 | |---|---|---| | gestures.md | 触控手势 | 轻点、滑动、捏合、长按、拖动、系统手势 | | apple-pencil-and-scribble.md | Apple Pencil | 精确度、压力、倾斜、悬停、手写 | | keyboards.md | 键盘 | 快捷键、导航、软件键盘、Command 键 | | game-controls.md | 游戏控制器 | MFi、扩展游戏手柄、重映射、回退方案 | | pointing-devices.md | 指针/触控板 | 悬停、光标变形、触控板手势 | | digital-crown.md | Digital Crown | 滚动、数值调整、触觉棘轮 | | eyes.md | 眼动追踪 | 注视并轻点、注视定位、点击目标尺寸 | | spatial-interactions.md | 空间输入 | 手势、直接操控、沉浸式输入 | | focus-and-selection.md | 焦点系统 | tvOS/visionOS 导航、焦点指示器、焦点组 | | remotes.md | 遥控器 | 触控面、点击板、简单交互 | | gyro-and-accelerometer.md | 运动传感器 | 陀螺仪、加速度计、校准、游戏 | | nearby-interactions.md | 近场交互 | U1 芯片、方向查找、近距离触发 | | camera-control.md | 相机控制 | iPhone 相机硬件按钮、快速启动 |
输出格式
- 按平台的输入方式建议及其交互方式。
- 手势规格表 -- 标准和自定义手势及预期行为。
- 键盘快捷键建议遵循系统约定。
- 无障碍输入替代方案确保所有功能可通过多种输入方式访问。