> ## Documentation Index > Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # ダイナミックテキストボックス export const InlineImage = ({src, alt = '', height = '1.6em'}) => { return {alt}

; }; ## はじめにダイナミックテキストボックスは、標準の [テキストボックス](/ja/s/article/360043429593) と同じく、テキストを含むカードを作成するのに使用できます。両者の違いは、標準のテキストボックスでは、ボックス内のテキストがDataSetから直接取得され、使用できるマクロが1つだけであることです。このマクロにより、選択した値列の最初の値を動的に参照できます。ダイナミックテキストボックスでは、ユーザー自身がテキストを入力しますが、10数種のマクロが利用できるため、選択したカテゴリーと値列から、変化率、列名、最初の値/最終値/最後から2番目の値、最小/最大/平均値、最初または最後のカテゴリーといった情報を参照することができます。ダイナミックテキストボックスでは、データが更新されるたびに更新される動的フィールドを備えたテキストカードを作成できます。以下に示すカードの例では、呼び出されたすべてのフィールドが、DataSetの内容にもとづいて動的に更新されるように設定されています。

テキストは、どれだけ長くてもかまいません。またどんな文字も使用可能です。テキストの書式は、中央揃え、左揃え、右揃え、余白スペースの調整が可能です。フォントサイズ、色、スタイルを変更することもできます。これらのオプションとその他のオプションについては、以下で説明します。この記事では、以下のトピックでダイナミックテキストボックスの使用方法を説明します。 * [ダイナミックテキストボックスを作成する](#powering) * [ダイナミックテキストボックスをカスタマイズする](#customize) ## ダイナミックテキストボックスを作成するダイナミックテキストボックスでは、DataSetから2列または2行のデータが必要です。一方の列はマクロを取得する *カテゴリー* 列を参照し、もう一方の列は *値* 列を参照します。例えば、「ある［地域］の売上高は［値（額）］でした」というテキストを表示したい場合、地域名の列を **［カテゴリー］** フィールドに、値の列を **［値］** フィールドにドラッグします。すると、DataSetから最初のカテゴリーや値がプレビューに取り込まれますが、この時点での表示は満足できるものではないかもしれません。有益なデータをカードに表示するには、 **［チャートの設定］>［一般］>［テキスト］** の順に進み、必要なテキストおよび選択した列のデータを参照するマクロを入力します。［チャートの設定］については、後述する「 [ダイナミックテキストボックスをカスタマイズする](#customize) 」で説明します。値、カテゴリー、系列データの詳細については、「 [チャートデータについて](/s/article/360043428693 "チャートデータについて") 」を参照してください。 Analyzerで、テキストボックスで使用するデータを含む列を選択します。データ列の選択の詳細については、「 [DataSet列をチャートに適用する](/s/article/360043428713 "DataSet列をチャートに適用する") 」を参照してください。 Analyzerでチャートをフォーマットする方法の詳細については、「 [可視化カード作成パート2：Analyzer](/s/topic/0TO5w000000ZaoUGAS "KPIカード作成パート2：Card Builder") 」を参照してください。 ## ダイナミックテキストボックスをカスタマイズするダイナミックテキストボックスの外観をカスタマイズするには、いくつかの方法があります。マクロを使用して、テキストボックスに表示するテキストを指定できます。また、書式、余白スペース、フォントサイズ、色、スタイルなども変更できます。 ### テキストとマクロを定義する選択したダイナミックテキストチャートのAnalyzerで、 **［チャートの設定］** > **［一般］** > **［テキスト］** の順に進み、テキストボックスに表示させるテキストを指定します。利用できるマクロを表示するには、を選択します。ダイナミックテキストplus.jpg

例えば、テキストボックスのテキストに「［日付］の最初の売上、［日付］の最後の売上」と表示したい場合、「 `［最初の値］の最初の売上、［最後の値］の最後の売上` 」と入力します。すると、データが更新されるたびに、［最初の値］と［最後の値］のマクロによって最新データに更新されます。ダイナミックテキストexample.jpg

以下のマクロがすべて利用可能です。

マクロ	説明
平均値	選択した値列のすべての値の平均値を返します。
カテゴリー行の名前	選択したカテゴリー列の名前を返します。
割合を変更	選択した値列のすべての値に対する変化の割合を返します。
値を変更	選択した値列のすべての値に対する変化の量を返します。
最初のカテゴリー	選択したカテゴリー列の最初のカテゴリー（つまり最上位のカテゴリー）の値を返します。
最初の値	選択した値列の最初の値（つまり最上位の値）を返します。
アイテムカウント	データの行数を返します。
最後のカテゴリー	選択したカテゴリー列の最後のカテゴリー（つまり最下位のカテゴリー）の値を返します。
最後の値	選択した値列の最後の値（つまり最下位の値）を返します。
最大カテゴリー	選択したカテゴリー列の最大カテゴリーの値を返します。これは通常、最新の日付が返される日付列に適用されます。
最大値	選択した値列の最高値を返します。
中央値	選択した値列の中央値を返します。
最小カテゴリー	選択したカテゴリー列の最小カテゴリーの値を返します。これは通常、最も古い日付が返される日付列に適用されます。
最小値	選択した値列の最低値を返します。
最後から2番目のカテゴリー	選択したカテゴリー列の2番目のカテゴリーの値を返します。
最後から2番目の値	選択した値列の2番目の値を返します。
行の名前の値	選択した値列の名前を返します。

### その他のプロパティをカスタマイズするすべてのチャートのプロパティについては、「 [チャートのプロパティ](/s/topic/0TO5w000000ZaodGAC "チャートのプロパティ") 」を参照してください。以下の表では、ダイナミックテキストボックスに固有のプロパティを説明します。これらのプロパティを調整する場合、 **［チャートの設定］** > **［一般］** に進みます。

プロパティ	説明
［一般］>［値を短縮］	このボックスにチェックを入れると、テキストボックスの値は省略形で表示されます。
［一般］>［フォントサイズ］	テキストボックスのテキストのフォントサイズを選択できます。小から特大までさまざまなサイズが利用できます。［デフォルト］を選択すると、利用可能なスペースに最も適したサイズが選択されます。例えば、利用可能スペースが最大の場合、特大サイズで表示されます。
［一般］>［フォントスタイル］	テキストのフォントスタイルを、プレーン、太字、斜体、太字斜体から選択できます。
［一般］>［フォントの色］	テキストの色を選択できます。
［一般］>［横方向のテキスト調整］	横方向のテキスト調整を選択します。
［一般］>［縦方向のテキスト調整］	テキストボックス内のテキストを、上揃え、上下中央揃え、下揃えのいずれで表示するかを決定します。
［一般］>［上部余白］	テキスト上部のスペースの量をピクセル単位で決定します。
［一般］>［下部余白］	テキスト下部のスペースの量をピクセル単位で決定します。
［一般］>［左余白］	テキスト左側のスペースの量をピクセル単位で決定します。
［一般］>［右余白］	テキスト右側のスペースの量をピクセル単位で決定します。
［変化値のオプション］>［最初の値に適用］	フォーマットの変更をデータの最初の値に適用するかどうかを決定します。
［変化値のオプション］>［最後の値に適用］	フォーマットの変更をデータの最後の値に適用するかどうかを決定します。
［変化値のオプション］>［最小値に適用］	フォーマットの変更をデータの最小値に適用するかどうかを決定します。
［変化値のオプション］>［最大値に適用］	フォーマットの変更をデータの最大値に適用するかどうかを決定します。
［変化値のオプション］>［データ］	フォーマットの変更をデータの最初と最後の値に適用するか（デフォルト）、最後の2つの値に適用するかを決定します。
［変化値のオプション］>［色の方向を逆にする］	このボックスにチェックを入れると、データの負の値は、［正の値の色］で選択した色で表示されます。正の値の場合は［負の値の色］で表示されます。
［変化値のオプション］>［正の値の色］	テキストボックスで正の変化値/割合を表すのに使用される色を決定します。
［変化値のオプション］>［負の値の色］	テキストボックスで負の変化値/割合を表すのに使用される色を決定します。

日本語