Textmerkmale

Artikel
28.08.2023

TextBlock bietet erweiterte Funktionen zum Formatieren und Lokalisieren von Text.

Markdown (Commonmark-Teilmenge)

Zur Ermöglichung von Inline-Markup unterstützen adaptive Karten eine Teilmenge der Commonmark-Markdownsyntax.

Hinweis

Richtextblock unterstützt Markdown nicht, bietet aber eine große Bandbreite an Konfigurationsoptionen für Text direkt innerhalb von TextRun

Unterstützt

Textstil	Markdown
Fett	`Bold`
Kursiv	`_Italic_`
Aufzählung	`- Item 1\r- Item 2\r- Item 3`
Nummerierte Liste	`1. Green\r2. Orange\r3. Blue`
Hyperlinks	`[Title](url)`

Nicht unterstützt

Header
Tabellen
Abbilder
Alle in der obigen Tabelle nicht genannten Elemente

Markdown-Beispiel

Die folgende Nutzlast rendert etwa Folgendes:

markdown screenshot

JSON

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

Datums-/Uhrzeitformat und Lokalisierung

Es kann vorkommen, dass du die Zeitzone des Benutzers, der die Karte empfängt, nicht kennst. Daher bieten adaptive Karten Formatierungsfunktionen für DATE() und TIME(), damit die Zeit auf dem Zielgerät automatisch lokalisiert werden kann.

Beispiel für Datum/Uhrzeit

JSON

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

Obige Karte zeigt Folgendes an:

Your package will arrive on Tue, Feb 14th, 2017 at 6:00 AM

Funktionsregeln für Datum/Uhrzeit

Es gibt einige Regeln für das korrekte Interpretieren der Datums-/Uhrzeitfunktionen auf jeder Plattform. Wenn die Regeln nicht eingehalten werden, wird dem Benutzer die unformatierte Zeichenfolge anzeigt, was unerwünscht ist.

GROß-/KLEINSCHREIBUNG (darf nur Großbuchstaben enthalten)
KEINE LEERZEICHEN zwischen {{, }} oder runden Klammern
STRIKTE RFC 3389-FORMATIERUNG (siehe Beispiele unten)
MUSS gültige Werte für Datum und Uhrzeit aufweisen

Gültige Formate

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

Dateiformatparameter

Für Daten kann ein optionaler Parameter zum Formatieren der Ausgabe angegeben werden.

Format	Beispiel
`COMPACT` (Standard)	„2/13/2017“
`SHORT`	„Mon, Feb 13th, 2017“
`LONG`	„Monday, February 13th, 2017“

Freigeben über