hig-inputs by raintree-technology/apple-hig-skills
npx skills add https://github.com/raintree-technology/apple-hig-skills --skill hig-inputs提问前请检查 .claude/apple-design-context.md。利用现有上下文,仅询问未涵盖的信息。
支持多种输入方式。 触控、指针、键盘、Apple Pencil、语音、眼动、手势、控制器。为每个平台可用的输入方式设计。在 iPadOS 上,同时支持触控和指针;在 macOS 上,同时支持指针和键盘。
为每个输入操作提供一致的反馈。 视觉、听觉或触觉响应。
标准手势的行为必须保持一致。 轻点以激活,轻扫以滚动/导航,捏合以缩放,长按以显示上下文菜单,拖拽以移动。不要覆盖系统手势(边缘轻扫返回、回到主屏幕、显示通知)。
使用标准识别器;保持自定义手势易于发现。 Apple 内置的识别器处理边缘情况和辅助功能。如果添加非标准手势,请提供提示或引导来教授它们。
Apple Pencil:用于精确绘图、标注和选择。 支持压感、倾斜和悬停。在适当时区分手指和 Pencil(手指平移,Pencil 绘图)。
在文本字段中支持“随手写”。 用户期望能在任何文本输入中使用 Pencil 书写。
键盘快捷键和完整导航。 标准快捷键(Cmd+C/V/Z)加上在 iPadOS Command 键叠加层中可见的自定义快捷键。合理的 Tab 键顺序。
尊重软件键盘。 键盘出现时调整布局。使用键盘回避 API。
游戏控制器:支持 MFi 控制器并提供屏幕备用方案。 映射到扩展游戏手柄配置文件,提供合理的默认设置,支持重映射。始终提供触控或键盘替代方案。
指针和触控板:原生体验。 悬停效果、指针形状适配、标准光标行为。双指滚动、捏合缩放、轻扫导航。
滚动列表、调整数值、导航视图。在卡位处提供触觉反馈。
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
眼动和空间交互(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 | 数码表冠 | 滚动、数值调整、触觉卡位 |
| 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 相机硬件按钮、快速启动 |
由 Raintree Technology 构建 · 更多开发者工具
每周安装量
76
代码仓库
GitHub 星标数
29
首次出现
2026年2月15日
安全审计
安装于
opencode74
github-copilot72
codex71
cursor71
gemini-cli70
amp70
Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered.
Support multiple input methods. Touch, pointer, keyboard, pencil, voice, eyes, hands, controllers. Design for the inputs available on each platform. On iPadOS, support both touch and pointer; on macOS, both pointer and keyboard.
Consistent feedback for every input action. Visible, audible, or haptic response.
Standard gestures must behave consistently. Tap to activate, swipe to scroll/navigate, pinch to zoom, long press for context menus, drag to move. Don't override system gestures (edge swipes for back, Home, notifications).
Use standard recognizers; keep custom gestures discoverable. Apple's built-in recognizers handle edge cases and accessibility. If you add non-standard gestures, provide hints or coaching to teach them.
Apple Pencil: precision drawing, markup, and selection. Support pressure, tilt, and hover. Distinguish finger from Pencil when appropriate (finger pans, Pencil draws).
Support Scribble in text fields. Users expect to write with Pencil in any text input.
Keyboard shortcuts and full navigation. Standard shortcuts (Cmd+C/V/Z) plus custom ones visible in the iPadOS Command key overlay. Logical tab order.
Respect the software keyboard. Adjust layout when keyboard appears. Use keyboard-avoidance APIs.
Game controllers: MFi controllers with on-screen fallbacks. Map to extended gamepad profile, sensible defaults, remappable. Always offer touch or keyboard alternatives.
Pointer and trackpad: native feel. Hover effects, pointer shape adaptation, standard cursor behaviors. Two-finger scroll, pinch to zoom, swipe to navigate.
Digital Crown: primary scrolling and value-adjustment input on watchOS. Scrolling lists, adjusting values, navigating views. Haptic feedback at detents.
Eyes and spatial (visionOS): look and pinch. Generous hit targets (eye tracking is less precise than touch). Avoid sustained gaze for activation. Direct hand manipulation in immersive experiences.
Focus system: critical for tvOS and visionOS. Predictable focus movement. Every interactive element focusable. Clear visual indicators (scale, highlight, elevation). Logical focus groups.
Siri Remote: limited surface. Touch area for swiping, clickpad for selection, few physical buttons. Keep interactions simple.
Gyroscope, accelerometer, UWB: use judiciously. Suits gaming, fitness, AR. Not for essential tasks. Provide calibration and reset. For UWB, communicate distance and direction with visual or haptic cues.
| Reference | Topic | Key content |
|---|---|---|
| gestures.md | Touch gestures | Tap, swipe, pinch, long press, drag, system gestures |
| apple-pencil-and-scribble.md | Apple Pencil | Precision, pressure, tilt, hover, handwriting |
| keyboards.md | Keyboards | Shortcuts, navigation, software keyboard, Command key |
| game-controls.md | Game controllers | MFi, extended gamepad, remapping, fallbacks |
| pointing-devices.md | Pointer/trackpad | Hover, cursor morphing, trackpad gestures |
Built byRaintree Technology · More developer tools
Weekly Installs
76
Repository
GitHub Stars
29
First Seen
Feb 15, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
opencode74
github-copilot72
codex71
cursor71
gemini-cli70
amp70
前端设计技能指南:避免AI垃圾美学,打造独特生产级界面
49,900 周安装
| digital-crown.md |
| Digital Crown |
| Scrolling, value adjustment, haptic detents |
| eyes.md | Eye tracking | Look and tap, gaze targeting, hit target sizing |
| spatial-interactions.md | Spatial input | Hand gestures, direct manipulation, immersive input |
| focus-and-selection.md | Focus system | tvOS/visionOS navigation, focus indicators, groups |
| remotes.md | Remotes | Touch surface, clickpad, simple interactions |
| gyro-and-accelerometer.md | Motion sensors | Gyroscope, accelerometer, calibration, gaming |
| nearby-interactions.md | Nearby interactions | U1 chip, directional finding, proximity triggers |
| camera-control.md | Camera Control | iPhone camera hardware button, quick launch |