テキスト

1 行の文字列を表示するコンポーネントです。文字の色、サイズ、太さを指定できます。

送信するテキストメッセージは多言語に対応しており、クライアントのデバイスの設定言語に合わせて表示を切り替えることができます。

Request Content {#text-request-parameter}

パラメータタイプ説明
typestring"text"
required
textstring表示されるテキスト
text プロパティや contents プロパティの中から必ず 1 つを設定してください。
contents プロパティを設定すると、text プロパティは無視されます。
required
contentsarray of objectsスパン の配列
text プロパティや contentsプ ロパティのいずれかを必ず設定してください。
contents プロパティを設定すると、textプロパティは無視されます。
flexnumber親要素内における、このコンポーネントの幅または高さの比率
詳しくは、レイアウト > コンポーネントの幅と高さ を参照してください。
marginstring親要素内での、特定のコンポーネントとその前のコンポーネントとの間に挿入される余白の最小サイズ
詳しくは、レイアウト > コンポーネントの margin プロパティ を参照してください。
positionstringoffsetTop、offsetBottom、offsetStart、offsetEnd の基準
以下のいずれかの値を指定します。

• relative : 直前のボックスを基準とします。
• absolute : 親要素の左上を基準とします。

デフォルト値は relative です。
詳しくは、レイアウト > オフセット を参照してください。
offsetTopstring上側のオフセット
詳しくは、レイアウト > オフセット を参照してください。
offsetBottomstring下側のオフセット
詳しくは、レイアウト > オフセット を参照してください。
offsetStartstring左側のオフセット
詳しくは、レイアウト > オフセット を参照してください。
offsetEndstring右側のオフセット
詳しくは、レイアウト > オフセット を参照してください。
sizestring文字サイズ
xxs、xs、sm、md、lg、xl、xxl、3xl、4xl、5xl 以下のいずれかの値を指定します。
列挙した順に文字のサイズが大きくなります。

デフォルト値は md です。
alignstring水平方向の配置方式
詳しくは、レイアウト > 水平方向の配置 を参照してください。
gravitystring垂直方向の配置方式
詳しくは、レイアウト > 垂直方向の配置 を参照してください。
wrapbooleantrue を指定すると文字列を折り返します。
デフォルト値は false です。
true に設定した場合には、改行文字 ("\n") を使って改行できます。

詳しくは、要素 > テキストの折り返し を参照してください。
maxLinesnumber最大行数
最大行数を設定するためには wrap パラメータを true に指定します。

テキストが指定された行数に収まりきらない場合には、最後の行の最後に省略記号 ("...") が表示されます。
値を 0 ではすべてのテキストが表示されます。

デフォルト値は 0 です。
weightstring文字の太さ
regular または bold のいずれかの値を指定できます。
bold を指定すると太字になります。

デフォルト値は regular です。
colorstring文字の色
16 進数カラーコードで設定します。
actionobjectテキストをタップすると実行されるアクション
Action Object を指定します。
stylestringテキストを表示するスタイル
以下のいずれかの値を指定します。

• normal : 標準
• italic : イタリック体

デフォルト値は normal です。
decorationstringテキストの装飾
以下のいずれかの値を指定します。

• none : 装飾なし
• underline : 下線
• line-through : 取り消し線

デフォルト値は none です。

Request Example {#text-request-example}

{  "type": "bubble",  "body": {    "type": "box",    "layout": "vertical",    "contents": [      {        "type": "text",        "text": "The work site begins to move.",        "size": "sm",        "align": "center",        "color": "#ff0000"      },      {        "type": "text",        "text": "The work site begins to move.",        "size": "md",        "align": "center",        "color": "#00ff00"      },      {        "type": "text",        "text": "The work site begins to move.",        "size": "lg",        "align": "center",        "weight": "bold",        "color": "#0000ff"      }    ]  }}