テキスト機能

  • [アーティクル]

TextBlock は、テキストの書式設定とローカライズのための高度な機能を提供します。

マークダウン (Commonmark サブセット)

インライン マークアップをサポートするために、アダプティブ カードでは Commonmark マークダウン構文のサブセットがサポートされます。

注意

RichTextBlock はマークダウンをサポートしていませんが、TextRun 内でさまざまなテキスト構成オプションを提供しています

サポート対象

テキスト スタイル マークダウン
太字 **Bold**
斜体 _Italic_
箇条書きリスト - Item 1\r- Item 2\r- Item 3
番号付きリスト 1. Green\r2. Orange\r3. Blue
ハイパーリンク [Title](url)

サポート外

  • ヘッダー
  • テーブル
  • イメージ
  • 上記の表にないものすべて

マークダウンの例

以下のペイロードは、このようにレンダリングされます。

markdown screenshot

{
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "type": "AdaptiveCard",
    "version": "1.0",
    "body": [
        {
            "type": "TextBlock",
            "text": "This is some **bold** text"
        },
        {
            "type": "TextBlock",
            "text": "This is some _italic_ text"
        },
        {
            "type": "TextBlock",
            "text": "- Bullet \r- List \r",
            "wrap": true
        },
        {
            "type": "TextBlock",
            "text": "1. Numbered\r2. List\r",
            "wrap": true
        },
        {
            "type": "TextBlock",
            "text": "Check out [Adaptive Cards](https://adaptivecards.io)"
        }
    ]
}

日付/時刻の書式設定とローカライズ

カードを受け取るユーザーのタイムゾーンがわからない場合がありますが、アダプティブ カードの書式設定関数 DATE() および TIME() を使用すれば、ターゲット デバイス上で時刻を自動的にローカライズできます。

日付/時刻の例

{
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "type": "AdaptiveCard",
    "version": "1.0",
    "body": [
        {
            "type": "TextBlock",
            "text": "Your package will arrive on {{DATE(2017-02-14T06:00:00Z, SHORT)}} at {{TIME(2017-02-14T06:00:00Z)}}",
            "wrap": true
        }
    ]
}

上記のカードは次のように表示されます。

お客様の荷物は Tue, Feb 14th, 2017 at 6:00 AM に到着します

日付/時刻の関数規則

すべてのプラットフォームで日付/時刻関数が正しく解釈されるためのルールがいくつかあります。 ルールが守られていない場合、生の文字列がユーザーに表示され、それは誰にとっても望ましくありません。

  1. 大文字と小文字の区別 (すべて大文字である必要があります)
  2. {{、}}、またはかっこの間にスペースを入れない
  3. 厳密な RFC 3389 書式 (次の例を参照)
  4. 有効な日付と時刻である必要がある

有効な形式

  • 2017-02-14T06:08:00Z
  • 2017-02-14T06:08:00-07:00
  • 2017-02-14T06:08:00+07:00

日付の書式設定パラメーター

日付の場合、オプションのパラメーターを指定して出力を書式設定できます。

Format 例
COMPACT (既定) "2/13/2017"
SHORT "Mon, Feb 13th, 2017"
LONG "Monday, February 13th, 2017"