Action.UmschaltenSichtbarkeit

Hinweis

Erstellen Sie Copilot-, Teams- oder Outlook-Szenarien, die von adaptiven Karten unterstützt werden? Besuchen Sie den Dokumentationshub für adaptive Karten, den neuen One-Stop-Shop für alle Ihre Anforderungen an adaptive Karten! Es verfügt über alle Ressourcen, die Sie suchen, einschließlich der vollständigen Dokumentation für viele neue Features, z. B. dynamisches Layout, Symbol, Badge, Karussell, Diagramme und vieles mehr!

Diese Seite dokumentiert das Action.ToggleVisibility-Element , bei dem es sich um eine Aktion handelt, mit der die Sichtbarkeit der zugehörigen Kartenelemente umgeschaltet wird.

Eingeführt in Version 1.2

Wichtiger Hinweis zur Barrierefreiheit: In Version 1.3 des Schemas haben wir eine Bezeichnungseigenschaft für Eingaben eingeführt, um die Barrierefreiheit zu verbessern. Wenn die Host-App, auf die Sie abzielen , v1.3 unterstützt, sollten Sie die Bezeichnung anstelle eines TextBlock verwenden, wie in einigen Beispielen unten dargestellt. Sobald die meisten Host-Apps auf die neueste Version aktualisiert wurden, aktualisieren wir die Beispiele entsprechend.

Aktion.SichtbarkeitUmschalten

Eine Aktion, mit der die Sichtbarkeit der zugeordneten Kartenelemente umgeschaltet wird.

Action.ToggleVisibility-Eigenschaften

Eigentum Typ Erforderlich Description Version
type "Action.ToggleVisibility" Yes Muss "Action.ToggleVisibility" sein. 1.2
Zielelemente TargetElement[] Yes Das Array von TargetElements. Es wird nicht empfohlen, Eingabeelemente in die Überprüfung unter "Action.Toggle" einzuschließen, da Verwirrung besteht, die sich aus ungültigen Eingaben ergeben kann, die derzeit nicht sichtbar sind. Unter /adaptive-cards/authoring-cards/input-validation finden Sie weitere Informationen. 1.2

Geerbte Eigenschaften

Eigentum Typ Erforderlich Description Version
Titel string Nein Bezeichnung für Schaltfläche oder Link, die diese Aktion darstellt. 1.2
iconUrl uri Nein Optionales Symbol, das in der Aktion zusammen mit dem Titel angezeigt werden soll. Unterstützt Daten-URI in Version 1.2 und höher. 1.1
id string Nein Ein eindeutiger Bezeichner, der dieser Aktion zugeordnet ist. 1.2
style ActionStyle Nein Steuert die Art einer Aktion, die beeinflusst, wie die Aktion angezeigt, gesprochen usw. wird. 1.2
Ausweichlösung Action, FallbackOption Nein Beschreibt, was zu tun ist, wenn ein unbekanntes Element auftritt oder dies oder alle untergeordneten Elemente nicht erfüllt werden können. 1.2
Quickinfo string Nein Definiert Text, der dem Endbenutzer angezeigt werden soll, während er mit dem Mauszeiger auf die Aktion zeigt und beim Verwenden von Kommentarsoftware vorgelesen wird. 1.5
isEnabled boolean Nein, Standard: true Bestimmt, ob die Aktion aktiviert werden soll. 1.5
mode ActionMode Nein, Standard: "primary" Bestimmt, ob die Aktion als Schaltfläche oder im Überlaufmenü angezeigt werden soll. 1.5
erfordert Dictionary<string> Nein Eine Reihe von Schlüssel-Wert-Paaren, die Features angeben, die für das Element mit entsprechender Mindestversion erforderlich sind. Wenn ein Feature fehlt oder die Version nicht ausreichend ist, wird ein Rückfall ausgelöst. 1.2

Example

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

Eigenschaften

Zielelemente

Das Array von TargetElements. Es wird nicht empfohlen, Eingabeelemente in die Überprüfung unter "Action.Toggle" einzuschließen, da Verwirrung besteht, die sich aus ungültigen Eingaben ergeben kann, die derzeit nicht sichtbar sind. Weitere Informationen finden Sie unter /adaptive-cards/authoring-cards/input-validation .

  • Typ: TargetElement[]
  • Erforderlich: Ja
  • Zulässige Werte:
    • TargetElement
    • string

title

Bezeichnung für Schaltfläche oder Link, die diese Aktion darstellt.

  • Typ: string
  • Erforderlich: Nein

Icon-URL

Optionales Symbol, das in der Aktion zusammen mit dem Titel angezeigt werden soll. Unterstützt Daten-URI in Version 1.2 und höher.

  • Typ: uri
  • Version: 1.1
  • Erforderlich: Nein

id

Ein eindeutiger Bezeichner, der dieser Aktion zugeordnet ist.

  • Typ: string
  • Erforderlich: Nein

style

Steuert die Art einer Aktion, die beeinflusst, wie die Aktion angezeigt, gesprochen usw. wird.

  • Typ: ActionStyle
  • Version: 1.2
  • Erforderlich: Nein
  • Zulässige Werte:
    • "default": Die Aktion wird normal angezeigt.
    • "positive": Die Aktion wird mit einem positiven Stil angezeigt (in der Regel wird die Schaltfläche zu Akzentfarbe).
    • "destructive": Die Aktion wird mit einem destruktiven Stil angezeigt (normalerweise wird die Schaltfläche rot).

Plan B

Beschreibt, was zu tun ist, wenn ein unbekanntes Element auftritt oder die Anforderungen dieses oder eines der untergeordneten Elemente nicht erfüllt werden können.

  • Typ: Action, FallbackOption
  • Version: 1.2
  • Erforderlich: Nein
  • Zulässige Werte:
    • Action.Execute, Action.OpenUrl, Action.ShowCard, Action.Submit, . Action.ToggleVisibility
    • "drop": Bewirkt, dass dieses Element sofort gelöscht wird, wenn unbekannte Elemente gefunden werden. Das unbekannte Element taucht nicht weiter oben auf.

tooltip

Definiert Text, der dem Endbenutzer angezeigt werden soll, während er mit dem Mauszeiger auf die Aktion zeigt und beim Verwenden von Kommentarsoftware vorgelesen wird.

  • Typ: string
  • Version: 1.5
  • Erforderlich: Nein

isEnabled

Bestimmt, ob die Aktion aktiviert werden soll.

  • Typ: boolean
  • Version: 1.5
  • Erforderlich: Nein, Standard: true

mode

Bestimmt, ob die Aktion als Schaltfläche oder im Überlaufmenü angezeigt werden soll.

  • Typ: ActionMode
  • Version: 1.5
  • Erforderlich: Nein, Standard: "primary"
  • Zulässige Werte:
    • "primary": Die Aktion wird als Schaltfläche angezeigt.
    • "secondary": Die Aktion wird in einem Überlaufmenü (in der Regel ein Popupmenü unter einer ... Schaltfläche) platziert.

erfordert

Eine Reihe von Schlüssel-Wert-Paaren, die Features angeben, die für das Element mit entsprechender Mindestversion erforderlich sind. Wenn ein Feature fehlt oder die Version nicht ausreichend ist, wird ein Rückfall ausgelöst.

  • Typ: Dictionary<string>
  • Version: 1.2
  • Erforderlich: Nein
  • Last updated on