Human Interface Guidelines

検索

人々はさまざまな検索技術を使用して、デバイス上、アプリ内、文書またはファイル内のコンテンツを検索します。

アプリ内のコンテンツを検索するために、人々は一般的に検索バーを使用することを期待しています。理にかなっている場合は、人々があなたのアプリをどのように操作するかについて知っていることを使用して、検索体験をパーソナライズできます。たとえば、最近の検索や検索履歴を表示したり、あなたのアプリで人々が以前に検索した用語に基づいて検索用語の提案、補完、修正を提供したりできます。ガイダンスについては、検索フィールドを参照してください。

場合によっては、人々は検索の範囲を設定したり、結果をフィルタリングしたりできることを高く評価しています。たとえば人々は、作成日、ファイルサイズ、ファイルタイプなどの属性を指定して、アイテムを検索したい場合があります。ガイダンスについては、スコープバーを参照してください。iOS、iPadOS、または macOS アプリのウィンドウまたはページでコンテンツを検索する方法を実装することで、開いている文書またはファイル内のコンテンツを人々が検索できるように支援することもできます。

iOS、iPadOS、および macOS では、Spotlight は、人々がシステム内および Web 上のすべてのアプリでコンテンツを検索するのに役立ちます。あなたのアプリのコンテンツに関する情報をインデックス化して提供すると、人々は Spotlight を使用して、あなたのアプリを最初に開かなくてもアプリに含まれるコンテンツを検索することができます。

ベストプラクティス

あなたのアプリのコンテンツを検索可能にします。 コンテンツをインデックス化可能にし、メタデータ と呼ばれる説明的な属性を指定することで、Spotlight とコンテンツを共有できます。Spotlight は、この情報を抽出、保存、および整理して、高速で包括的な検索を可能にします。

処理すべきカスタムファイルタイプのメタデータを定義します。 あなたのファイル形式に含まれるメタデータのタイプを記述する Spotlight File Importer プラグインを提供します。開発者向けガイダンスについては、CSImportExtension (CSImportExtension) を参照してください。

Spotlight を使用して、あなたのアプリのコンテキスト内で高度なファイル検索機能を提供します。 たとえば、現在の選択に基づいて Spotlight 検索を即座に開始するボタンを含めることができます。次に、検索結果またはそれらのフィルタリングされたサブセットを表示するカスタムビューを表示できます。

システムが提供する [開く] ビューと [保存] ビューを使用することをお勧めします。 システムが提供する [開く] ビューと [保存] ビューには、通常、システム全体を検索およびフィルタリングするために使用できる組み込みの検索フィールドが含まれています。関連するガイダンスについては、ファイル管理を参照してください。

あなたのアプリがカスタムファイルタイプを生成する場合は、クイックルックジェネレーターを実装して下さい。 クイックルックジェネレーターは、Spotlight やその他のアプリがドキュメントのプレビューを表示するのに役立ちます。開発者向けガイダンスについては、QuickLook (QuickLook) を参照してください。