TextBlock-Element

Hinweis

Erstellen Sie Copilot-, Teams- oder Outlook-Szenarien, die von adaptiven Karten unterstützt werden? Besuchen Sie den Dokumentationshub für adaptive Karten, den neuen One-Stop-Shop für alle Ihre Anforderungen an adaptive Karten! Es verfügt über alle Ressourcen, die Sie suchen, einschließlich der vollständigen Dokumentation für viele neue Features, z. B. dynamisches Layout, Symbol, Badge, Karussell, Diagramme und vieles mehr!

Diese Seite enthält Dokumentation für das TextBlock Element im Schema für adaptive Karten.

Wichtiger Hinweis zur Barrierefreiheit: In Version 1.3 des Schemas haben wir eine Bezeichnungseigenschaft für Eingaben eingeführt, um die Barrierefreiheit zu verbessern. Wenn die Host-App, auf die Sie abzielen , v1.3 unterstützt, sollten Sie die Bezeichnung anstelle eines TextBlock verwenden, wie in einigen Beispielen unten dargestellt. Sobald die meisten Host-Apps auf die neueste Version aktualisiert wurden, aktualisieren wir die Beispiele entsprechend.

TextBlock

Zeigt Text an, sodass die Kontrolle über Schriftgrade, Stärke und Farbe ermöglicht wird.

TextBlock-Eigenschaften

