Input.Переключение

Замечание

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

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

Переключатель ввода

Позволяет пользователю выбирать два варианта.

Свойства Input.Toggle

Недвижимость	Тип	Обязательно	Description	Версия
type	"Input.Toggle"	Да	Этот параметр должен содержать значение "Input.Toggle".	1.0
title	string	Да	Заголовок переключателя	1.0
идентификатор	string	Да	Уникальный идентификатор значения. Используется для идентификации собранных входных данных при выполнении действия отправки.	1.0
value	string	Нет, по умолчанию: "false"	Начальное выбранное значение. Если вы хотите, чтобы переключатель изначально был включен, установите значение как у valueOn.	1.0
valueOff	string	Нет, по умолчанию: "false"	Значение при отключении переключателя	1.0
valueOn	string	Нет, по умолчанию: "true"	Значение при включении переключателя	1.0
завернуть	boolean	нет	Если true, разрешить обтекание текста. В противном случае текст обрезается.	1.2

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

Недвижимость	Тип	Обязательно	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. Input.Toggle с пользовательским значением и обязательной валидацией

JSON

Адаптивная карточка

json { "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "type": "AdaptiveCard", "version": "1.3", "body": [ { "type": "Input.Toggle", "id": "acceptTerms", "title": "I accept the terms and agreements", "value": "true", "valueOn": "true", "valueOff": "false", "label": "Please check the box below to accept the terms and agreements:", "isRequired": true, "errorMessage": "You must accept the terms to continue." } ], "actions": [ { "type": "Action.Submit", "title": "OK" } ] }

[Адаптивная карточка попробуйте сами >]

Свойства

заголовок (версия 1.0)

Заголовок переключателя

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

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

Начальное выбранное значение. Если вы хотите, чтобы переключатель изначально был включен, установите его на значение valueOn.

• Тип: string
• Обязательный: нет, по умолчанию: "false"

valueOff (версия 1.0)

Значение при отключении переключателя

• Тип: string
• Обязательный: нет, по умолчанию: "false"

valueOn (версия 1.0)

Значение при включении переключателя

• Тип: string
• Обязательный: нет, по умолчанию: "true"

«Wrap» (версия 1.2)

Если true, разрешить обтекание текста. В противном случае текст обрезается.

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

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
• Обязательный: Нет