Поделиться через

Input.Text

Замечание

Вы создаете сценарии Copilot, Teams или Outlook с помощью адаптивных карточек? Посетите Документационный центр по Adaptive Card, новый единый ресурс для всех ваших потребностей в адаптивных картах! У него есть все ресурсы, которые вы ищете, включая полную документацию для многих новых функций, таких как адаптивный макет, значок, значок, карусель, диаграммы и многое другое!

Важное примечание о специальных возможностях: В версии 1.3 схемы мы представили свойство метки входных данных для улучшения специальных возможностей. Если целевое Host-приложение поддерживает версию 1.3, следует использовать метку вместо TextBlock, как показано в некоторых примерах ниже. После обновления большинства приложений узла до последней версии мы обновим примеры соответствующим образом.

Input.Text

Позволяет пользователю вводить текст.

Свойства Input.Text

Недвижимость Тип Обязательно Description Версия
type "Input.Text" Да Этот параметр должен содержать значение "Input.Text". 1.0
идентификатор string Да Уникальный идентификатор значения. Используется для идентификации собранных входных данных при выполнении действия отправки. 1.0
isMultiline boolean нет Если true, допускается использование нескольких строк ввода. 1.0
maxLength number нет Указание максимальной длины собираемых символов (может игнорироваться некоторыми клиентами). 1.0
заполнитель string нет Описание требуемого входного значения. Отображается при отсутствии входных данных текста. 1.0
regex string нет Регулярное выражение, указывающее обязательный формат этого текстового ввода. 1.3
style TextInputStyle нет Указание стиля для ввода текста. 1.0
inlineAction ISelectAction нет Встроенное действие для входных данных. Обычно отображается справа от входных данных. Настоятельно рекомендуется указать значок действия (который будет отображаться вместо названия действия). 1.2
value string нет Начальное значение этого поля. 1.0

Унаследованные свойства

Недвижимость Тип Обязательно Description Версия
Errormessage string нет Сообщение об ошибке, отображаемое при вводе входных данных, недопустимое 1.3
isRequired boolean нет Является ли этот вход обязательным 1.3
label string нет Метка для этих входных данных 1.3
labelPosition InputLabelPosition нет [ПОДДЕРЖИВАЕТСЯ ТОЛЬКО В ПАКЕТЕ SDK JAVASCRIPT] Определяет позицию метки. Оно может принимать значения 'inline' и 'above'. По умолчанию метка помещается "выше", если позиция метки не указана. 1.6
labelWidth string, number нет [ПОДДЕРЖИВАЕТСЯ ТОЛЬКО В ПАКЕТЕ SDK JAVASCRIPT] Определяет ширину метки в процентах, например 40 или определенную ширину пикселей, например "40 пикселей", когда метка помещается в строку с входными данными. labelWidth будет игнорироваться при отображении метки над входными данными. 1.6
inputStyle InputStyle нет [ПОДДЕРЖИВАЕТСЯ ТОЛЬКО В ПАКЕТЕ SDK JAVASCRIPT] Указание стиля для полей ввода. Позволяет полям ввода отображаться только для чтения, но если пользователь щелкает или фокусируется на поле, он позволяет им обновлять эти поля. 1.6
резервный вариант Element, FallbackOption нет Определяет, что делать, если обнаружен неизвестный элемент или невозможно удовлетворить требования для него или его дочерних элементов. 1.2
height BlockElementHeight нет Указывает высоту элемента. 1.1
separator boolean нет Когда true, проведите линию разделения в верхней части элемента. 1.0
интервал Spacing нет Управляет интервалом между этим элементом и предыдущим элементом. 1.0
isVisible boolean Нет, по умолчанию: true Если falseэтот элемент будет удален из визуального дерева. 1.2
Требует Dictionary<string> нет Ряд пар "ключ-значение", указывающих на функции, необходимые элементу с соответствующей минимальной версией. Если функция отсутствует или не хватает версии, активируется резервный вариант. 1.2

Example

