Recursos de texto

Artigo
08/28/2023

TextBlock oferece alguns recursos avançados para formatação e localização do texto.

Markdown (subconjunto Commonmark)

Para dar suporte à marcação embutida, os Cartões Adaptáveis dão suporte a um subconjunto da sintaxe Markdown Commonmark.

Observação

O RichTextBlock não dá suporte à Markdown, mas oferece uma ampla gama de opções de configuração de texto diretamente dentro do TextRun

Com suporte

Estilo de texto	Markdown
Negrito	`Bold`
Itálico	`_Italic_`
Lista com marcadores	`- Item 1\r- Item 2\r- Item 3`
Lista numerada	`1. Green\r2. Orange\r3. Blue`
Hiperlinks	`[Title](url)`

Sem suporte

Cabeçalhos
Tabelas
Imagens
Tudo o que não esteja na tabela acima

Exemplo de markdown

O conteúdo abaixo renderizará algo parecido com isto:

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)"
        }
    ]
}

Formatação de data/hora e localização

Às vezes, você não saberá o fuso horário do usuário que está recebendo o cartão; portanto, os Cartões Adaptáveis oferecem as funções de formatação DATE() e TIME() para localizar automaticamente a hora no dispositivo de destino.

Exemplo de data/hora

{
    "$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
        }
    ]
}

O cartão acima exibirá:

Seu pacote chegará na terça-feira, 14 de fevereiro de 2017, às 6:00

Regras para funções de data/hora

Há algumas regras para interpretar corretamente as funções de data/hora em cada plataforma. Se as regras não forem cumpridas, a cadeia de caracteres bruta será exibida ao usuário, e ninguém gostará disso.

DIFERENCIAM MAIÚSCULAS DE MINÚSCULAS (precisam estar todas em maiúsculas)
SEM ESPAÇOS entre {{, }} ou parênteses
FORMATAÇÃO RFC 3389 ESTRITA (veja os exemplos abaixo)
PRECISAM SER uma data e uma hora válidas

Formatos válidos

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

Parâmetro de formatação de data

Para datas, um parâmetro opcional pode ser especificado para formatar a saída.

Formato	Exemplo
`COMPACT` (Padrão)	"13/2/2017"
`SHORT`	"Segunda, 13 de fev de 2017"
`LONG`	"Segunda-feira, 13 de fevereiro de 2017"

Compartilhar via