Карточки
Карточка — это контейнер пользовательского интерфейса (UI) для коротких или связанных фрагментов информации. Карточки могут иметь множество свойств и вложений, а также кнопки, запускающие действия с карточками. С помощью карточек вы можете упорядочивать информацию по группам и предоставлять пользователям возможность взаимодействовать с определенными частями информации.
Боты для Microsoft Teams поддерживают следующие типы карточек:
- Адаптивная карточка
- Карточка главного имиджевого баннера
- Карточка списка
- Карточка соединителя для групп Microsoft 365
- Карточка квитанции
- Карточка входа
- Карточка эскиза
- Коллекции карточек
- Меню переполнения на адаптивных карточках
В зависимости от типа карточки вы можете добавить в них форматирование текста с использованием Markdown или HTML. Карточки, используемые ботами и расширениями сообщений в Teams, добавляют и реагируют на эти действия карточек, openUrl
, messageBack
, imBack
invoke
и signin
.
Teams использует карточки в трех разных местах:
- Connectors
- боты;
- Расширения для обмена сообщениями
Карточки в соединителях
Карточки сначала были определены как часть Outlook и Microsoft 365 и теперь используются как часть соединителей для групп Microsoft 365. Как и многие приложения Microsoft 365, Teams поддерживает соединители. Дополнительные сведения см. в статье Создание соединителей для групп Microsoft 365. Спецификацию для карточек в соединителях можно найти в справочнике по карточкам сообщений с действиями.
Карточки в ботах
Microsoft Bot Framework расширяет спецификацию карточек, добавляя набор предопределенных карточек, которые могут использоваться ботами в сообщениях ботов. Teams поддерживает боты с помощью платформы Bot Framework, но в ней поддерживается другой набор карточек. Общие сведения о карточках в Bot Framework можно найти в разделе о добавлении форматированных карточек-вложений в сообщения. Эти карточки называются простыми карточками в Teams.
Боты в Teams могут использовать простые карточки, карточки соединителей или адаптивные карточки. Типы карточек содержат сведения о карточках, поддерживаемых ботами в Teams.
Карточки в расширениях для обмена сообщениями
Расширения для обмена сообщениями также могут возвращать карточку. Расширения для обмена сообщениями могут использовать простые карточки, карточки соединителей или адаптивные карточки. Эти карточки доступны в разделе Типы карточек.
Типы карточек
Все карточки, используемые Teams, перечислены в разделе Типы карточек. В этом справочнике также описываются различия между карточками Bot Framework и карточками в Teams.
Адаптивные карточки
Адаптивные карточки — это новая спецификация карточек для различных продуктов Майкрософт, в том числе ботов, Кортаны, Outlook и Windows. Это рекомендуемый тип карточки для новых разработок Teams. Общие сведения от команды разработки адаптивных карточек см. в обзоре адаптивных карточек. Адаптивные карточки можно использовать везде, где вы используете существующие карточки-главного героя, карточки Microsoft 365 и карточки эскизов.
Помимо адаптивных карточек, Teams поддерживает два других типа карточек:
- Карточки соединителей: используются в составе соединителей для групп Microsoft 365.
- Простые карточки: используются из Bot Framework, например карточки эскизов и главного имиджевого баннера.
Выбор людей в адаптивных карточках
Выбор людей, добавленный в качестве элемента управления входными данными в адаптивных карточках, позволяет искать и выбирать людей. Его можно использовать в чатах, каналах, диалогах (называемых модулями задач в TeamsJS версии 1.x) и вкладках. Мобильные и классические клиенты поддерживают выбор людей, предоставляющий встроенную возможность ввода текста.
Значок "Люди" в адаптивной карточке
Значок "Люди" в адаптивной карточке помогает пользователям просматривать изображения пользователей в адаптивной карточке в Teams. Вы можете просмотреть изображение одного или нескольких пользователей. Значок "Люди" поддерживается в мобильных и настольных клиентах Teams.
Поиск с автозавершением в адаптивных карточках
Поиск Typeahead, добавленный в качестве элемента управления ввода в адаптивных карточках, обеспечивает динамический поиск из динамически загруженного набора данных. Он также позволяет пользователям выполнять статический поиск typeahead в списке с ограниченным количеством вариантов. Мобильные и настольные клиенты поддерживают динамический поиск typeahead.
Элементы мультимедиа в адаптивных карточках
Элементы мультимедиа в адаптивной карточке обеспечивают расширенные возможности мультимедиа и повышают вовлеченность с адаптивной карточкой. В адаптивную карточку можно добавить файлы мультимедиа, такие как аудио- или видеоклипы. Дополнительные сведения см. в разделе Элементы мультимедиа в адаптивной карточке.
Адаптивные карточки и входящие веб-перехватчики
Примечание.
- Все собственные элементы схемы адаптивных карточек, кроме
Action.Submit
, полностью поддерживаются. - Поддерживаемые действия: Action.OpenURL, Action.ShowCard, Action.ToggleVisibility и Action.Execute.
Адаптивные карточки с входящими веб-перехватчиками позволяют вам использовать разнообразные и гибкие возможности адаптивных карточек. Они отправляют данные с помощью входящих веб-перехватчиков в Teams из собственной веб-службы.
CodeBlock в адаптивных карточках
Делитесь фрагментами кода в виде полноформатных адаптивных карточек в чатах, каналах и собраниях Teams с CodeBlock
помощью элемента . Адаптивные карточки с элементом CodeBlock
упрощают чтение фрагмента кода, так как отступ, нумерация и выделение синтаксиса соответствуют языку программирования. Дополнительные сведения см. в разделе CodeBlock в адаптивных карточках.
Адаптивный макет адаптивной карточки
Адаптивные карточки должны быть хорошо выглядеть на любом устройстве, чтобы обеспечить расширенный пользовательский интерфейс в чате, каналах и чате для собраний. Адаптивный макет карточки позволяет разрабатывать карточки с разными макетами, предназначенными для разной ширины карточек. Дополнительные сведения см. в разделе Адаптивный макет адаптивной карточки.
Меню переполнения на адаптивных карточках
Адаптивная карточка в Teams поддерживает меню переполнения. Вы можете заполнить меню переполнения для всех дополнительных действий в адаптивной карточке.
Поддержка идентификатора объекта Microsoft Entra и имени участника-пользователя в упоминании пользователя
Боты с адаптивными карточками поддерживают идентификаторы упоминания пользователей, такие как Идентификатор объекта Microsoft Entra и имя участника-пользователя (UPN) в дополнение к существующим идентификаторам. Входящие веб-перехватчики начинают поддерживать упоминание пользователей в адаптивной карточке с идентификатором объекта Microsoft Entra и upN.
Следующий этап
См. также
Platform Docs