Action.BasculeVisibilité

Cette page documente l’élément Action.ToggleVisibility , qui est une action qui bascule la visibilité des éléments de carte associés.

Introduit dans la version 1.2

Remarque importante sur l’accessibilité : Dans la version 1.3 du schéma, nous avons introduit une propriété d’étiquette sur les entrées pour améliorer l’accessibilité. Si l’application hôte que vous ciblez prend en charge la version 1.3, vous devez utiliser l’étiquette au lieu d’un TextBlock comme indiqué dans certains exemples ci-dessous. Une fois que la plupart des applications hôtes ont été mises à jour vers la dernière version, nous allons mettre à jour les exemples en conséquence.

Action.BasculeVisibilité

Action qui bascule la visibilité des éléments de carte associés.

Les propriétés Action.ToggleVisibility

Propriétés héritées

Example

Exemple d'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
				}
			]
		}
	]
}

Propriétés

targetElements

Tableau des éléments cibles. Il n’est pas recommandé d’inclure des éléments d’entrée avec validation sous Action.Toggle en raison d’une confusion pouvant provenir d’entrées non valides qui ne sont pas visibles actuellement. Pour plus d’informations, consultez /adaptive-cards/authoring-cards/input-validation .

• Type : TargetElement[]
• Obligatoire : Oui
• Valeurs autorisées :
  • TargetElement
  • string

title

Étiquette du bouton ou du lien qui représente cette action.

• Type : string
• Obligatoire : Non

URL d'icône

Icône facultative à afficher sur l’action conjointement avec le titre. Prend en charge l’URI de données dans la version 1.2+.

• Type : uri
• Version : 1.1
• Obligatoire : Non

pièce d'identité

Identificateur unique associé à cette action.

• Type : string
• Obligatoire : Non

style

Contrôle le style d’une action, qui influence la façon dont l’action est affichée, parlée, etc..

• Type : ActionStyle
• Version : 1.2
• Obligatoire : Non
• Valeurs autorisées :
  • "default": L'action est affichée normalement.
  • "positive": l’action s’affiche avec un style positif (généralement, le bouton devient couleur d’accentuation).
  • "destructive": l’action s’affiche avec un style destructeur (généralement le bouton devient rouge).

Secours

Décrit ce qu’il faut faire lorsqu’un élément inconnu est rencontré ou si les besoins de ce ou de tous les enfants ne peuvent pas être rencontrés.

• Type : Action, FallbackOption
• Version : 1.2
• Obligatoire : Non
• Valeurs autorisées :
  • Action.Execute, , Action.OpenUrl, Action.ShowCardAction.Submit, , Action.ToggleVisibility.
  • "drop": provoque la suppression immédiate de cet élément lorsque des éléments inconnus sont rencontrés. L'élément inconnu ne se propage pas plus haut.

tooltip

Définit le texte qui doit être affiché à l’utilisateur final lorsqu’il pointe la souris sur l’action et lit lors de l’utilisation du logiciel de narration.

• Type : string
• Version : 1.5
• Obligatoire : Non

isEnabled

Détermine si l’action doit être activée.

• Type : boolean
• Version : 1.5
• Obligatoire : Non, valeur par défaut : true

mode

Détermine si l’action doit être affichée sous la forme d’un bouton ou dans le menu de dépassement de capacité.

• Type : ActionMode
• Version : 1.5
• Obligatoire : Non, valeur par défaut : "primary"
• Valeurs autorisées :
  • "primary": l’action s’affiche sous la forme d’un bouton.
  • "secondary": l’action est placée dans un menu déroulant (généralement un menu contextuel sous un ... bouton).

Exige

Série de paires clé/valeur indiquant les fonctionnalités requises par l’élément avec la version minimale correspondante. Lorsque qu’une fonctionnalité est manquante ou n'est pas à la version requise, un mécanisme de secours est déclenché.

• Type : Dictionary<string>
• Version : 1.2
• Obligatoire : Non