Schema Explorer
Action.ToggleVisibility
An action that toggles the visibility of associated card elements.
Introduced in version 1.2
Property | Type | Required | Description | Version |
---|---|---|---|---|
type | "Action.ToggleVisibility" |
Yes | Must be "Action.ToggleVisibility" . |
1.2 |
targetElements | TargetElement[] |
No | The array of TargetElements | 1.2 |
Inherited properties
Property | Type | Required | Description | Version |
---|---|---|---|---|
title | string |
No | Label for button or link that represents this action. | 1.2 |
iconUrl | uri |
No | Optional icon to be shown on the action in conjunction with the title. Supports data URI in version 1.2+ | 1.1 |
style | ActionStyle |
No | Controls the style of an Action, which influences how the action is displayed, spoken, etc. | 1.2 |
fallback | Action , FallbackOption |
No | Describes what to do when an unknown element is encountered or the requires of this or any children canβt be met. | 1.2 |
inputs | string[] , ActionInputs |
No, default: "None" |
None, All, or an array of ids for inputs (or containers of inputs) that should be validated before allowing this action. | 1.3 |
requires | Dictionary<string> |
No | A series of key/value pairs indicating features that the item requires with corresponding minimum version. When a feature is missing or of insufficient version, fallback is triggered. | 1.2 |
Example
Properties
targetElements
The array of TargetElements
- Type:
TargetElement[]
- Required: No
- Allowed values:
TargetElement
string
title
Label for button or link that represents this action.
- Type:
string
- Required: No
iconUrl
Optional icon to be shown on the action in conjunction with the title. Supports data URI in version 1.2+
- Type:
uri
- Version : 1.1
- Required: No
style
Controls the style of an Action, which influences how the action is displayed, spoken, etc.
- Type:
ActionStyle
- Required: No
- Allowed values:
"default"
: Action is displayed as normal"positive"
: Action is displayed with a positive style (typically the button becomes accent color)"destructive"
: Action is displayed with a destructive style (typically the button becomes red)
fallback
Describes what to do when an unknown element is encountered or the requires of this or any children can't be met.
- Type:
Action
,FallbackOption
- Required: No
- Allowed values:
Action.OpenUrl
Action.ShowCard
Action.Submit
Action.ToggleVisibility
"drop"
: Causes this element to be dropped immediately when unknown elements are encountered. The unknown element doesn't bubble up any higher.
inputs
None, All, or an array of ids for inputs (or containers of inputs) that should be validated before allowing this action.
- Type:
string[]
,ActionInputs
- Version : 1.3
- Required: No, default:
"None"
- Allowed values:
string
"All"
: All inputs will be validated and submitted for this Action."None"
: None of the inputs will be validated or submitted for this Action.
requires
A series of key/value pairs indicating features that the item requires with corresponding minimum version. When a feature is missing or of insufficient version, fallback is triggered.
- Type:
Dictionary<string>
- Required: No