This example demonstrates how you can pass parameters to your macro. We'll create a font style macro which has two parameters to allows the user to specify the colour and size of the text contained in the macro body.

Before you start, see Writing user macros for an introduction to creating your own user macros. 

  1. Go to  > General Configuration > User Macros.
  2. Choose Create a User Macro.
  3. マクロの詳細を入力します (以下の表を参照)。
  4. 追加を選択します。
フィールド値
macroNamestylish
表示方法Visible to all users in the Macro Browser
マクロ タイトルStylish
説明 Applies colour and size to text.
カテゴリConfluence Content
アイコンの URLこのフィールドは空白のまま残すことができます
ドキュメント URLこのフィールドは空白のまま残すことができます
マクロ本文処理Rendered
テンプレート

テンプレート フィールドに以下のコードを入力します。マクロで 1 つ以上のパラメーターが必要な場合、$param0 から $param9 の変数を使用してそれらを表すことができます。

## @param 0:title=colour|type=string
## @param 1:title=size|type=string
<span style="color: $param0; font-size: $param1">$body</span>

また、マクロで明示的に名前の付いたパラメターを使用することもできます。これらのマクロ パラメーターは $param<x> という名前の変数として表示されます。<x> はパラメーターの名前です。 

## @param Colour:title=colour|type=string
## @param Size:title=size|type=string
<span style="color: $paramColour; font-size: $paramSize">$body</span>
  • ラベルなし