ActionSet class
Displays a set of action, which can be placed anywhere in the card.
Constructors
| Action |
Properties
| actions | The actions in the set. |
| fallback | An alternate element to render if the type of this one is unsupported or if the host application doesn't support all the capabilities specified in the requires property. |
| grid. |
The area of a Layout.AreaGrid layout in which an element should be displayed. |
| height | The height of the element. When set to stretch, the element will use the remaining vertical space in its container. |
| horizontal |
Controls how the element should be horizontally aligned. |
| id | A unique identifier for the element or action. Input elements must have an id, otherwise they will not be validated and their values will not be sent to the Bot. |
| is |
Controls whether the element should be used as a sort key by elements that allow sorting across a collection of elements. |
| is |
Controls the visibility of the element. |
| lang | The locale associated with the element. |
| requires | A list of capabilities the element requires the host application to support. If the host application doesn't support at least one of the listed capabilities, the element is not rendered (or its fallback is rendered if provided). |
| separator | Controls whether a separator line should be displayed above the element to visually separate it from the previous element. No separator will be displayed for the first element in a container, even if this property is set to true. |
| spacing | Controls the amount of space between this element and the previous one. No space will be added for the first element in a container. |
| target |
Controls for which card width the element should be displayed. If targetWidth isn't specified, the element is rendered at all card widths. Using targetWidth makes it possible to author responsive cards that adapt their layout to the available horizontal space. For more details, see Responsive layout. |
| type | Must be ActionSet. |
Methods
Constructor Details
ActionSet(ActionArray)
Property Details
actions
fallback
An alternate element to render if the type of this one is unsupported or if the host application doesn't support all the capabilities specified in the requires property.
fallback?: FallbackElement
Property Value
grid.area
The area of a Layout.AreaGrid layout in which an element should be displayed.
grid.area?: string
Property Value
string
height
The height of the element. When set to stretch, the element will use the remaining vertical space in its container.
height?: ElementHeight
Property Value
horizontalAlignment
Controls how the element should be horizontally aligned.
horizontalAlignment?: HorizontalAlignment
Property Value
id
A unique identifier for the element or action. Input elements must have an id, otherwise they will not be validated and their values will not be sent to the Bot.
id?: string
Property Value
string
isSortKey
Controls whether the element should be used as a sort key by elements that allow sorting across a collection of elements.
isSortKey?: boolean
Property Value
boolean
isVisible
Controls the visibility of the element.
isVisible?: boolean
Property Value
boolean
lang
The locale associated with the element.
lang?: string
Property Value
string
requires
A list of capabilities the element requires the host application to support. If the host application doesn't support at least one of the listed capabilities, the element is not rendered (or its fallback is rendered if provided).
requires?: IHostCapabilities
Property Value
separator
Controls whether a separator line should be displayed above the element to visually separate it from the previous element. No separator will be displayed for the first element in a container, even if this property is set to true.
separator?: boolean
Property Value
boolean
spacing
Controls the amount of space between this element and the previous one. No space will be added for the first element in a container.
spacing?: Spacing
Property Value
targetWidth
Controls for which card width the element should be displayed. If targetWidth isn't specified, the element is rendered at all card widths. Using targetWidth makes it possible to author responsive cards that adapt their layout to the available horizontal space. For more details, see Responsive layout.
targetWidth?: TargetWidth
Property Value
type
Must be ActionSet.
type: "ActionSet" = "ActionSet"
Property Value
"ActionSet"
Method Details
withActions(ActionArray)
withFallback(FallbackElement)
function withFallback(fallback: FallbackElement): ActionSet
Parameters
- fallback
- FallbackElement
Returns
withHeight(ElementHeight)
withHorizontalAlignment(HorizontalAlignment)
function withHorizontalAlignment(horizontalAlignment: HorizontalAlignment): ActionSet
Parameters
- horizontalAlignment
- HorizontalAlignment
Returns
withId(string)
withIsSortKey(boolean)
function withIsSortKey(isSortKey?: boolean): ActionSet
Parameters
- isSortKey
-
boolean
Returns
withIsVisible(boolean)
function withIsVisible(isVisible?: boolean): ActionSet
Parameters
- isVisible
-
boolean
Returns
withLang(string)
withOptions(ActionSetOptions)
withRequires(IHostCapabilities)
function withRequires(requires: IHostCapabilities): ActionSet
Parameters
- requires
- IHostCapabilities
Returns
withSeparator(boolean)
function withSeparator(separator?: boolean): ActionSet
Parameters
- separator
-
boolean
Returns
withSpacing(Spacing)
withTargetWidth(TargetWidth)
function withTargetWidth(targetWidth: TargetWidth): ActionSet
Parameters
- targetWidth
- TargetWidth