apple-hig

Apple Human Interface Guidelines

関連する Apple のガイダンスを活用して、具体的な設計判断を行ってください。このパッケージには、ルーター、13 のファミリールート、158 の運用トピック別スキル、および記事レベルの補足資料が含まれています。これは Apple とは独立したものです。参照元は、日付が明記された英語版 HIG のスナップショットです。新しいリリースや見解の分かれる詳細に依存するタスクでは、公式ソースを確認してください。

タスクのルートを決める

1. リクエストまたはプロジェクトから、対象プラットフォーム、デバイスの利用状況、ユーザーのタスクを特定します。回答に実質的な影響があり、かつ推測できない場合に限り、プラットフォームを尋ねてください。ユーザーが指定したフレームワークと製品要件は維持してください。
2. 以下から該当するファミリーを選び、そのファミリーの SKILL.md を読みます。そこから .topics/ にある該当トピックの手順へのリンクをたどり、その SKILL.md を読みます。記載された判断手順を適用し、事実とプラットフォームごとの条件について補足資料を参照してください。トピックスキルは、インストール済みのファイルパスを指定して明示的に読み込みます。ネストされたファイルの自動検出は不要です。 プラットフォームの対応状況、製品としての実現可能性、またはプラットフォームへの適応については、まず該当する各プラットフォームの「はじめに」の手順を読み、その後に特定のコンポーネントまたはテクノロジーの手順を読みます。プラットフォームのモデルと、対象サーフェスの対応範囲の制限の両方を確認してください。
3. ルートを確定する前に、トピックの完全なインデックスで、タスクに関する概念とコンポーネント名またはフレームワーク名を検索します。インデックスのトリガー説明は、日常的な製品に関するリクエストと Apple のトピック名を結び付けています。ユーザーが Apple のフレームワーク名を挙げる必要はありません。補足資料を読む前に、該当するファミリーとトピックの手順を読みます。質問の範囲が狭い場合は、コーパス全体を読み込まず、関連する行を検索してください。 スクリーンショットに関する質問やアニメーションの例については、利用可能な場合、元のビジュアル解説も参照してください。
4. 共通のガイダンスと、対象プラットフォームで文書化されている違いを適用します。プラットフォーム別の節がない場合、追加の規則が記載されていないことを意味します。対応状況、適用対象かどうか、またはプラットフォーム間で挙動が同一であることの証明にはなりません。
5. タスクが複数のファミリーにまたがる場合は、それらを組み合わせます。コンポーネントには、アクセシビリティ、タイポグラフィ、ローカライズ、入力、システム体験に関するガイダンスも必要な場合があります。依頼内容に含まれる重要な判断事項を、それぞれのトピックに対応付けてください。プライバシーやアクセシビリティなど明示的に挙げられた懸念事項については、影響を受けるコンポーネントに加えて、それを担当する手順も読みます。隣接する手順にある注意書きだけでは不十分です。必要に応じて、プラットフォーム別・タスク別ルートを利用してください。 レビューでは、マークアップや挙動が欠けている場合でも、提示された各コントロールを、該当するコンポーネント手順の候補に対応付けます。それを確認事項の設定に利用してください。証拠がないからといって、不具合があると証明されるわけでも、そのコントロールが対象範囲から除外されるわけでもありません。

すべてのパスは、シェルの現在のディレクトリではなく、このインストール済みパッケージからの相対パスです。ガイダンスを読むために、Python、ネットワーク、同階層のスキルのインストール、または執筆用キャッシュは必要ありません。

