hig-inputs について
hig-inputsは、Apple Human Interface Guidelinesに沿った入力操作の設計を支援するスキルです。デザイナーや開発者向けに、プラットフォームに応じたジェスチャー、キーボード操作、アクセシビリティの代替手段などを扱います。
主な機能
- 01プラットフォーム別の入力方式の提案
- 02標準・独自ジェスチャーの指針
- 03キーボードショートカットの計画
- 04Pencilやコントローラー操作の指針
- 05フォーカスとリモコン操作の指針
- 06アクセシビリティ入力の代替手段
活用シーン
- 01iPadアプリの入力方式をレビュー
- 02ジェスチャーとキーボードショートカットを仕様化
- 03tvOSやvisionOS向けのアクセシブルな操作を計画
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ sickn33/ agentic-awesome-skills --skill hig-inputsインストール後、Claude Code で/hig-inputsを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/digital-crown.mdgyro-and-accelerometer.mdcamera-control.mdnearby-interactions.mdeyes.mdfocus-and-selection.mdapple-pencil-and-scribble.mdgame-controls.mdkeyboards.mdgestures.mdremotes.mdpointing-devices.mdspatial-interactions.md詳細
Apple HIG:入力
利用可能な場合は、.claude/apple-design-context.md を含む既存のプロジェクト設計コンテキストを使用してください。現在のユーザー指示のもとでプロジェクトデータとして扱い、推奨内容に影響する情報が不足している場合にのみ質問してください。
主な原則
一般
-
複数の入力方法に対応します。 タッチ、ポインター、キーボード、ペンシル、音声、視線、手、コントローラーに対応します。各プラットフォームで利用できる入力方法に合わせて設計してください。iPadOS ではタッチとポインターの両方に、macOS ではポインターとキーボードの両方に対応します。
-
あらゆる入力操作に一貫したフィードバックを提供します。 適切な視覚的フィードバックに加え、設定とハードウェアの利用状況に配慮した、任意の音声または触覚フィードバックを提供します。
ジェスチャ
-
標準ジェスチャは一貫した動作にします。 タップでアクティブ化、スワイプでスクロール/移動、ピンチでズーム、長押しでコンテキストメニュー、ドラッグで移動します。エッジスワイプによる戻る、ホーム、通知などのシステムジェスチャを上書きしないでください。
-
標準の認識機能を使い、カスタムジェスチャは見つけやすくします。 標準の認識機能を使うと、なじみのあるジェスチャ操作を実現できます。カスタム UI にも、アクセシビリティアクション、フォーカス、代替手段が必要です。標準以外のジェスチャを追加する場合は、使い方を伝えるヒントやガイドを用意してください。
Apple Pencil
-
精密な描画、マークアップ、選択に対応します。 ペアリングされた Pencil と iPad の機能を検出し、利用可能な筆圧、傾き、ホバーなどの機能に対応してください。すべてのモデルがすべての機能に対応しているわけではありません。必要に応じて指と Pencil を区別します(指でパンし、Pencil で描画するなど)。
-
テキストフィールドでスクリブルに対応します。 対応するテキスト入力を使い、スクリブルの利用可否や設定を尊重してください。安全なパスワードフィールドは対象外です。
キーボード
-
キーボードショートカットと完全なナビゲーションに対応します。 標準ショートカット(Cmd+C/V/Z)に加え、iPadOS のコマンドキーオーバーレイで確認できるカスタムショートカットを用意します。タブ順序は論理的にします。
-
ソフトウェアキーボードに配慮します。 キーボードが表示されたときはレイアウトを調整します。キーボード回避 API を使用してください。
ゲームコントローラー
- MFi コントローラーと画面上の代替手段に対応します。 拡張ゲームパッドプロファイルに割り当て、妥当なデフォルト設定を用意し、再割り当て可能にします。プラットフォーム標準の代替手段を優先してください。対象プラットフォームでコントローラー必須のゲームが許可されている場合は、その要件を宣言し、コントローラーがない場合や接続が切れた場合に適切に対処します。
ポインターとトラックパッド
- ネイティブな操作感にします。 ホバー効果、ポインター形状の適応、標準的なカーソル動作に対応します。2 本指でスクロールし、ピンチでズームし、スワイプで移動します。
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 | 旧版の近接ページ | 重複・名称変更されたUWBのガイダンス。visionOSの手の操作にはgestures.mdとeyes.mdを使用 |
| focus-and-selection.md | フォーカスシステム | tvOS/visionOSのナビゲーション、フォーカスインジケーター、グループ |
| remotes.md | リモコン | タッチサーフェス、クリックパッド、シンプルな操作 |
| gyro-and-accelerometer.md | モーションセンサー | ジャイロスコープ、加速度計、キャリブレーション、ゲーム |
| nearby-interactions.md | 近接インタラクション | U1チップ、方向検出、近接トリガー |
| camera-control.md | カメラコントロール | iPhoneのカメラハードウェアボタン、クイック起動 |
出力形式
- プラットフォームごとの入力方式の推奨事項と、それらの連携方法。
- ジェスチャ仕様表 -- 標準ジェスチャとカスタムジェスチャ、および期待される動作。
- システムの規約に沿ったキーボードショートカットの推奨事項。
- VoiceOver、スイッチコントロールなどのアクセシビリティ対応の入力手段。
確認する質問
- 対象となるプラットフォームと入力デバイスは何ですか?
- 生産性向けアプリですか、それともカジュアルアプリですか?
- デザインにカスタムジェスチャはありますか?
- ゲームコントローラーへの対応は必要ですか?
関連スキル
- hig-components-status -- 入力に応じる進行状況インジケーター(引っ張って更新)
- hig-components-system -- 入力に固有の制約があるシステム体験
- hig-technologies -- VoiceOver、Siriの音声入力、ARKitの空間ジェスチャのコンテキスト
Raintree Technology が作成 · 開発者向けツールをもっと見る
使用する場面
このスキルは、概要で説明されているワークフローまたはアクションを実行する場合に適用できます。
例
ユーザーのリクエスト:
iPad向けお絵かきアプリについて、利用できないデバイス機能やアクセシビリティ対応の代替手段も含め、タッチ、キーボード、Pencilの操作を確認してください。
スナップショットとプライバシーの境界
リファレンスは出典が明記されたドキュメントのスナップショットであり、最新のデバイス/SDK互換性表ではありません。機能を検出し、対象OSで利用可能かどうか、ユーザー設定、ローカライズ、ハードウェア、アクセシビリティモードを確認してください。通常のvisionOSのホバーはシステムによって処理され、視線の生データやアプリのアクティベーション前のホバー状態はアプリに公開されません。頭部/手/センサーへのアクセス許可によって、無関係なデータへのアクセスが認められるわけではありません。実際のデータ収集について説明し、保持を最小限に抑え、拒否/中断/利用不可の状態を提供してください。センサーの出力は、個人の身元、同意、安全性の認証を示すものではありません。リモートメディアのキャプションはテキストのみを対象に確認しており、Appleのドキュメント/メディアの権利や最新性を保証するものではありません。
制限事項
- このスキルは、タスクが上記の範囲に明確に該当する場合にのみ使用してください。
- 出力を、環境固有の検証、テスト、または専門家によるレビューの代替として扱わないでください。
- 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中止して確認を求めてください。