Acción.ToggleVisibilidad

En esta página se documenta el elemento Action.ToggleVisibility , que es una acción que alterna la visibilidad de los elementos de tarjeta asociados.

Introducido en la versión 1.2

Nota importante sobre la accesibilidad: En la versión 1.3 del esquema se introdujo una propiedad label en Entradas para mejorar la accesibilidad. Si la aplicación anfitriona a la que está orientando admite la versión 1.3, debe usar etiqueta en lugar de TextBlock, como se muestra en algunos ejemplos a continuación. Una vez que la mayoría de las aplicaciones host se hayan actualizado a la versión más reciente, actualizaremos los ejemplos según corresponda.

Action.ToggleVisibility

Acción que alterna la visibilidad de los elementos de tarjeta asociados.

Propiedades Action.ToggleVisibility

Propiedades heredadas

Example

Ejemplo de 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
				}
			]
		}
	]
}

Propiedades

targetElements

Matriz de TargetElements. No se recomienda incluir elementos input con validación en Action.Toggle debido a confusión que puede surgir de entradas no válidas que no están visibles actualmente. Consulte /adaptive-cards/authoring-cards/input-validation para obtener más información.

• Tipo: TargetElement[]
• Obligatorio: Sí
• Valores permitidos:
  • TargetElement
  • string

title

Etiqueta para el botón o vínculo que representa esta acción.

• Tipo: string
• Obligatorio: No

iconUrl

Icono opcional que se va a mostrar en la acción junto con el título. Admite el URI de datos en la versión 1.2 o posterior.

• Tipo: uri
• Versión: 1.1
• Obligatorio: No

id

Identificador único asociado a esta acción.

• Tipo: string
• Obligatorio: No

style

Controla el estilo de una acción, que influye en cómo se muestra, habla, etc..

• Tipo: ActionStyle
• Versión: 1.2
• Obligatorio: No
• Valores permitidos:
  • "default": la acción se muestra de manera normal.
  • "positive": la acción se muestra con un estilo positivo (normalmente el botón se convierte en color de énfasis).
  • "destructive": la acción se muestra con un estilo destructivo (normalmente el botón se vuelve rojo).

Reserva

Describa qué hacer cuando se encuentra un elemento desconocido o no se puedan satisfacer los requisitos de este o de cualquier elemento secundario.

• Tipo: Action, FallbackOption
• Versión: 1.2
• Obligatorio: No
• Valores permitidos:
  • Action.Execute, Action.OpenUrl, Action.ShowCard, Action.Submit, Action.ToggleVisibility.
  • "drop": hace que este elemento se quite inmediatamente cuando se encuentren elementos desconocidos. El elemento desconocido no se propaga más arriba.

información sobre herramientas

Define el texto que se debe mostrar al usuario final a medida que mantiene el mouse sobre la acción y lee al usar el software de narración.

• Tipo: string
• Versión: 1.5
• Obligatorio: No

isEnabled

Determina si se debe habilitar la acción.

• Tipo: boolean
• Versión: 1.5
• Obligatorio: No, valor predeterminado: true

mode

Determina si la acción debe mostrarse como un botón o en el menú de desbordamiento.

• Tipo: ActionMode
• Versión: 1.5
• Obligatorio: No, valor predeterminado: "primary"
• Valores permitidos:
  • "primary": la acción se muestra como un botón.
  • "secondary": la acción se coloca en un menú de desbordamiento (normalmente un menú emergente bajo un ... botón).

Requiere

Serie de pares clave-valor que indican las características que el elemento requiere con la versión mínima correspondiente. Cuando una característica está ausente o una versión es inadecuada, se activa el mecanismo de respaldo.

• Tipo: Dictionary<string>
• Versión: 1.2
• Obligatorio: No