タスク	参照するトピックのスキル
プラットフォームの慣例、設計原則、ゲーム、デバイスへの適応	はじめに
アクセシビリティ、タイポグラフィ、カラー、マテリアル、レイアウト、ローカライズ、プライバシー	基礎
オンボーディング、読み込み、検索、共有、アカウント、フィードバック、メディア、設定	パターン
チャート、画像、テキストビュー、埋め込みウェブコンテンツ	コンテンツ
リスト、コレクション、分割ビュー、タブビュー、開示とグループ化	レイアウトと構成
ボタン、メニュー、ツールバー、メニューバー、オーナメントとアクション	メニューとアクション
サイドバー、タブバー、検索フィールド、トークン、パスコントロール	ナビゲーションと検索
アラート、シート、ポップオーバー、パネル、スクロール、ウインドウ	プレゼンテーション
テキストフィールド、ピッカー、スライダー、トグル、選択コントロール	選択と入力
進行状況、アクティビティ、ゲージ、評価	ステータス
ウィジェット、Live Activities、通知、Siriのスニペット、システムサーフェス	システムエクスペリエンス
タッチ、キーボード、ポインタ、フォーカス、視線、ジェスチャ、コントローラ、センサー	入力
Apple Pay、購入、Siri、VoiceOver、AI、CarPlay、統合	テクノロジー

依頼された作業を実行する

問題点やフレームワークを判断する前に、提供された概要、フロー、コード、仕様、または画像を確認してください。ユーザーが指定したモードを使用してください。

• 設計： トピックの判断手順に基づき、具体的な遷移と受け入れ基準を含む、実装可能な仕様またはインタラクション／状態モデルを作成します。選択した内容をユーザーのタスクと対象プラットフォームに結び付けます。
• 実装： 必要な動作を提供する場合は、プロジェクトのネイティブなシステムコンポーネントを優先します。HIGはエクスペリエンス要件を説明するものであり、API名、利用可能性、コードについては適切なSDKドキュメントで確認してください。既存のスタックで許可された変更を行います。説明文だけでは実装依頼を完了したことにはなりません。
• レビュー： 確認できた問題、その影響、関連するHIGのルール、具体的な修正を説明します。情報源に基づく指摘と独自の改善提案を区別します。根拠を確認せずに違反を作り上げないでください。
• 適応： 移行先プラットフォームのインタラクションモデルを適用しながら、製品のタスク、データ、有用な状態を維持します。設計仕様が求められている場合は、提供された成果物に修正を加えるか、変更前後の明確な契約を提示します。

トピックの手順はフレームワークに依存しません。具体例や擬似コードは判断方法を示すものであり、プロジェクトの技術を置き換えることを求めるものではありません。実際に判断に関係する場合に限り、関連する手順を読み込んでください。

トピックの観察可能なチェックを完了し、合格、失敗、未実施を分けて報告してください。ファイルを読んだこと、Appleを引用したこと、テストを提案したことだけでは、実行時の動作を確認したことにはなりません。静的コードやスクリーンショットでは、支援技術での読み上げ順、ネイティブなレンダリング、身体的な快適さ、触覚フィードバック、SDKでのコンパイルを証明できません。

重要な推奨事項には、公式の記事／セクションへのリンクを含めてください。「検討する」「優先する」「避ける」といった条件やニュアンスを保ち、設計上の助言を根拠のない普遍的な要件に変えないでください。数値仕様では単位とプラットフォームの適用範囲を維持してください。情報源の記述が矛盾する場合は、黙って内容を変えるのではなく、矛盾と保守的な適用方法を説明してください。

ソースの範囲

これは包括的なローカルガイダンスであり、Apple のマニュアルや SDK API リファレンスを逐語的に再現したものではありません。元のメディアの説明は記事への参考情報であり、ソースページは視覚的なデモに引き続き役立ちます。ソースのスナップショットとレビュー状況はリポジトリのカバレッジレポートに記載されており、通常のスキル読み込みの対象外です。ローカルファイルが存在するというだけで、ソースが個別にレビュー済みだと判断しないでください。

以前の navigation-bars のリンクは現在の Toolbars のガイダンスに、in-app-purchase は Apple In-App Purchase に移動します。このスナップショットの時点では、古い Touch Bar と Messages for Business の HIG ページは利用できません。これらの現行ルールを捏造しないでください。翻訳、アーカイブされたページ、リンク先の SDK／WWDC ライブラリ全体はソースの範囲外です。