Карточки

  • Статья

Карточка — это контейнер пользовательского интерфейса (UI) для коротких или связанных фрагментов информации. Карточки могут иметь множество свойств и вложений, а также кнопки, запускающие действия с карточками. С помощью карточек вы можете упорядочивать информацию по группам и предоставлять пользователям возможность взаимодействовать с определенными частями информации.

Боты для Microsoft Teams поддерживают следующие типы карточек:

  • Адаптивная карточка
  • Карточка главного имиджевого баннера
  • Карточка списка
  • Карта соединителя для Группы Microsoft 365
  • Карточка квитанции
  • Карточка входа
  • Карточка эскиза
  • Коллекции карточек
  • Меню переполнения на адаптивных карточках

В зависимости от типа карточки вы можете добавить в них форматирование текста с использованием Markdown или HTML. Карточки, используемые ботами и расширениями сообщений в Teams, добавляют и реагируют на эти действия карта, openUrl, messageBack, imBackinvokeи 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.

Элементы мультимедиа в адаптивных карточках

Элементы мультимедиа в адаптивной карточке обеспечивают расширенные возможности мультимедиа и повышают вовлеченность с адаптивной карточкой. В адаптивную карточку можно добавить файлы мультимедиа, такие как аудио- или видеоклипы. Дополнительные сведения см. в разделе Элементы мультимедиа в адаптивной карточке.

Адаптивные карточки и входящие веб-перехватчики

Примечание.

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

CodeBlock в адаптивных карточках

Делитесь фрагментами кода в виде полноформатных адаптивных карточек в чатах, каналах и собраниях Teams с CodeBlock помощью элемента . Адаптивные карточки с элементом CodeBlock упрощают чтение фрагмента кода, так как отступ, нумерация и выделение синтаксиса соответствуют языку программирования. Дополнительные сведения см. в разделе CodeBlock в адаптивных карточках.

Адаптивный макет адаптивной карточки

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

Меню переполнения на адаптивных карточках

Адаптивная карточка в Teams поддерживает меню переполнения. Вы можете заполнить меню переполнения для всех дополнительных действий в адаптивной карточке.

Поддержка идентификатора объекта Microsoft Entra и имени участника-пользователя в пользовательском упоминание

Боты с адаптивными карточками поддерживают идентификаторы пользователей упоминание, такие как идентификатор объекта Microsoft Entra и имя принципа пользователя (UPN) в дополнение к существующим идентификаторам. Входящие веб-перехватчики начинают поддерживать упоминание пользователей в адаптивной карточке с идентификатором объекта Microsoft Entra и имени участника-пользователя.

Следующий этап

Типы карточек

См. также