Livesearch マクロを挿入する

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

Livesearch マクロを使用する

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

  1. 編集時には、ツールバーから を選択します。

  2. マクロを名前で検索して選択します。

  3. 必要に応じて設定します。

このページに「/」と入力して、ツールバーから を選択することで、同じリストを表示することもできます。続けてマクロの名前を入力して、リストをフィルタリングします。

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

  1. マクロのプレースホルダーを選択します。

  2. [編集] アイコン を選択して、設定パネルを開きます。

  3. パラメーターを設定します。変更内容は、移動するごとに保存されます。

  4. ページの編集を再開すると、パネルが閉じます。

中央揃え アイコン、幅 アイコン、全幅 アイコンを選択して一部のマクロの幅を調整することもできます。マクロを削除するには、ごみ箱 アイコンを選択します。

パラメーター

パラメーターとは、設定してマクロの内容をページに表示する方法を制御できるオプションです。 

Confluence Cloud ストレージ形式または wikimarkup で使用されるパラメーター名が、ブラウザやスラッシュ コマンドを使用してマクロを挿入する際に使用されるラベルと異なる場合は、下記の角括弧内に記載します (example)。

パラメーター

既定

説明

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

すべてのスペース

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

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

ラベルに制限
(labels

 

ラベルを指定して、検索をそのラベルが付けられているコンテンツに制限します。指定しない場合、ラベルにかかわらずすべてのコンテンツを検索します。

サイズ 
(size

Medium

中程度または多数の検索フィールド サイズを選択する

プレースホルダー テキスト
(placeholder

 

検索フィールドに表示されるプレースホルダー テキストを指定します。例:「このスペースを検索」

タイプ
(type

すべて

検索に含むコンテンツ タイプを指定 - ページ、ブログ、コメント、スペースの説明やすべてのコンテンツ タイプから選択します。

追加情報
(additional)

スペース名

検索結果にスペース名、ページ例外を表示するか、何も表示しません。

Wiki マークアップの例

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

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

マクロ名: livesearch

マクロ本文: なし。

1 2 3 4 {livesearch:spaceKey=DOC|size=large|placeholder=Search this space}

 

その他のヘルプ