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

Livesearch マクロの使用

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

  1. In the Confluence editor, choose Insert > Other Macros.
  2. Find and select the required macro.

オートコンプリートでマクロを素早く入力する方法

Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Using Autocomplete.

既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。マクロのパラメータが編集可能な場合、マクロのダイアログ ウィンドウが開きます。


パラメーター

Parameters are options that you can set to control the content or format of the macro output. Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets (example).

パラメーター

既定

説明

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

すべてのスペース

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

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

コー​​ドの例

次の例は、Confluence ページの基本的なマークアップを調べたり、編集したりする上級ユーザー向けに提供されています。 

マクロ名: livesearch

マクロ本文: なし。

保存形式の例

<ac:structured-macro ac:name="livesearch">
  <ac:parameter ac:name="additional">page excerpt</ac:parameter>
  <ac:parameter ac:name="placeholder">Search this space</ac:parameter>
  <ac:parameter ac:name="labels">myLabel</ac:parameter>
  <ac:parameter ac:name="spaceKey">
    <ri:space ri:space-key="SS"/>
  </ac:parameter>
  <ac:parameter ac:name="type">page</ac:parameter>
  <ac:parameter ac:name="size">large</ac:parameter>
</ac:structured-macro>

Wiki マークアップ例

{livesearch:spaceKey=DOC|size=large|placeholder=Search this space}
  • ラベルなし