Actie.SchakelZichtbaarheidOm

Deze pagina documenteert het element Action.ToggleVisibility . Dit is een actie waarmee de zichtbaarheid van gekoppelde kaartelementen wordt in-/uitschakelen.

Geïntroduceerd in versie 1.2

Belangrijke opmerking over toegankelijkheid: In versie 1.3 van het schema hebben we een labeleigenschap geïntroduceerd op Invoer om de toegankelijkheid te verbeteren. Als de Host-app die u als doel hebt , v1.3 ondersteunt, moet u een label gebruiken in plaats van een TextBlock , zoals in enkele voorbeelden hieronder wordt weergegeven. Zodra de meeste Host-apps zijn bijgewerkt naar de nieuwste versie, werken we de voorbeelden dienovereenkomstig bij.

Actie.SchakelZichtbaarheidOm

Een actie waarmee je de zichtbaarheid van gekoppelde kaartelementen in- of uitschakelt.

Eigenschappen van Action.ToggleVisibility

Overgenomen eigenschappen

Example

Action.ToggleVisibility Voorbeeld (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
				}
			]
		}
	]
}

Eigenschappen

doelelementen

De matrix van TargetElements. Het wordt afgeraden invoerelementen op te nemen met validatie onder Action.Toggle vanwege verwarring die kan ontstaan door ongeldige invoer die momenteel niet zichtbaar zijn. Zie /adaptive-cards/authoring-cards/input-validation voor meer informatie.

• Typ: TargetElement[]
• Vereist: Ja
• Toegestane waarden:
  • TargetElement
  • string

title

Label voor knop of koppeling die deze actie vertegenwoordigt.

• Typ: string
• Vereist: Nee

iconUrl

Optioneel pictogram dat moet worden weergegeven voor de actie in combinatie met de titel. Ondersteunt gegevens-URI in versie 1.2+.

• Typ: uri
• Versie: 1.1
• Vereist: Nee

identiteitskaart

Een unieke id die is gekoppeld aan deze actie.

• Typ: string
• Vereist: Nee

style

Hiermee bepaalt u de stijl van een actie, die van invloed is op de manier waarop de actie wordt weergegeven, gesproken, enzovoort.

• Typ: ActionStyle
• Versie: 1.2
• Vereist: Nee
• Toegestane waarden:
  • "default": De actie wordt als normaal weergegeven.
  • "positive": Actie wordt weergegeven met een positieve stijl (meestal wordt de knop accentkleur).
  • "destructive": Actie wordt weergegeven met een destructieve stijl (meestal wordt de knop rood).

Fallback

Hierin wordt beschreven wat u moet doen wanneer een onbekend element wordt aangetroffen of wanneer niet kan worden voldaan aan de vereisten van dit of enige onderliggende elementen.

• Type: Action, FallbackOption
• Versie: 1.2
• Vereist: Nee
• Toegestane waarden:
  • Action.Execute, Action.OpenUrl, Action.ShowCard, Action.Submit, Action.ToggleVisibility.
  • "drop": zorgt ervoor dat dit element onmiddellijk wordt verwijderd wanneer er onbekende elementen worden aangetroffen. Het onbekende element komt niet hoger naar boven.

knopinfo

Hiermee definieert u tekst die aan de eindgebruiker moet worden weergegeven wanneer deze de muisaanwijzer over de actie beweegt en leest wanneer u gesproken software gebruikt.

• Typ: string
• Versie: 1.5
• Vereist: Nee

isIngeschakeld

Bepaalt of de actie moet worden ingeschakeld.

• Typ: boolean
• Versie: 1.5
• Vereist: Nee, standaard: true

mode

Bepaalt of de actie moet worden weergegeven als een knop of in het overloopmenu.

• Typ: ActionMode
• Versie: 1.5
• Vereist: Nee, standaard: "primary"
• Toegestane waarden:
  • "primary": Actie wordt weergegeven als een knop.
  • "secondary": Actie wordt in een overloopmenu geplaatst (meestal een pop-upmenu onder een ... knop).

Vereist

Een reeks sleutel-/waardeparen die aangeven welke functies het item nodig heeft met de bijbehorende minimale versie. Wanneer een functie ontbreekt of een onvoldoende versieniveau heeft, wordt fallback geactiveerd.

• Typ: Dictionary<string>
• Versie: 1.2
• Vereist: Nee