Eigentum Typ Erforderlich Description Version
type "TextBlock" Yes Muss "TextBlock" sein. 1,0
Text string Yes Anzuzeigender Text. Eine Teilmenge von Markdown wird unterstützt (https://aka.ms/ACTextFeatures) 1,0
color Colors? Nein Steuert die Farbe von TextBlock Elementen. 1,0
fontType FontType? Nein Schriftarttyp, der zum Rendern verwendet werden soll 1.2
horizontalAlignment HorizontalAlignment? Nein Steuert die horizontale Textausrichtung. Wenn nicht angegeben, wird der Wert von horizontalAlignment vom übergeordneten Container geerbt. Wenn kein übergeordneter Container "horizontalAlignment" festgelegt hat, wird er standardmäßig auf "Left" gesetzt. 1,0
isSubtle boolean? Nein Wenn true, wird der Text leicht abgemildert, um weniger hervorzustechen. 1,0
maxLines number Nein Gibt die maximale Anzahl anzuzeigender Zeilen an. 1,0
Größe FontSize? Nein Steuert die Textgröße. 1,0
weight FontWeight? Nein Steuert die Gewichtung von TextBlock Elementen. 1,0
umhüllen boolean Nein Wenn true, Zeilenumbruch des Textes zulassen. Andernfalls wird der Text abgeschnitten. 1,0
Stil TextBlockStyle? Nein, Standard: "default" Der Stil dieses TextBlock für Barrierefreiheitszwecken. 1.5

Geerbte Eigenschaften

Eigentum Typ Erforderlich Description Version
Ausweichlösung Element, FallbackOption Nein Beschreibt, was zu tun ist, wenn ein unbekanntes Element auftritt oder dies oder alle untergeordneten Elemente nicht erfüllt werden können. 1.2
height BlockElementHeight Nein Gibt die Höhe des Elements an. 1.1
separator boolean Nein Wenn true, zeichnen Sie eine trennende Linie am oberen Rand des Elements. 1,0
Abstand Spacing Nein Steuert den Abstand zwischen diesem Element und dem vorherigen Element. 1,0
id string Nein Ein eindeutiger Bezeichner, der dem Element zugeordnet ist. 1,0
isVisible boolean Nein, Standard: true Wenn false, wird dieses Element aus dem visuellen Baum entfernt. 1.2
erfordert Dictionary<string> Nein Eine Reihe von Schlüssel-Wert-Paaren, die Features angeben, die für das Element mit entsprechender Mindestversion erforderlich sind. Wenn ein Feature fehlt oder die Version nicht ausreichend ist, wird ein Rückfall ausgelöst. 1.2

Example

Einfaches TextBlock-Beispiel (JSON)

{
	"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
	"type": "AdaptiveCard",
	"version": "1.0",
	"body": [
		{
			"type": "TextBlock",
			"text": "This is some text",
			"size": "large"
		},
		{
			"type": "TextBlock",
			"text": "It doesn't wrap by default",
			"weight": "bolder"
		},
		{
			"type": "TextBlock",
			"text": "So set **wrap** to true if you plan on showing a paragraph of text",
			"wrap": true
		},
		{
			"type": "TextBlock",
			"text": "You can also use **maxLines** to prevent it from getting out of hand",
			"wrap": true,
			"maxLines": 2
		},
		{
			"type": "TextBlock",
			"text": "You can even draw attention to certain text with color",
			"wrap": true,
			"color": "attention"
		}
	]
}

Eigenschaften

Text

Anzuzeigender Text. Eine Teilmenge von Markdown wird unterstützt (https://aka.ms/ACTextFeatures)

  • Typ: string
  • Erforderlich: Ja

color

Steuert die Farbe von TextBlock Elementen.

  • Typ: Colors?
  • Erforderlich: Nein
  • Zulässige Werte:
    • "default"
    • "dark"
    • "light"
    • "accent"
    • "good"
    • "warning"
    • "attention"

Color-Beispiel (JSON)

{
	"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
	"type": "AdaptiveCard",
	"version": "1.0",
	"body": [
		{
			"type": "TextBlock",
			"text": "color: default",
			"color": "default"
		},
		{
			"type": "TextBlock",
			"text": "color: accent",
			"color": "accent"
		},
		{
			"type": "TextBlock",
			"text": "color: good",
			"color": "good"
		},
		{
			"type": "TextBlock",
			"text": "color: warning",
			"color": "warning"
		},
		{
			"type": "TextBlock",
			"text": "color: attention",
			"color": "attention"
		},
		{
			"type": "TextBlock",
			"text": "color: light",
			"color": "light"
		},
		{
			"type": "TextBlock",
			"text": "color: dark",
			"color": "dark"
		}
	]
}

Schriftarttyp

Schriftarttyp, der zum Rendern verwendet werden soll

  • Typ: FontType?
  • Version: 1.2
  • Erforderlich: Nein
  • Zulässige Werte:
    • "default"
    • "monospace"

FontType-Beispiel (JSON)

{
	"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
	"type": "AdaptiveCard",
	"version": "1.2",
	"body": [
		{
			"type": "TextBlock",
			"text": "Font type not set."
		},
		{
			"type": "TextBlock",
			"text": "Font type set to *default*.",
			"fontType": "default"
		},
		{
			"type": "TextBlock",
			"text": "Font type set to *monospace*.",
			"fontType": "monospace"
		}
	]
}

horizontalAlignment

Steuert die horizontale Textausrichtung. Wenn nicht angegeben, wird der Wert von horizontalAlignment vom übergeordneten Container geerbt. Wenn kein übergeordneter Container "horizontalAlignment" festgelegt ist, wird er standardmäßig auf "Left" festgelegt.

  • Typ: HorizontalAlignment?
  • Erforderlich: Nein
  • Zulässige Werte:
    • "left"
    • "center"
    • "right"

HorizontalAlignment-Beispiel (JSON)

{
	"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
	"type": "AdaptiveCard",
	"version": "1.0",
	"body": [
		{
			"type": "TextBlock",
			"text": "**horizontalAlignment:left**",
			"horizontalAlignment": "left"
		},
		{
			"type": "TextBlock",
			"text": "**horizontalAlignment:center**",
			"horizontalAlignment": "center"
		},
		{
			"type": "TextBlock",
			"text": "**horizontalAlignment:right**",
			"horizontalAlignment": "right"
		}
	]
}

isSubtle

Wenn true, wird der Text in leicht abgeschwächter Intensität angezeigt, um weniger auffällig zu sein.

  • Typ: boolean?
  • Erforderlich: Nein

isSubtle-Beispiel (JSON)

{
	"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
	"type": "AdaptiveCard",
	"version": "1.0",
	"body": [
		{
			"type": "TextBlock",
			"text": "isSubtle:false",
			"isSubtle": false
		},
		{
			"type": "TextBlock",
			"text": "isSubtle:true",
			"isSubtle": true
		}
	]
}

maxLines

Gibt die maximale Anzahl anzuzeigender Zeilen an.

  • Typ: number
  • Erforderlich: Nein

maxLines-Beispiel (JSON)

{
	"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
	"type": "AdaptiveCard",
	"version": "1.0",
	"body": [
		{
			"type": "TextBlock",
			"text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
			"wrap": true,
			"maxLines": 1
		},
		{
			"type": "TextBlock",
			"text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
			"wrap": true,
			"maxLines": 2
		}
	]
}

size

Steuert die Textgröße.

  • Typ: FontSize?
  • Erforderlich: Nein
  • Zulässige Werte:
    • "default"
    • "small"
    • "medium"
    • "large"
    • "extraLarge"

Size-Beispiel (JSON)

{
	"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
	"type": "AdaptiveCard",
	"version": "1.0",
	"body": [
		{
			"type": "TextBlock",
			"text": "size:default"
		},
		{
			"type": "TextBlock",
			"text": "size:small",
			"size": "small"
		},
		{
			"type": "TextBlock",
			"text": "size:default",
			"size": "default"
		},
		{
			"type": "TextBlock",
			"text": "size:medium",
			"size": "medium"
		},
		{
			"type": "TextBlock",
			"text": "size:large",
			"size": "large"
		},
		{
			"type": "TextBlock",
			"text": "size:extraLarge",
			"size": "extraLarge"
		}
	]
}

weight

Steuert die Gewichtung von TextBlock Elementen.

  • Typ: FontWeight?
  • Erforderlich: Nein
  • Zulässige Werte:
    • "default"
    • "lighter"
    • "bolder"

Weight-Beispiel (JSON)

{
	"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
	"type": "AdaptiveCard",
	"version": "1.0",
	"body": [
		{
			"type": "TextBlock",
			"text": "weight: lighter",
			"weight": "lighter"
		},
		{
			"type": "TextBlock",
			"text": "weight: default",
			"weight": "default"
		},
		{
			"type": "TextBlock",
			"text": "weight: bolder",
			"weight": "bolder"
		}
	]
}

umhüllen

Wenn true, Textumbruch zulassen. Andernfalls wird Text abgeschnitten.

  • Typ: boolean
  • Erforderlich: Nein

Wrap-Beispiel (JSON)

{
	"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
	"type": "AdaptiveCard",
	"version": "1.0",
	"body": [
		{
			"type": "TextBlock",
			"text": "**wrap: false** Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat",
			"wrap": false
		},
		{
			"type": "TextBlock",
			"text": "**wrap: true** Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
			"wrap": true
		}
	]
}

style

Der Stil dieses TextBlock-Steuerelements für Barrierefreiheitszwecke.

  • Typ: TextBlockStyle?
  • Version: 1.5
  • Erforderlich: Nein, Standard: "default"
  • Zulässige Werte:
    • "default": Dies ist der Standardstil, der weder spezielle Formatierung noch spezielles Verhalten bietet.
    • "heading": Dies TextBlock ist eine Überschrift. Dadurch werden die Standardwerte für die Formatierung der Überschriften angewendet, und TextBlock wird als Überschrift für die Barrierefreiheit markiert.

Style-Beispiel (JSON)

{
	"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
	"type": "AdaptiveCard",
	"version": "1.5",
	"body": [
		{
			"type": "TextBlock",
			"text": "Style set to heading",
			"style": "heading",
			"wrap": true
		},
		{
			"type": "TextBlock",
			"text": "Style set to heading, color set to good",
			"style": "heading",
			"color": "good",
			"wrap": true
		},
		{
			"type": "TextBlock",
			"text": "Style set to default",
			"style": "default",
			"wrap": true
		},
		{
			"type": "TextBlock",
			"text": "Style unset",
			"wrap": true
		}
	]
}

Plan B

Beschreibt, was zu tun ist, wenn ein unbekanntes Element auftritt oder die Anforderungen dieses oder eines der untergeordneten Elemente nicht erfüllt werden können.

  • Typ: Element, FallbackOption
  • Version: 1.2
  • Erforderlich: Nein
  • Zulässige Werte:
    • ActionSet, ColumnSet, Container, FactSet, Image, ImageSet, Input.ChoiceSet, Input.Date, Input.Number, Input.Text, Input.Time, Input.Toggle, Media, RichTextBlock, Table, TextBlock
    • "drop": Bewirkt, dass dieses Element sofort gelöscht wird, wenn unbekannte Elemente gefunden werden. Das unbekannte Element taucht nicht weiter oben auf.

height

Gibt die Höhe des Elements an.

  • Typ: BlockElementHeight
  • Version: 1.1
  • Erforderlich: Nein
  • Zulässige Werte:
    • "auto": Die Höhe des Containers wird durch die Höhe des Inhalts bestimmt.
    • "stretch": Der Container dehnt seine Höhe auf die verbleibende verfügbare Höhe des übergeordneten Containers.

Trennzeichen

Wenn true, zeichnen Sie eine trennende Linie am oberen Rand des Elements.

  • Typ: boolean
  • Erforderlich: Nein

Abstand

Steuert den Abstand zwischen diesem Element und dem vorherigen Element.

  • Typ: Spacing
  • Erforderlich: Nein
  • Zulässige Werte:
    • "default", , "none""small", "medium", "large", , "extraLarge""padding"

id

Ein eindeutiger Bezeichner, der dem Element zugeordnet ist.

  • Typ: string
  • Erforderlich: Nein

isVisible

Wenn false, wird dieses Element aus dem visuellen Baum entfernt.

  • Typ: boolean
  • Version: 1.2
  • Erforderlich: Nein, Standard: true

erfordert

Eine Reihe von Schlüssel-Wert-Paaren, die Features angeben, die für das Element mit entsprechender Mindestversion erforderlich sind. Wenn ein Feature fehlt oder die Version nicht ausreichend ist, wird ein Rückfall ausgelöst.

  • Typ: Dictionary<string>
  • Version: 1.2
  • Erforderlich: Nein
  • Last updated on