Elemento TextBlock

Annotazioni

Si stanno creando scenari Copilot, Teams o Outlook basati su schede adattive? Visita l'Hub della documentazione delle Adaptive Card, il nuovo sportello unico per tutte le tue esigenze di Adaptive Card! Include tutte le risorse che si stanno cercando, inclusa la documentazione completa per molte nuove funzionalità, ad esempio layout reattivo, icona, badge, sequenza, grafici e molto altro ancora.

Questa pagina fornisce la documentazione per l'elemento TextBlock nello schema schede adattive.

Nota importante sull'accessibilità: Nella versione 1.3 dello schema è stata introdotta una proprietà label negli input per migliorare l'accessibilità. Se l'app host di riferimento supporta la versione 1.3, è consigliabile usare l'etichetta anziché un TextBlock come illustrato in alcuni esempi seguenti. Dopo che la maggior parte delle app host è stata aggiornata alla versione più recente, gli esempi verranno aggiornati di conseguenza.

Blocco di testo

Visualizza il testo, consentendo il controllo sulle dimensioni, lo spessore e il colore del carattere.

Proprietà TextBlock

Proprietà TIPO Obbligatorio Description Versione
type "TextBlock" Yes Deve essere "TextBlock". 1.0
testo string Yes Testo da visualizzare. È supportato un subset di markdown (https://aka.ms/ACTextFeatures) 1.0
color Colors? NO Controlla il colore degli TextBlock elementi. 1.0
fontType FontType? NO Tipo di carattere da usare per il rendering 1.2
horizontalAlignment HorizontalAlignment? NO Controlla l'allineamento orizzontale del testo. Se non specificato, il valore di horizontalAlignment viene ereditato dal contenitore padre. Se nessun contenitore padre ha horizontalAlignment impostato, l'impostazione predefinita è Left. 1.0
isSubtle boolean? NO Se true, visualizza il testo leggermente tonato verso il basso per apparire meno prominente. 1.0
maxLines number NO Specifica il numero massimo di righe da visualizzare. 1.0
dimensione FontSize? NO Controlla le dimensioni del testo. 1.0
peso FontWeight? NO Controlla il peso degli TextBlock elementi. 1.0
incapsulare boolean NO Se true, permettere il ritorno a capo del testo. In caso contrario, il testo viene tagliato. 1.0
stile TextBlockStyle? No, impostazione predefinita: "default" Stile di questo TextBlock per scopi di accessibilità. 1,5

Proprietà ereditate

Proprietà TIPO Obbligatorio Description Versione
Fallback Element, FallbackOption NO Descrive le operazioni da eseguire quando viene rilevato un elemento sconosciuto o quando non è possibile soddisfare le esigenze di questo o qualsiasi elemento figlio. 1.2
altezza BlockElementHeight NO Specifica l'altezza dell'elemento. 1.1
separator boolean NO Quando true, disegnare una linea di separazione nella parte superiore dell'elemento. 1.0
spaziatura Spacing NO Controlla la quantità di spaziatura tra questo elemento e l'elemento precedente. 1.0
ID string NO Identificatore univoco associato all'elemento. 1.0
isVisible boolean No, impostazione predefinita: true Se false, questo elemento verrà rimosso dalla struttura ad albero visuale. 1.2
Richiede Dictionary<string> NO Serie di coppie chiave/valore che indicano le funzionalità richieste dall'elemento con la versione minima corrispondente. Quando una funzionalità è mancante o di versione insufficiente, viene attivato il fallback. 1.2

Example

Esempio di TextBlock di base (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"
		}
	]
}

Proprietà

text

Testo da visualizzare. È supportato un subset di markdown (https://aka.ms/ACTextFeatures)

  • Tipo: string
  • Obbligatorio: Sì

color

Controlla il colore degli TextBlock elementi.

  • Tipo: Colors?
  • Obbligatorio: No
  • Valori consentiti:
    • "default"
    • "dark"
    • "light"
    • "accent"
    • "good"
    • "warning"
    • "attention"

Esempio di colore (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"
		}
	]
}

tipo di carattere

Tipo di carattere da usare per il rendering

  • Tipo: FontType?
  • Versione: 1.2
  • Obbligatorio: No
  • Valori consentiti:
    • "default"
    • "monospace"

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

