TextBlock-element

Den här sidan innehåller dokumentation för elementet TextBlock i schemat adaptiva kort.

Viktig information om tillgänglighet: I version 1.3 av schemat introducerade vi en etikettegenskap på inmatningar för att förbättra tillgängligheten. Om värdappen som du riktar in dig på stöder v1.3 bör du använda etiketten i stället för en TextBlock som visas i vissa exempel nedan. När de flesta värdappar har uppdaterats till den senaste versionen uppdaterar vi exemplen i enlighet med detta.

TextBlock

Visar text, vilket ger kontroll över teckenstorlekar, vikt och färg.

Egenskaper för TextBlock

Ärvda egenskaper

Example

Exempel på grundläggande textblockering (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"
		}
	]
}

Egenskaper

texten

Text som ska visas. En delmängd av markdown stöds (https://aka.ms/ACTextFeatures)

• Typ: string
• Obligatoriskt: Ja

color

Styr färgen TextBlock på elementen.

• Typ: Colors?
• Obligatoriskt: Nej
• Tillåtna värden:
  • "default"
  • "dark"
  • "light"
  • "accent"
  • "good"
  • "warning"
  • "attention"

Färgexempel (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"
		}
	]
}

fontType

Typ av teckensnitt som ska användas för återgivning

• Typ: FontType?
• Version: 1.2
• Obligatoriskt: Nej
• Tillåtna värden:
  • "default"
  • "monospace"

Exempel på FontType (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"
		}
	]
}

horisontell justering

Styr den vågräta textjusteringen. När värdet för horizontalAlignment inte anges ärvs det från den överordnade containern. Om ingen överordnad container har horizontalAlignment inställd, är standardvärdet Vänster.

• Typ: HorizontalAlignment?
• Obligatoriskt: Nej
• Tillåtna värden:
  • "left"
  • "center"
  • "right"

HorizontalAlignment Example (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

Om true visas, visas texten något nedtonad för att framstå som mindre framträdande.

• Typ: boolean?
• Obligatoriskt: Nej

Exempel på isSubtle (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

Anger det maximala antalet rader som ska visas.

• Typ: number
• Obligatoriskt: Nej

maxLines-exempel (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

Kontrollerar textstorleken.

• Typ: FontSize?
• Obligatoriskt: Nej
• Tillåtna värden:
  • "default"
  • "small"
  • "medium"
  • "large"
  • "extraLarge"

Storleksexempel (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

Styr vikten av TextBlock element.

• Typ: FontWeight?
• Obligatoriskt: Nej
• Tillåtna värden:
  • "default"
  • "lighter"
  • "bolder"

Viktexempel (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"
		}
	]
}

omslag

Om truetillåter du att text radbryts. Annars klipps texten ur.

• Typ: boolean
• Obligatoriskt: Nej

Exempel på inkapsling (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

Stilen för detta TextBlock för åtkomlighetsändamål.

• Typ: TextBlockStyle?
• Version: 1.5
• Obligatoriskt: Nej, standard: "default"
• Tillåtna värden:
  • "default": Det här är standardformatet som inte ger någon speciell stil eller något särskilt beteende.
  • "heading": TextBlock är en rubrik. Detta tillämpar standardinställningarna för rubrikformatering och markerar TextBlock som en rubrik för åtkomstiblitet.

Formatmallsexempel (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
		}
	]
}

Reservlösning

Beskriver vad du ska göra när ett okänt element påträffas eller om det här eller eventuella underordnade element inte kan uppfyllas.

• Typ: Element, FallbackOption
• Version: 1.2
• Obligatoriskt: Nej
• Tillåtna värden:
  • ActionSet, ColumnSet, Container, FactSet, Image, ImageSet, Input.ChoiceSet, Input.Date, Input.Number, , Input.Text, Input.Time, Input.Toggle, Media, RichTextBlock, , TableTextBlock
  • "drop": Gör att det här elementet tas bort omedelbart när okända element påträffas. Det okända elementet bubblar inte upp högre.

höjd

Anger elementets höjd.

• Typ: BlockElementHeight
• Version: 1.1
• Obligatoriskt: Nej
• Tillåtna värden:
  • "auto": Containerns höjd bestäms av innehållets höjd.
  • "stretch": Containern sträcker ut sin höjd till den tillgängliga återstående höjden för den överordnade containern.

separator

När trueritar du en avgränsande linje överst i elementet.

• Typ: boolean
• Obligatoriskt: Nej

avstånd

Styr mängden avstånd mellan det här elementet och föregående element.

• Typ: Spacing
• Obligatoriskt: Nej
• Tillåtna värden:
  • "default", "none", "small", "medium", "large", "extraLarge""padding"

Id-nummer

En unik identifierare som är associerad med objektet.

• Typ: string
• Obligatoriskt: Nej

isVisible

Om falsetas det här objektet bort från det visuella trädet.

• Typ: boolean
• Version: 1.2
• Obligatoriskt: Nej, standard: true

Kräver

En serie nyckel/värde-par som anger funktioner som objektet kräver med motsvarande lägsta version. När en funktion saknas eller inte har tillräcklig version utlöses återställningen.

• Typ: Dictionary<string>
• Version: 1.2
• Obligatoriskt: Nej