ITextInput interface

Package:

@microsoft/teams.cards

An input to allow the user to enter text.

Properties

errorMessage	The error message to display when the input fails validation. See Input validation for more details.
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.
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.
inlineAction	The action that should be displayed as a button alongside the input. Action.ShowCard is not supported.
isMultiline	Controls if the input should allow multiple lines of text.
isRequired	Controls whether the input is required. See Input validation for more details.
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.
label	The label of the input. A label should always be provided to ensure the best user experience especially for users of assistive technology.
lang	The locale associated with the element.
maxLength	The maximum length of the text in the input.
placeholder	The text to display as a placeholder when the user hasn't entered a value.
regex	The regular expression to validate the input.
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.
style	The style of the input.
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 Input.Text.
value	The default value of the input.
valueChangedAction	An Action.ResetInputs action that will be executed when the value of the input changes.

Property Details

errorMessage

The error message to display when the input fails validation. See Input validation for more details.

errorMessage?: string

Property Value

string

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

FallbackElement

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

ElementHeight

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

inlineAction

The action that should be displayed as a button alongside the input. Action.ShowCard is not supported.

inlineAction?: IExecuteAction | IOpenUrlAction | IResetInputsAction | ISubmitAction | IToggleVisibilityAction

Property Value

IExecuteAction | IOpenUrlAction | IResetInputsAction | ISubmitAction | IToggleVisibilityAction

isMultiline

Controls if the input should allow multiple lines of text.

isMultiline?: boolean

Property Value

boolean

isRequired

Controls whether the input is required. See Input validation for more details.

isRequired?: boolean

Property Value

boolean

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

label

The label of the input.

A label should always be provided to ensure the best user experience especially for users of assistive technology.

label?: string

Property Value

string

lang

The locale associated with the element.

lang?: string

Property Value

string

maxLength

The maximum length of the text in the input.

maxLength?: number

Property Value

number

placeholder

The text to display as a placeholder when the user hasn't entered a value.

placeholder?: string

Property Value

string

regex

The regular expression to validate the input.

regex?: 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

IHostCapabilities

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

Spacing

style

The style of the input.

style?: InputTextStyle

Property Value

InputTextStyle

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

TargetWidth

type

Must be Input.Text.

type: "Input.Text"

Property Value

"Input.Text"

value

The default value of the input.

value?: string

Property Value

string

valueChangedAction

An Action.ResetInputs action that will be executed when the value of the input changes.

valueChangedAction?: IResetInputsAction

Property Value

IResetInputsAction