Livesearch マクロ
Livesearch マクロをページに追加すると、完全にカスタム可能な検索フィールドを提供できます。検索フィールドで入力を開始すると、一致するページ、ブログ、またはコメントの候補が表示されます。
このマクロは、以下の要件がある場合に適しています。
- ナレッジベースなど、現在のスペースを検索する方法を提供する
- 特定のラベルが付いたページなど、特定のタイプのコンテンツの検索を促す
スペース、ラベル、コンテンツ タイプで検索を制限することができるため、スペースを表示するユーザーに、対象をかなり絞った検索を実行する機能を提供できます。
スクリーンショット: 検索用語 "printer" の検索結果を示す、Livesearch マクロを含むページ。
このマクロをページに追加する
ページに Livesearch マクロを追加する方法
- [Unable to render {include} The included page could not be found. ({include} をレンダリングできません。ページが見つかりませんでした)] を選択し、
- [ナビゲーション] カテゴリから [Livesearch] を選択します。
- 以下のパラメーターを使用して、検索対象のコンテンツを絞り込みます。
- [挿入] をクリックします。
その後、ページを公開するとマクロの動作を確認できます。
スクリーンショット: 特定のスペースで特定のラベルが付いたページを検索するための Livesearch マクロの設定。
マクロ パラメーターを変更する
このマクロで使用できるパラメーターの一覧は、次のとおりです。
パラメーター | 既定 | 説明 |
---|---|---|
このスペース キーに制限 | すべてのスペース | スペース キーを指定して、1 つのスペースに検索を制限します。大文字と小文字が区別されます。複数のスペースを指定することはできません。 あるいは、 |
ラベルに制限する(labels ) | ラベルを指定して、検索をそのラベルが付けられているコンテンツに制限します。指定しない場合、ラベルにかかわらずすべてのコンテンツを検索します。 | |
サイズ(size ) | Medium | 中程度または多数の検索フィールド サイズを選択する |
プレースホルダー テキスト(placeholder ) | 検索フィールドに表示されるプレースホルダー テキストを指定します。例:「このスペースを検索」 | |
タイプ(type ) | すべて | 検索に含むコンテンツ タイプを指定 - ページ、ブログ、コメント、スペースの説明やすべてのコンテンツ タイプから選択します。 |
追加情報(additional ) | スペース名 | 検索結果にスペース名、ページ例外を表示するか、何も表示しません。 |
このマクロを追加するその他の方法
手入力でこのマクロを追加する
[Unable to render {include} The included page could not be found. ({include} をレンダリングできません。ページが見つかりませんでした)] を選択し、
Wiki マークアップを使用してこのマクロを追加する
[Unable to render {include} The included page could not be found. ({include} をレンダリングできません。ページが見つかりませんでした)] を選択し、
マクロ名: livesearch
マクロ本文: なし。
{livesearch:spaceKey=DOC|size=large|placeholder=Search this space}
最終更新日 2020 年 5 月 20 日
Powered by Confluence and Scroll Viewport.