Åtgärd.VäxlaSynlighet

Den här sidan dokumenterar elementet Action.ToggleVisibility , som är en åtgärd som växlar synligheten för associerade kortelement.

Introducerades i version 1.2

Viktig information om tillgänglighet: I version 1.3 av schemat introducerade vi en etikettegenskap på inmatningar för att förbättra tillgängligheten. Om värdappen som du riktar in dig på stöder v1.3 bör du använda Label i stället för en TextBlock som visas i vissa exempel nedan. När de flesta värdappar har uppdaterats till den senaste versionen uppdaterar vi exemplen i enlighet med detta.

Åtgärd.VäxlaSynlighet

En åtgärd som växlar synligheten för associerade kortelement.

Egenskaper för Action.ToggleVisibility

Ärvda egenskaper

Example

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

Egenskaper

targetElements

Matrisen för TargetElements. Vi rekommenderar inte att du inkluderar indataelement med validering under Åtgärd.Växla på grund av förvirring som kan uppstå på grund av ogiltiga indata som för närvarande inte visas. Ytterligare information finns i /adaptive-cards/authoring-cards/input-validation.

• Typ: TargetElement[]
• Obligatoriskt: Ja
• Tillåtna värden:
  • TargetElement
  • string

title

Etikett för knapp eller länk som representerar den här åtgärden.

• Typ: string
• Obligatoriskt: Nej

iconUrl

Valfri ikon som ska visas på åtgärden tillsammans med rubriken. Stöder data-URI i version 1.2+.

• Typ: uri
• Version: 1.1
• Obligatoriskt: Nej

Id-nummer

En unik identifierare som är associerad med den här åtgärden.

• Typ: string
• Obligatoriskt: Nej

style

Styr formatet för en åtgärd, vilket påverkar hur åtgärden visas, talas osv..

• Typ: ActionStyle
• Version: 1.2
• Obligatoriskt: Nej
• Tillåtna värden:
  • "default": Åtgärden visas som vanligt.
  • "positive": Åtgärden visas med en positiv stil (vanligtvis får knappen en accentfärg).
  • "destructive": Åtgärden visas med en destruktiv stil (vanligtvis blir knappen röd).

Reservlösning

Beskriver vad du ska göra när ett okänt element påträffas eller om det här eller eventuella underordnade element inte kan uppfyllas.

• Typ: Action, FallbackOption
• Version: 1.2
• Obligatoriskt: Nej
• Tillåtna värden:
  • Action.Execute, Action.OpenUrl, Action.ShowCard, Action.Submit, . Action.ToggleVisibility
  • "drop": Gör att det här elementet tas bort omedelbart när okända element påträffas. Det okända elementet bubblar inte upp högre.

knappbeskrivning

Definierar text som ska visas för slutanvändaren när användaren hovrar musen över åtgärden och läser när berättarprogrammet används.

• Typ: string
• Version: 1.5
• Obligatoriskt: Nej

ärAktiverad

Avgör om åtgärden ska aktiveras.

• Typ: boolean
• Version: 1.5
• Obligatoriskt: Nej, standard: true

mode

Avgör om åtgärden ska visas som en knapp eller i spillmenyn.

• Typ: ActionMode
• Version: 1.5
• Obligatoriskt: Nej, standard: "primary"
• Tillåtna värden:
  • "primary": Åtgärden visas som en knapp.
  • "secondary": Åtgärden placeras i en överflödsmeny (vanligtvis i en popupmeny under en ...-knapp).

Kräver

En serie nyckel/värde-par som anger funktioner som objektet kräver med motsvarande lägsta version. När en funktion saknas eller inte har tillräcklig version utlöses återställningen.

• Typ: Dictionary<string>
• Version: 1.2
• Obligatoriskt: Nej