テキスト機能

[アーティクル]
08/28/2023

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 に到着します

日付/時刻の関数規則

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

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

有効な形式

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"

次の方法で共有