Action.ToggleVisibility

Questa pagina documenta l'elemento Action.ToggleVisibility , ovvero un'azione che attiva o disattiva la visibilità degli elementi della scheda associati.

Introdotto nella versione 1.2

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 destinazione supporta la versione 1.3, si dovrebbe usare label 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.

Action.ToggleVisibility

Azione che attiva o disattiva la visibilità degli elementi della scheda associati.

Proprietà Action.ToggleVisibility

Proprietà ereditate

Example

Esempio di Action.ToggleVisibility (JSON)

{
	"type": "AdaptiveCard",
	"version": "1.2",
	"body": [
		{
			"type": "TextBlock",
			"text": "Press the buttons to toggle the images!",
			"wrap": true
		},
		{
			"type": "TextBlock",
			"text": "Here are some images:",
			"isVisible": false,
			"id": "textToToggle"
		},
		{
			"type": "ColumnSet",
			"columns": [
				{
					"type": "Column",
					"items": [
						{
							"style": "person",
							"type": "Image",
							"url": "https://picsum.photos/100/100?image=112",
							"isVisible": false,
							"id": "imageToToggle",
							"altText": "sample image 1",
							"size": "medium"
						}
					]
				},
				{
					"type": "Column",
					"items": [

						{
							"type": "Image",
							"url": "https://picsum.photos/100/100?image=123",
							"isVisible": false,
							"id": "imageToToggle2",
							"altText": "sample image 2",
							"size": "medium"
						}
					]
				}
			]
		}
	],
	"actions": [
		{
			"type": "Action.ToggleVisibility",
			"title": "Toggle!",
			"targetElements": [ "textToToggle", "imageToToggle", "imageToToggle2" ]
		},
		{
			"type": "Action.ToggleVisibility",
			"title": "Show!",
			"targetElements": [
				{
					"elementId": "textToToggle",
					"isVisible": true
				},
				{
					"elementId": "imageToToggle",
					"isVisible": true
				},
				{
					"elementId": "imageToToggle2",
					"isVisible": true
				}
			]
		},
		{
			"type": "Action.ToggleVisibility",
			"title": "Hide!",
			"targetElements": [
				{
					"elementId": "textToToggle",
					"isVisible": false
				},
				{
					"elementId": "imageToToggle",
					"isVisible": false
				},
				{
					"elementId": "imageToToggle2",
					"isVisible": false
				}
			]
		}
	]
}

Proprietà

elementiDiDestinazione

Matrice di TargetElements. Si sconsiglia di includere elementi di input con validazione in Action.Toggle poiché può causare confusione con input non validi che non sono attualmente visibili. Vedi /adaptive-cards/authoring-cards/input-validation per ulteriori informazioni.

• Tipo: TargetElement[]
• Obbligatorio: Sì
• Valori consentiti:
  • TargetElement
  • string

title

Etichetta per il pulsante o il collegamento che rappresenta questa azione.

• Tipo: string
• Obbligatorio: No

iconUrl

Icona facoltativa da visualizzare nell'azione insieme al titolo. Supporta l'URI dei dati nella versione 1.2+.

• Tipo: uri
• Versione: 1.1
• Obbligatorio: No

id

Identificatore univoco associato a questa azione.

• Tipo: string
• Obbligatorio: No

style

Controlla lo stile di un'azione, che influenza il modo in cui l'azione viene visualizzata, pronunciata e così via.

• Tipo: ActionStyle
• Versione: 1.2
• Obbligatorio: No
• Valori consentiti:
  • "default": l'azione viene visualizzata come normale.
  • "positive": l'azione viene visualizzata con uno stile positivo (in genere il pulsante diventa colore principale).
  • "destructive": l'azione viene visualizzata con uno stile distruttivo (in genere il pulsante diventa rosso).

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: Action, FallbackOption
• Versione: 1.2
• Obbligatorio: No
• Valori consentiti:
  • Action.Execute, Action.OpenUrl, Action.ShowCard, Action.Submit, . Action.ToggleVisibility
  • "drop": fa sì che questo elemento venga eliminato immediatamente quando vengono rilevati elementi sconosciuti. L'elemento sconosciuto non si propaga verso l'alto.

Descrizione comando

Definisce il testo che deve essere visualizzato all'utente finale quando passa il puntatore del mouse sull'azione e legge quando si usa il software di narrazione.

• Tipo: string
• Versione: 1.5
• Obbligatorio: No

èAbilitato

Determina se l'azione deve essere abilitata.

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

mode

Determina se l'azione deve essere visualizzata come pulsante o nel menu di overflow.

• Tipo: ActionMode
• Versione: 1.5
• Obbligatorio: No, impostazione predefinita: "primary"
• Valori consentiti:
  • "primary": l'azione viene visualizzata come pulsante.
  • "secondary": L'azione viene inserita in un menu di overflow (in genere un menu popup sotto un pulsante ...).

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