Пример 1. Поля ввода текста по умолчанию, многострочные и предварительно заполненные

JSON Адаптивная карточка
json { "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "type": "AdaptiveCard", "version": "1.0", "body": [ { "type": "TextBlock", "text": "Default text input" }, { "type": "Input.Text", "id": "defaultInputId", "placeholder": "enter comment", "maxLength": 500 }, { "type": "TextBlock", "text": "Multiline text input" }, { "type": "Input.Text", "id": "multilineInputId", "placeholder": "enter comment", "maxLength": 500, "isMultiline": true }, { "type": "TextBlock", "text": "Pre-filled value" }, { "type": "Input.Text", "id": "prefilledInputId", "placeholder": "enter comment", "maxLength": 500, "isMultiline": true, "value": "This value was pre-filled" } ], "actions": [ { "type": "Action.Submit", "title": "OK" } ] } Испытайте эту адаптивную карточку самостоятельно >

Свойства

isMultiline (версия 1.0)

Если true, разрешите несколько строк входных данных.

  • Тип: boolean
  • Обязательный: Нет

maxLength (версия 1.0)

Указание максимальной длины собираемых символов (может игнорироваться некоторыми клиентами).

  • Тип: number
  • Обязательный: Нет

плейсхолдер (версия 1.0)

Описание требуемого входного значения. Отображается при отсутствии входных данных текста.

  • Тип: string
  • Обязательный: Нет

regex (версия 1.3)

Регулярное выражение, указывающее обязательный формат этого текстового ввода.

  • Тип: string
  • Версия : 1.3
  • Обязательный: Нет

style (версия 1.0)

Указание стиля для ввода текста.

  • Тип: TextInputStyle
  • Обязательный: Нет
  • Допустимые значения:
    • "text"
    • "tel"
    • "url"
    • "email"
    • "password": добавлено в версию 1.5. Отображение входного текста с маскированием паролей.
JSON Адаптивная карточка
json { "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "type": "AdaptiveCard", "version": "1.3", "body": [ { "type": "TextBlock", "text": "Specify the type of text being requested:", "style": "heading" }, { "type": "Input.Text", "id": "myComment", "label": "style: text", "style": "text" }, { "type": "Input.Text", "id": "myEmail", "label": "style: email", "style": "email" }, { "type": "Input.Text", "id": "myTel", "label": "style: tel", "style": "tel" }, { "type": "Input.Text", "id": "myUrl", "label": "style: url", "style": "url" }, { "type": "Input.Text", "id": "myPassword", "label": "style: password", "style": "password" } ], "actions": [ { "type": "Action.Submit", "title": "OK" } ] } Испытайте эту адаптивную карточку самостоятельно >

inlineAction (версия 1.2)

Встроенное действие для входных данных. Обычно отображается справа от входных данных. Настоятельно рекомендуется указать значок действия (который будет отображаться вместо названия действия).

  • Тип: ISelectAction
  • Версия : 1.2
  • Обязательный: Нет
  • Допустимые значения:
    • Action.Execute
    • Action.OpenUrl
    • Action.Submit
    • Action.ToggleVisibility
JSON Адаптивная карточка
json { "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "type": "AdaptiveCard", "version": "1.5", "body": [ { "type": "Input.Text", "id": "iconInlineActionId", "label": "Text input with an inline action", "inlineAction": { "type": "Action.Submit", "iconUrl": "https://adaptivecards.io/content/send.png", "tooltip": "Send" } }, { "type": "Input.Text", "label": "Text input with an inline action with no icon", "id": "textInlineActionId", "inlineAction": { "type": "Action.OpenUrl", "title": "Reply", "tooltip": "Reply to this message", "url": "https://adaptivecards.io" } } ] } Испытайте эту адаптивную карточку самостоятельно >

значение (версия 1.0)

Начальное значение этого поля.

  • Тип: string
  • Обязательный: Нет

id (версия 1.0)

Уникальный идентификатор значения. Используется для идентификации собранных входных данных при выполнении действия отправки.

  • Тип: string
  • Обязательный: Да

сообщение об ошибке (версия 1.3)

Сообщение об ошибке, отображаемое при вводе входных данных, недопустимое

  • Тип: string
  • Версия : 1.3
  • Обязательный: Нет

isRequired (версия 1.3)

Является ли этот вход обязательным

  • Тип: boolean
  • Версия : 1.3
  • Обязательный: Нет

метка (версия 1.3)

Метка для этих входных данных

  • Тип: string
  • Версия : 1.3
  • Обязательный: Нет

labelPosition (версия 1.6)

[ПОДДЕРЖИВАЕТСЯ ТОЛЬКО В ПАКЕТЕ SDK JAVASCRIPT] Определяет позицию метки. Оно может принимать значения 'inline' и 'above'. По умолчанию метка помещается "выше", если позиция метки не указана.

  • Тип: InputLabelPosition
  • Версия : 1.6
  • Обязательный: Нет
  • Допустимые значения:
    • "inline"
    • "above"

labelWidth (версия 1.6)

[ПОДДЕРЖИВАЕТСЯ ТОЛЬКО В ПАКЕТЕ SDK JAVASCRIPT] Определяет ширину метки в процентах, например 40 или определенную ширину пикселей, например "40 пикселей", когда метка помещается в строку с входными данными. labelWidth будет игнорироваться при отображении метки над входными данными.

  • Тип: string, number
  • Версия : 1.6
  • Обязательный: Нет

inputStyle (версия 1.6)

[ПОДДЕРЖИВАЕТСЯ ТОЛЬКО В ПАКЕТЕ SDK JAVASCRIPT] Указание стиля для полей ввода. Позволяет полям ввода отображаться только для чтения, но если пользователь щелкает или фокусируется на поле, он позволяет им обновлять эти поля.

  • Тип: InputStyle
  • Версия : 1.6
  • Обязательный: Нет
  • Допустимые значения:
    • "revealOnHover"
    • "default"

резервная версия (версия 1.2)

Описывает, что делать, когда обнаружен неизвестный элемент или не удаётся удовлетворить требования этого или любых дочерних элементов.

  • Тип: Element, FallbackOption
  • Версия : 1.2
  • Обязательный: Нет
  • Допустимые значения:
    • ActionSet
    • ColumnSet
    • Container
    • FactSet
    • Image
    • ImageSet
    • Input.ChoiceSet
    • Input.Date
    • Input.Number
    • Input.Text
    • Input.Time
    • Input.Toggle
    • Media
    • RichTextBlock
    • Table
    • TextBlock
    • "drop": вызывает немедленное удаление этого элемента при обнаружении неизвестных элементов. Неизвестный элемент не поднимается выше.

высота (версия 1.1)

Указывает высоту элемента.

  • Тип: BlockElementHeight
  • Версия : 1.1
  • Обязательный: Нет
  • Допустимые значения:
    • "auto": высота контейнера определяется высотой его содержимого.
    • "stretch": Контейнер растянет свою высоту до доступной оставшейся высоты родительского контейнера.

разделитель (версия 1.0)

Когда true, проведите линию разделения в верхней части элемента.

  • Тип: boolean
  • Обязательный: Нет

интервалы (версия 1.0)

Управляет интервалом между этим элементом и предыдущим элементом.

  • Тип: Spacing
  • Обязательный: Нет
  • Допустимые значения:
    • "default"
    • "none"
    • "small"
    • "medium"
    • "large"
    • "extraLarge"
    • "padding"

isVisible (версия 1.2)

Если falseэтот элемент будет удален из визуального дерева.

  • Тип: boolean
  • Версия : 1.2
  • Обязательный: нет, по умолчанию: true

требуется (версия 1.2)

Ряд пар "ключ-значение", указывающих на функции, необходимые элементу с соответствующей минимальной версией. Если функция отсутствует или не хватает версии, активируется резервный вариант.

  • Тип: Dictionary<string>
  • Версия : 1.2
  • Обязательный: Нет
  • Last updated on