Schema Explorer

Choose element:

Input.ChoiceSet

Allows a user to input a Choice.

Property	Type	Required	Description	Version
type	`"Input.ChoiceSet"`	Yes	Must be `"Input.ChoiceSet"`.	1.0
choices	`Input.Choice[]`	Yes	`Choice` options.	1.0
id	`string`	Yes	Unique identifier for the value. Used to identify collected input when the Submit action is performed.	1.0
isMultiSelect	`boolean`	No	Allow multiple choices to be selected.	1.0
style	`ChoiceInputStyle`	No		1.0
value	`string`	No	The initial choice (or set of choices) that should be selected. For multi-select, specify a comma-separated string of values.	1.0
wrap	`boolean`	No	If `true`, allow text to wrap. Otherwise, text is clipped.	1.2

Inherited properties

Property	Type	Required	Description	Version
fallback	`Element`, `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
height	`BlockElementHeight`	No	Specifies the height of the element.	1.1
separator	`boolean`	No	When `true`, draw a separating line at the top of the element.	1.0
spacing	`Spacing`	No	Controls the amount of spacing between this element and the preceding element.	1.0
isVisible	`boolean`	No, default: `true`	If `false`, this item will be removed from the visual tree.	1.2
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

JSON

{
	"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
	"type": "AdaptiveCard",
	"version": "1.0",
	"body": [
		{
			"type": "TextBlock",
			"text": "What color do you want? *(isMultiSelect:false, style:compact)*"
		},
		{
			"type": "Input.ChoiceSet",
			"id": "myColor",
			"style": "compact",
			"isMultiSelect": false,
			"value": "1",
			"choices": [
				{
					"title": "Red",
					"value": "1"
				},
				{
					"title": "Green",
					"value": "2"
				},
				{
					"title": "Blue",
					"value": "3"
				}
			]
		},
		{
			"type": "TextBlock",
			"text": "What color do you want? *(isMultiSelect:false, style:expanded)*"
		},
		{
			"type": "Input.ChoiceSet",
			"id": "myColor2",
			"style": "expanded",
			"isMultiSelect": false,
			"value": "1",
			"choices": [
				{
					"title": "Red",
					"value": "1"
				},
				{
					"title": "Green",
					"value": "2"
				},
				{
					"title": "Blue",
					"value": "3"
				}
			]
		},
		{
			"type": "TextBlock",
			"text": "What colors do you want? *(isMultiSelect:true, style:compact)*"
		},
		{
			"type": "Input.ChoiceSet",
			"id": "myColor3",
			"isMultiSelect": true,
			"value": "1,3",
			"style": "compact",
			"choices": [
				{
					"title": "Red",
					"value": "1"
				},
				{
					"title": "Green",
					"value": "2"
				},
				{
					"title": "Blue",
					"value": "3"
				}
			]
		},
		{
			"type": "TextBlock",
			"text": "What colors do you want? *(isMultiSelect:true, style:expanded)*"
		},
		{
			"type": "Input.ChoiceSet",
			"id": "myColor4",
			"isMultiSelect": true,
			"value": "1",
			"style": "expanded",
			"choices": [
				{
					"title": "Red",
					"value": "1"
				},
				{
					"title": "Green",
					"value": "2"
				},
				{
					"title": "Blue",
					"value": "3"
				}
			]
		}
	],
	"actions": [
		{
			"type": "Action.Submit",
			"title": "OK"
		}
	]
}

Adaptive Card

{ "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "type": "AdaptiveCard", "version": "1.0", "body": [ { "type": "TextBlock", "text": "What color do you want? *(isMultiSelect:false, style:compact)*" }, { "type": "Input.ChoiceSet", "id": "myColor", "style": "compact", "isMultiSelect": false, "value": "1", "choices": [ { "title": "Red", "value": "1" }, { "title": "Green", "value": "2" }, { "title": "Blue", "value": "3" } ] }, { "type": "TextBlock", "text": "What color do you want? *(isMultiSelect:false, style:expanded)*" }, { "type": "Input.ChoiceSet", "id": "myColor2", "style": "expanded", "isMultiSelect": false, "value": "1", "choices": [ { "title": "Red", "value": "1" }, { "title": "Green", "value": "2" }, { "title": "Blue", "value": "3" } ] }, { "type": "TextBlock", "text": "What colors do you want? *(isMultiSelect:true, style:compact)*" }, { "type": "Input.ChoiceSet", "id": "myColor3", "isMultiSelect": true, "value": "1,3", "style": "compact", "choices": [ { "title": "Red", "value": "1" }, { "title": "Green", "value": "2" }, { "title": "Blue", "value": "3" } ] }, { "type": "TextBlock", "text": "What colors do you want? *(isMultiSelect:true, style:expanded)*" }, { "type": "Input.ChoiceSet", "id": "myColor4", "isMultiSelect": true, "value": "1", "style": "expanded", "choices": [ { "title": "Red", "value": "1" }, { "title": "Green", "value": "2" }, { "title": "Blue", "value": "3" } ] } ], "actions": [ { "type": "Action.Submit", "title": "OK" } ] }

Properties

choices

Choice options.

Type: Input.Choice[]
Required: Yes
Allowed values:
- Input.Choice

isMultiSelect

Allow multiple choices to be selected.

Type: boolean
Required: No

style

Type: ChoiceInputStyle
Required: No
Allowed values:
- "compact"
- "expanded"

value

The initial choice (or set of choices) that should be selected. For multi-select, specify a comma-separated string of values.

Type: string
Required: No

wrap

If true, allow text to wrap. Otherwise, text is clipped.

Type: boolean
Version : 1.2
Required: No

id

Unique identifier for the value. Used to identify collected input when the Submit action is performed.

Type: string
Required: Yes

fallback

Describes what to do when an unknown element is encountered or the requires of this or any children can't be met.

Type: Element, FallbackOption
Version : 1.2
Required: No
Allowed values:
- ActionSet
- ColumnSet
- Container
- FactSet
- Image
- ImageSet
- Input.ChoiceSet
- Input.Date
- Input.Number
- Input.Text
- Input.Time
- Input.Toggle
- Media
- RichTextBlock
- TextBlock
- "drop": Causes this element to be dropped immediately when unknown elements are encountered. The unknown element doesn't bubble up any higher.

height

Specifies the height of the element.

Type: BlockElementHeight
Version : 1.1
Required: No
Allowed values:
- "auto": The height of the container will be determined by the height of its contents.
- "stretch": The container will stretch its height to the available remaining height of the parent container.

separator

When true, draw a separating line at the top of the element.

Type: boolean
Required: No

spacing

Controls the amount of spacing between this element and the preceding element.

Type: Spacing
Required: No
Allowed values:
- "default"
- "none"
- "small"
- "medium"
- "large"
- "extraLarge"
- "padding"

isVisible

If false, this item will be removed from the visual tree.

Type: boolean
Version : 1.2
Required: No, default: true

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>
Version : 1.2
Required: No