文字功能
TextBlock 提供了可將文字格式化和當地語系化的進階功能。
Markdown (Commonmark 子集)
為了支援內嵌標記,調適型卡片支援 Commonmark Markdown 語法的子集。
注意
RichTextBlock 不支援 Markdown,而是直接在 TextRun 內提供各式各樣的文字設定選項
支援
文字樣式 | Markdown |
---|---|
粗體 | **Bold** |
斜體 | _Italic_ |
項目符號清單 | - Item 1\r- Item 2\r- Item 3 |
編號清單 | 1. Green\r2. Orange\r3. Blue |
超連結 | [Title](url) |
不支援
- 標頭
- 資料表
- 映像
- 不在上表中的任何項目
Markdown 範例
下列承載會進行如下的轉譯:
{
"$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
}
]
}
上述卡片將會顯示:
您的套件將在 2017 年 2 月 14 日星期二早上 6:00 送達
日期/時間函式規則
要在每個平台上適當解譯日期/時間函式,必須遵循一些規則。 如果不符合規則,則會將原始字串顯示給使用者,但沒有人想要這種結果。
- 區分大小寫 (必須全部使用大寫)
{{
、}}
或括弧之間不含空格- 嚴格 RFC 3389 格式化 (請參閱以下範例)
- 必須是有效的日期和時間
有效格式
2017-02-14T06:08:00Z
2017-02-14T06:08:00-07:00
2017-02-14T06:08:00+07:00
日期格式化參數
針對日期可以指定選用參數,以格式化輸出。
[格式] | 範例 |
---|---|
COMPACT (預設值) |
"2/13/2017" |
SHORT |
"Mon, Feb 13th, 2017" |
LONG |
"Monday, February 13th, 2017" |