hig-inputs

Name: hig-inputs
Author: raintree-technology

github.com/raintree-technology设计与 UI148648 次安装6 天前更新

代码仓库

关于 hig-inputs

面向 Apple 平台应用设计的输入方式指导技能，供设计者和开发者规划触控、键盘、指针、Apple Pencil 等交互。内容按平台说明输入反馈、手势、快捷键与无障碍替代方式。

主要功能

01按平台规划输入方式
02标准手势与系统手势指导
03Apple Pencil 与 Scribble 支持
04键盘快捷键和焦点顺序建议
05指针、控制器与空间输入指导
06无障碍输入替代方案

适用场景

01规划 iPadOS 的触控与指针操作
02定义 Apple Pencil 绘图和文本输入
03为 macOS 应用安排键盘导航
04设计 tvOS 或 visionOS 焦点移动

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/raintree-technology/hig-doctor --skill hig-inputs

安装后在 Claude Code 中输入/hig-inputs确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/

apple-pencil-and-scribble.md

camera-control.md

digital-crown.md

eyes.md

focus-and-selection.md

game-controls.md

gestures.md

gyro-and-accelerometer.md

keyboards.md

nearby-interactions.md

pointing-devices.md

remotes.md

spatial-interactions.md

详细介绍

Apple HIG：输入

提问前，请先检查 .claude/apple-design-context.md。使用已有上下文，只询问其中尚未涉及的信息。

核心原则

支持多种输入方式。 触控、指针、键盘、触控笔、语音、眼动、手势和控制器。针对各平台可用的输入方式进行设计。在 iPadOS 上，同时支持触控和指针；在 macOS 上，同时支持指针和键盘。
为每种输入操作提供一致的反馈。 以视觉、听觉或触觉方式作出响应。
标准手势的行为应保持一致。 点按以激活，滑动以滚动或导航，捏合以缩放，长按以打开上下文菜单，拖动以移动。不要覆盖系统手势（从屏幕边缘滑动以返回、回到主屏幕或查看通知）。
使用标准识别器；确保自定义手势易于发现。 Apple 内置的识别器可以处理边缘情况和无障碍需求。如果添加非标准手势，请提供提示或引导，帮助用户了解如何使用。
Apple Pencil：用于精准绘图、标记和选择。 支持压力、倾斜和悬停。必要时区分手指与 Apple Pencil（手指用于平移，Apple Pencil 用于绘图）。
在文本字段中支持随手写。 用户希望能在任何文本输入框中使用 Apple Pencil 书写。
支持键盘快捷键和完整导航。 除标准快捷键（Cmd+C/V/Z）外，还应在 iPadOS 的 Command 键浮层中显示自定义快捷键。确保 Tab 键顺序符合逻辑。
妥善处理软件键盘。 键盘出现时调整布局。使用键盘避让 API。
游戏控制器：支持 MFi 控制器，并提供屏幕上的替代操作。 映射到扩展游戏手柄配置文件，提供合理的默认设置，并允许重新映射。始终提供触控或键盘替代方式。
指针和触控板：营造原生体验。 提供悬停效果、适配指针形状，并支持标准光标行为。支持双指滚动、捏合缩放和滑动导航。
数字表冠：在 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	数码表冠	滚动、数值调整、触觉卡点
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 相机硬件按钮、快速启动

输出格式

按平台提供输入方式建议及其交互方式。
手势规范表——标准手势和自定义手势及预期行为。
键盘快捷键建议，遵循系统惯例。
无障碍输入替代方式，适用于 VoiceOver、Switch Control 等。

要提的问题

涉及哪些平台和输入设备？
是效率型应用还是休闲应用？
设计中是否有自定义手势？
是否需要支持游戏控制器？