Share via


ActionSet class

Displays a set of action, which can be placed anywhere in the card.

Constructors

ActionSet(ActionArray)

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.area

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.

horizontalAlignment

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.

isSortKey

Controls whether the element should be used as a sort key by elements that allow sorting across a collection of elements.

isVisible

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.

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.

type

Must be ActionSet.

Methods

withActions(ActionArray)
withFallback(FallbackElement)
withHeight(ElementHeight)
withHorizontalAlignment(HorizontalAlignment)
withId(string)
withIsSortKey(boolean)
withIsVisible(boolean)
withLang(string)
withOptions(ActionSetOptions)
withRequires(IHostCapabilities)
withSeparator(boolean)
withSpacing(Spacing)
withTargetWidth(TargetWidth)

Constructor Details

ActionSet(ActionArray)

new ActionSet(actions: ActionArray)

Parameters

actions
ActionArray

Property Details

actions

The actions in the set.

actions: ActionArray

Property Value

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)

function withActions(actions: ActionArray): ActionSet

Parameters

actions
ActionArray

Returns

withFallback(FallbackElement)

function withFallback(fallback: FallbackElement): ActionSet

Parameters

fallback
FallbackElement

Returns

withHeight(ElementHeight)

function withHeight(height: ElementHeight): ActionSet

Parameters

height
ElementHeight

Returns

withHorizontalAlignment(HorizontalAlignment)

function withHorizontalAlignment(horizontalAlignment: HorizontalAlignment): ActionSet

Parameters

horizontalAlignment
HorizontalAlignment

Returns

withId(string)

function withId(id: string): ActionSet

Parameters

id

string

Returns

withIsSortKey(boolean)

function withIsSortKey(isSortKey?: boolean): ActionSet

Parameters

isSortKey

boolean

Returns

withIsVisible(boolean)

function withIsVisible(isVisible?: boolean): ActionSet

Parameters

isVisible

boolean

Returns

withLang(string)

function withLang(lang: string): ActionSet

Parameters

lang

string

Returns

withOptions(ActionSetOptions)

function withOptions(value: ActionSetOptions): ActionSet

Parameters

Returns

withRequires(IHostCapabilities)

function withRequires(requires: IHostCapabilities): ActionSet

Parameters

Returns

withSeparator(boolean)

function withSeparator(separator?: boolean): ActionSet

Parameters

separator

boolean

Returns

withSpacing(Spacing)

function withSpacing(spacing: Spacing): ActionSet

Parameters

spacing
Spacing

Returns

withTargetWidth(TargetWidth)

function withTargetWidth(targetWidth: TargetWidth): ActionSet

Parameters

targetWidth
TargetWidth

Returns