オートコンプリート エクスペリエンスを迅速に構築できる JavaScript ライブラリ
始めるために必要なのは次のとおりです。
オートコンプリートの結果に入力されるデータはソースと呼ばれます。ソースには、検索用語の静的なセット、Algolia インデックスなどの外部ソースからの検索結果、最近の検索など、必要なものを何でも使用できます。
これら 2 つの必須パラメータ ( container
とgetSources
) だけを構成することで、インタラクティブなオートコンプリート エクスペリエンスを得ることができます。ライブラリは入力を作成し、対話性とアクセシビリティ属性を提供しますが、出力する DOM 要素を完全に制御できます。
ドキュメント • API • プレイグラウンド
推奨される開始方法は、 autocomplete-js
パッケージを使用することです。これには、JavaScript オートコンプリート エクスペリエンスをレンダリングするために必要なものがすべて含まれています。
それ以外の場合、レンダラーを最初から構築する場合は、 autocomplete-core
パッケージをインストールできます。
すべての Autocomplete パッケージは、npm レジストリで入手できます。
yarn add @algolia/autocomplete-js
# or
npm install @algolia/autocomplete-js
パッケージ マネージャーを使用しない場合は、HTML script
要素を使用できます。
< script src =" https://cdn.jsdelivr.net/npm/@algolia/autocomplete-js " > </ script >
< script >
const { autocomplete } = window [ '@algolia/autocomplete-js' ] ;
</ script >
始めるには、オートコンプリートを入れるためのコンテナが必要です。まだコンテナを持っていない場合は、マークアップにコンテナを挿入できます。
< div id = "autocomplete" > < / div >
次に、 autocomplete
関数を呼び出してcontainer
を指定することで、オートコンプリートを挿入します。 CSS セレクターまたは要素にすることができます。
input
ではなく、必ずコンテナー ( div
など) を指定してください。オートコンプリートは、完全にアクセス可能な検索ボックスを生成します。
import { autocomplete } from '@algolia/autocomplete-js' ;
autocomplete ( {
container : '#autocomplete' ,
// ...
} ) ;
スタートガイドを読み続けてください。
ドキュメントでは、オートコンプリート ライブラリについて学ぶためのいくつかの方法が提供されています。
詳細については、ドキュメントを参照してください。
パッケージ | 説明 | ドキュメント |
---|---|---|
autocomplete-js | オートコンプリート用の JavaScript パッケージ | ドキュメント |
autocomplete-core | オートコンプリート エクスペリエンスを構築するための JavaScript コア プリミティブ | ドキュメント |
autocomplete-plugin-recent-searches | 最近の検索をオートコンプリートに追加するプラグイン | ドキュメント |
autocomplete-plugin-query-suggestions | オートコンプリートにクエリの提案を追加するプラグイン | ドキュメント |
autocomplete-plugin-algolia-insights | Algolia Insights をオートコンプリートに追加するプラグイン | ドキュメント |
autocomplete-plugin-redirect-url | リダイレクトURLを有効にするプラグイン | ドキュメント |
autocomplete-plugin-tags | オートコンプリートでタグのリストを管理および表示するプラグイン | ドキュメント |
autocomplete-preset-algolia | オートコンプリートで Algolia 機能を使用するためのプリセット | ドキュメント |
autocomplete-theme-classic | オートコンプリートのクラシックテーマ | ドキュメント |
オートコンプリートを使用して人々が構築した素晴らしいエクスペリエンスをご覧ください。
ドキュメントサーチ | アルゴリズムのドキュメント |
詳細については、ショーケースをご覧ください。
オートコンプリートを使用してサンドボックスをチェックアウトします。
マサチューセッツ工科大学