allineamento orizzontale

Controlla l'allineamento orizzontale del testo. Se non specificato, il valore di horizontalAlignment viene ereditato dal contenitore padre. Se nessun contenitore padre ha horizontalAlignment impostato, l'impostazione predefinita è Left.

  • Tipo: HorizontalAlignment?
  • Obbligatorio: No
  • Valori consentiti:
    • "left"
    • "center"
    • "right"

esempio horizontalAlignment (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

Se true, visualizza il testo leggermente tonato verso il basso per apparire meno prominente.

  • Tipo: boolean?
  • Obbligatorio: No

Esempio 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

Specifica il numero massimo di righe da visualizzare.

  • Tipo: number
  • Obbligatorio: No

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

Controlla le dimensioni del testo.

  • Tipo: FontSize?
  • Obbligatorio: No
  • Valori consentiti:
    • "default"
    • "small"
    • "medium"
    • "large"
    • "extraLarge"

Esempio di Misura (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

Controlla il peso degli TextBlock elementi.

  • Tipo: FontWeight?
  • Obbligatorio: No
  • Valori consentiti:
    • "default"
    • "lighter"
    • "bolder"

Esempio di peso (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"
		}
	]
}

incapsulare

Se true, consentire il ritorno a capo del testo. Altrimenti, il testo viene troncato.

  • Tipo: boolean
  • Obbligatorio: No

Esempio di Incapsulamento (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

Stile di questo TextBlock per motivi di accessibilità.

  • Tipo: TextBlockStyle?
  • Versione: 1.5
  • Obbligatorio: No, impostazione predefinita: "default"
  • Valori consentiti:
    • "default": questo è lo stile predefinito che non fornisce stili o comportamenti speciali.
    • "heading": Il TextBlock è un'intestazione. Verranno applicate le impostazioni predefinite dello stile dell'intestazione e TextBlock verrà contrassegnato come intestazione per l'accessibilità.

Esempio di stile (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
		}
	]
}

Procedura di ripiego

Descrive le operazioni da eseguire quando viene rilevato un elemento sconosciuto o quando non è possibile soddisfare le esigenze di questo elemento o di eventuali elementi figli.

  • Tipo: Element, FallbackOption
  • Versione: 1.2
  • Obbligatorio: No
  • Valori consentiti:
    • ActionSet ColumnSet Container FactSet Image ImageSet Input.ChoiceSet Input.Date Input.Number Input.Text Input.Time Input.Toggle Media RichTextBlock Table TextBlock
    • "drop": fa sì che questo elemento venga eliminato immediatamente quando vengono rilevati elementi sconosciuti. L'elemento sconosciuto non si propaga verso l'alto.

altezza

Specifica l'altezza dell'elemento.

  • Tipo: BlockElementHeight
  • Versione: 1.1
  • Obbligatorio: No
  • Valori consentiti:
    • "auto": l'altezza del contenitore verrà determinata dall'altezza del relativo contenuto.
    • "stretch": il contenitore estenderà l'altezza fino all'altezza rimanente disponibile del contenitore padre.

separatore

Quando true, disegnare una linea di separazione nella parte superiore dell'elemento.

  • Tipo: boolean
  • Obbligatorio: No

spaziatura

Controlla la quantità di spaziatura tra questo elemento e l'elemento precedente.

  • Tipo: Spacing
  • Obbligatorio: No
  • Valori consentiti:
    • "default", "none", "small", "medium""large", , "extraLarge""padding"

id

Identificatore univoco associato all'elemento.

  • Tipo: string
  • Obbligatorio: No

isVisible

Se false, questo elemento verrà rimosso dalla struttura ad albero visuale.

  • Tipo: boolean
  • Versione: 1.2
  • Obbligatorio: No, impostazione predefinita: true

Richiede

Serie di coppie chiave/valore che indicano le funzionalità richieste dall'elemento con la versione minima corrispondente. Quando una funzionalità è mancante o di versione insufficiente, viene attivato il fallback.

  • Tipo: Dictionary<string>
  • Versione: 1.2
  • Obbligatorio: No
  • Last updated on