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

Livesearch マクロを使用する

Livesearch マクロを追加するには、次の手順に従います。

  1. Confluence エディタで、 > [詳細を表示] の順に選択します。
  2. 挿入するアイテムを探して選択します
  3. [挿入] を選択します。

このページに「/」と入力して、ツールバーからを選択し、同じリストを表示することも可能です。


Livesearch マクロを編集するには、次の手順に従います。

  1. マクロのプレースホルダーを選択します。フローティング ツールバーが表示されます。
  2. [編集] を選択します。右側のパネルが開きます。
  3. パラメータを修正します。変更内容は、移動するごとに保存されます。
  4. ページの編集を再開すると、パネルが閉じます。

パラメーター

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

パラメーター

既定

説明

このスペース キーに制限
(spaceKey

すべてのスペース

スペース キーを指定して、検索を指定したスペースに制限します。大文字と小文字が区別されます。

あるいは、@self を使用して、検索範囲を現在のスペースに制限します。

ラベルに制限する
(labels

ラベルを指定して、検索をそのラベルが付けられているコンテンツに制限します。指定しない場合、ラベルにかかわらずすべてのコンテンツを検索します。
サイズ
(size
Medium中程度または多数の検索フィールド サイズを選択する
プレースホルダー テキスト
(placeholder

検索フィールドに表示されるプレースホルダー テキストを指定します。例:「このスペースを検索」
タイプ
(type
すべて検索に含むコンテンツ タイプを指定 - ページ、ブログ、コメント、スペースの説明やすべてのコンテンツ タイプから選択します。
追加情報
(additional)
スペース名検索結果にスペース名、ページ例外を表示するか、何も表示しません。

Wiki マークアップの例

Wiki マークアップは 従来のエディタでのみサポートされます。


robotsnoindex
robotsnoindex

Wiki マークアップはエディタ外部でマクロを追加する必要がある場合 (スペースのサイドバー、ヘッダー、またはフッターのカスタム コンテンツなど) に便利です。

マクロ名:  livesearch

マクロ本文: なし。

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