変数と式

ページやスペースで参照できる再利用可能な変数を作成します

変数を使うと、条件付きで参照できる再利用可能なテキストを 式 と 自動適応コンテンツの条件.

コンテンツ内で同じ名前、フレーズ、またはバージョン番号を何度も繰り返す場合は、 変数 を作成して、それらのすべての箇所を同期させ、正確に保つことができます。これは、更新が必要になったときや、複雑で誤入力が多い場合に役立ちます。

変数は、単一のページまたは単一のスペースにスコープを限定して作成できます。

新しい変数を作成する

新しい変数を作成するには、開いている ライブラリ の編集時に目次内の 変更リクエストをクリックし、次に 変数.

をクリックします。上部の切り替えを使って、現在のページに限定した変数、または現在のスペース内のすべてのページに限定した変数を表示・作成できます。

クリックすると 変数を作成 というモーダルが開き、変数の名前と値を設定できます。

クリック 変数を追加 して変数を保存します。

変数は、単一のページまたはスペース全体に追加できます。変数の値を更新すると、その変数のすべてのインスタンスが更新されます。

変数名は文字で始まる必要があり、文字、数字、アンダースコアを含めることができます。

コンテンツ内で変数を使用する

変数は 式 内で参照して使用できます。式はコンテンツ内にインラインで挿入できます。式を挿入したら、ダブルクリックして式エディターを開きます。

式は、ドキュメントのページコンテンツ内でのみ使用できます。ページタイトルやページメタデータでは使用できません。

ページで定義された変数は、 page.vars オブジェクトから参照できます。同様に、スペース全体で定義された変数は、 space.vars オブジェクトから参照できます。

式内でコンテンツに変数を追加できます。式エディターには、必要な変数を見つけやすくするための自動補完オプションがあります。

変数を更新する

変更リクエスト内であれば、任意の時点で変数を更新できます。値を更新すると、それを参照しているすべての式ブロックで値が更新されます。変更された変数は、変更リクエストがマージされると、公開済みのサイトに反映されます。