Confluence サポート

Livesearch マクロを使用すれば、Confluence ページに検索ボックスを追加できます。ユーザーが検索ボックスに検索語を入力すると、Confluence は入力と同時に一致する結果を動的に表示します。

Livesearch マクロの使用

ページに Livesearch マクロを追加する方法

オートコンプリートを活用して素早く入力: 「{」とマクロ名の先頭を入力すると、マクロ候補の一覧が表示されます。この例では、cheese マクロを挿入します。

既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。これによりマクロの詳細を開き、マクロのパラメーターを編集できます。

パラメーターは、マクロ出力の内容や形式を制御するために設定できるオプションです。Confluence の保存形式または wiki マークアップで使用されるパラメータ名がマクロブラウザで使用されるラベルと異なる場合、以下の一覧に括弧付きで表示されます (example)。

パラメーター	既定	説明
このスペースキーに制限 `(spaceKey`)	すべてのスペース	スペースキーを指定して、検索を指定したスペースに制限します。大文字と小文字が区別されます。あるいは、`@self` を使用して、検索範囲を現在のスペースに制限します。
ラベルに制限する `(labels`)		ラベルを指定して、検索をそのラベルが付けられているコンテンツに制限します。指定しない場合、ラベルにかかわらずすべてのコンテンツを検索します。
サイズ `(size`)	Medium	中程度または多数の検索フィールドサイズを選択する
プレースホルダーテキスト `(placeholder`)		検索フィールドに表示されるプレースホルダーテキストを指定します。例：「このスペースを検索」
タイプ `(type`)	すべて	検索に含むコンテンツタイプを指定 - ページ、ブログ、コメント、スペースの説明やすべてのコンテンツタイプから選択します。
追加情報 `(additional`)	スペース名	検索結果にスペース名、ページ例外を表示するか、何も表示しません。

以下の例は、エディタ外部 (スペースのサイドバー、ヘッダー、フッターのカスタムコンテンツなど) でマクロを追加する場合に便利です。

マクロ名: livesearch

マクロ本文: なし。

{livesearch:spaceKey=DOC|size=large|placeholder=Search this space}