Форматирование карточек в Teams

Статья
03/26/2024

Ниже приводится два способа добавления форматирования текста в карточки:

Markdown
HTML

Карточки не поддерживают форматирование в свойствах заголовка или подзаголовка, но поддерживают его в свойстве текста. Форматирование можно задать с помощью подмножества для форматирования XML либо HTML или Markdown в зависимости от типа карточки. Для текущей и будущей разработки адаптивных карточек рекомендуется форматирование Markdown.

Поддержка форматирования зависит от типа карточки. Отрисовка карта может немного отличаться между настольными и мобильными клиентами Microsoft Teams, а также Teams в классическом браузере.

Вы можете включить встроенный рисунок в любую карточку Teams. Поддерживаемые форматы изображений: PNG, JPG, GIF. Используйте размеры в пределах 1024 x 1024 пикселей и размер файла менее 1 МБ. Анимированные .gif изображения не поддерживаются. Дополнительные сведения см. в разделе Типы карточек.

Адаптивные карточки и карточки соединителей можно форматировать для Группы Microsoft 365 с помощью Markdown, включающих определенные поддерживаемые стили.

Форматирование карточек с помощью Markdown

Следующие типы карточек поддерживают форматирование Markdown в Teams:

Адаптивные карточки: Markdown поддерживается в поле Адаптивная карточка Textblock и Fact.TitleFact.Value. HTML не поддерживается в адаптивных карточках.
Карточки соединителей для Группы Microsoft 365: markdown и ограниченный HTML поддерживаются в карточках соединителей для Группы Microsoft 365 в текстовых полях.

Примечание.

Markdown не поддерживается для карточек входа OAuth в ботах.

Вы можете использовать новые строки для адаптивных карточек с помощью escape-последовательности \r или \n для новых строк в списках. Форматирование адаптивных карточек отличается в классической и мобильной версиях Teams. Упоминания на основе карточек поддерживаются в классическом, мобильном и веб-клиенте. Вы можете использовать свойство маскировки информации для маскировки определенных сведений, например пароля или конфиденциальной информации от пользователей, во входном элементе Input.Text адаптивной карточки. Ширину адаптивной карточки можно увеличить с помощью объекта width. Вы можете включить поддержку опережающего ввода в адаптивных карточках и отфильтровать варианты ввода при наборе входных данных пользователем. Свойство можно использовать для msteams добавления возможности выборочного отображения изображений в Stageview.

Форматирование адаптивных карточек и карточек соединителей отличается в классической и мобильной версиях Teams. В этом разделе можно ознакомиться с примером форматирования Markdown для адаптивных карточек и карточек соединителей.

Форматирование Markdown для адаптивных карточек
Формат Markdown для карточек соединителей для Группы Microsoft 365

В таблице ниже указаны поддерживаемые стили для Textblock, Fact.Title и Fact.Value:

Style	Пример	Markdown
Полужирный	Bold	`Bold`
Курсив	Italic	`_Italic_`
Неупорядоченный список	текст текст	`- Item 1\r- Item 2\r- Item 3`
Упорядоченный список	текст текст	`1. Green\r2. Orange\r3. Blue`
Гиперссылки	Bing	`[Title](url)`

Следующие теги Markdown не поддерживаются:

Заголовки
Таблицы
изображения;
Предварительно отформатированный текст
Цитаты

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

Вы можете использовать escape-последовательность \r или \n для новых строк в списках. Использование \n\n в списках приводит к добавлению отступа перед следующим элементом в списке. Если вам нужны новые строки где либо еще в TextBlock, используйте \n\n.

Различия, связанные с адаптивными карточками, в классической и мобильной версиях

В классической версии форматирование Markdown для адаптивных карточек отображается в веб-браузерах и в клиентском приложении Teams следующим образом:

Снимок экрана: пример форматирования Адаптивной карточки Markdown в классическом клиенте Teams.

В iOS форматирование Markdown для адаптивных карточек отображается следующим образом:

Снимок экрана: пример форматирования Адаптивной карточки Markdown на платформе Teams iOS.

В Android форматирование Markdown для адаптивных карточек отображается следующим образом:

Снимок экрана: пример форматирования Адаптивной карточки Markdown на платформе Android Teams.

Дополнительные сведения см. в разделе Текстовые функции в адаптивных карточках.

Примечание.

Функции даты и локализации, упомянутые в этом разделе, не поддерживаются в Teams.

Пример форматирования адаптивных карточек

В следующем коде показан пример форматирования адаптивных карточек:

{
    "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
    "type": "AdaptiveCard",
    "version": "1.0",
    "body": [
        {
            "type": "TextBlock",
            "text": "This is some **bold** text"
        },
        {
            "type": "TextBlock",
            "text": "This is some _italic_ text"
        },
        {
            "type": "TextBlock",
            "text": "- Bullet \r- List \r",
            "wrap": true
        },
        {
            "type": "TextBlock",
            "text": "1. Numbered\r2. List\r",
            "wrap": true
        },
        {
            "type": "TextBlock",
            "text": "Check out [Adaptive Cards](https://adaptivecards.io)"
        }
    ]
}

Адаптивные карточки поддерживают эмодзи. В следующем коде показан пример адаптивных карточек с эмодзи:

{ "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "type": "AdaptiveCard", "version": "1.0", "body": [ { "type": "Container", "items": [ { "type": "TextBlock", "text": "Publish Adaptive Card with emojis 🥰 ", "weight": "bolder", "size": "medium" }, ] }, ], }

Примечание.

Если вы используете REST API, задайте charset=UTF-8 в заголовках запроса эмодзи для добавления эмодзи в адаптивных карточках.

Поддержка упоминаний в адаптивных карточках

Вы можете добавить @mentions в текст адаптивной карточки для ботов и ответов расширения сообщений. Чтобы добавить @mentions карточки, следуйте той же логике уведомлений и отрисовке, что и для упоминаний на основе сообщений в беседах в канале и групповых чатах.

Боты и расширения для обмена сообщениями могут включать упоминания в содержимом карточки в элементах TextBlock и FactSet.

Примечание.

Элементы мультимедиа не поддерживаются в адаптивных карточках на платформе Teams.
Упоминания о каналах и командах не поддерживаются в сообщениях бота.
Вы можете @mention использовать несколько пользователей в одном сообщении адаптивной карточки, однако убедитесь, что размер сообщения не превышает 28 КБ для входящих веб-перехватчиков и 40 КБ для сообщения бота.
Адаптивные карточки, отправленные из входящих веб-перехватчиков, поддерживают только упоминания пользователей и не поддерживают упоминания ботов.

Чтобы включить упоминание в адаптивную карточку, ваше приложение должно содержать следующие элементы:

<at>username</at> в поддерживаемых элементах адаптивной карточки.
Объект mention в свойстве msteams в содержимом карточки включает ИД пользователя Teams упоминаемого пользователя.
userId является уникальным для идентификатора бота и определенного пользователя. Его можно использовать для @mention определенного пользователя. userId можно получить с помощью одного из параметров, указанных в разделе Получение ИД пользователя.

Пример адаптивной карточки с упоминанием

В следующем коде показан пример адаптивной карточки с упоминанием:

{
  "contentType": "application/vnd.microsoft.card.adaptive",
  "content": {
    "type": "AdaptiveCard",
    "body": [
      {
        "type": "TextBlock",
        "text": "Hi <at>John Doe</at>"
      }
    ],
    "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1.0",
    "msteams": {
      "entities": [
        {
          "type": "mention",
          "text": "<at>John Doe</at>",
          "mentioned": {
            "id": "29:123124124124",
            "name": "John Doe"
          }
        }
      ]
    }
  }
}

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

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

В таблице ниже описываются идентификаторы упоминаний пользователей, которые поддерживаются с недавнего времени:

Идентификаторы	Вспомогательные возможности	Описание	Пример
идентификатор объекта Microsoft Entra	Бот, соединитель	Microsoft Entra идентификатор объекта пользователя	49c4641c-ab91-4248-aebb-6a7de286397b
Имя участника-пользователя	Бот, соединитель	Microsoft Entra имени участника-пользователя	`john.smith@microsoft.com`

Упоминание пользователей в ботах с адаптивными карточками

Боты поддерживают упоминание пользователей с идентификатором объекта Microsoft Entra и имени участника-пользователя в дополнение к существующим идентификаторам. Поддержка двух новых идентификаторов доступна в ботах для текстовых сообщений, текстах адаптивных карточек и ответах расширения для обмена сообщениями. Боты поддерживают идентификаторы упоминаний в беседе и сценариях invoke. Пользователь получает уведомление веб-канала действий при наличии @mentioned идентификаторов.

Примечание.

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

Пример

Пример упоминания пользователей в ботах с адаптивными карточками:

{
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "version": "1.0",
  "type": "AdaptiveCard",
  "body": [
    {
      "type": "TextBlock",
      "text": "Hi <at>Adele UPN</at>, <at>Adele Microsoft Entra ID</at>"
    }
  ],
  "msteams": {
    "entities": [
      {
        "type": "mention",
        "text": "<at>Adele UPN</at>",
        "mentioned": {
          "id": "AdeleV@contoso.onmicrosoft.com",
          "name": "Adele Vance"
        }
      },
      {
        "type": "mention",
        "text": "<at>Adele Microsoft Entra ID</at>",
        "mentioned": {
          "id": "87d349ed-44d7-43e1-9a83-5f2406dee5bd",
          "name": "Adele Vance"
        }
      }
    ]
  }
}

На изображении ниже показано упоминание пользователя в адаптивной карточке в боте:

Снимок экрана: пользователь упоминание в боте с адаптивной карточкой.

Упоминание пользователя во входящем веб-перехватчике с адаптивными карточками

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

Примечание.

Включите упоминание пользователей в схеме входящих веб-перехватчиков для поддержки Microsoft Entra идентификатора объекта и имени участника-пользователя.
Изменения пользовательского интерфейса и пользовательского интерфейса не требуются для упоминаний пользователей с идентификатором объекта Microsoft Entra и имени участника-пользователя.

Пример

Пример упоминания пользователя во входящем веб-перехватчике:

{
    "type": "message",
    "attachments": [
        {
        "contentType": "application/vnd.microsoft.card.adaptive",
        "content": {
            "type": "AdaptiveCard",
            "body": [
                {
                    "type": "TextBlock",
                    "size": "Medium",
                    "weight": "Bolder",
                    "text": "Sample Adaptive Card with User Mention"
                },
                {
                    "type": "TextBlock",
                    "text": "Hi <at>Adele UPN</at>, <at>Adele Microsoft Entra ID</at>"
                }
            ],
            "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
            "version": "1.0",
            "msteams": {
                "entities": [
                    {
                        "type": "mention",
                        "text": "<at>Adele UPN</at>",
                        "mentioned": {
                          "id": "AdeleV@contoso.onmicrosoft.com",
                          "name": "Adele Vance"
                        }
                      },
                      {
                        "type": "mention",
                        "text": "<at>Adele Microsoft Entra ID</at>",
                        "mentioned": {
                          "id": "87d349ed-44d7-43e1-9a83-5f2406dee5bd",
                          "name": "Adele Vance"
                        }
                      }
                ]
            }
        }
    }]
}

На изображении ниже показано упоминание пользователя во входящем веб-перехватчике:

Снимок экрана: пользователь упоминание во входящем веб-перехватчике.

значок Люди в адаптивной карточке

значок Люди помогает пользователям просматривать изображения пользователей в адаптивной карточке. Вы можете вставить изображение и применить все свойства, поддерживаемые к изображениям.

В адаптивной карточке поддерживаются два типа значков людей:

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

Следующий код JSON является примером карта Persona:

{
  "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
  "type": "AdaptiveCard",
  "version": "1.0.0",
  "body": [
{
      "type": "TextBlock",
      "text": "Persona",
      "weight": "bolder"
    },
    {
      "type": "Component",
      "name": "graph.microsoft.com/user",
      "view": "compact",
      "properties": {
        "id": "65f50003-e15d-434a-9e14-0fcfeb3d7817",
        "displayName": "Daniela Mandera",
        "userPrincipalName": "damandera@microsoft.com"
      }
    }
  ]
}

Набор пользователей. Если вы хотите отобразить несколько пользователей в адаптивной карточке, отображается только значок пользователей.

Следующий код JSON является примером набора persona:

{
  "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
  "type": "AdaptiveCard",
  "version": "1.0.0",
  "body": [
    {
      "type": "TextBlock",
      "text": "Persona Set",
      "weight": "bolder"
    },
    {
      "type": "Component",
      "name": "graph.microsoft.com/users",
      "view": "compact",
      "properties": {
        "users": [
          {
            "id": "65f50003-e15d-434a-9e14-0fcfeb3d7817",
            "displayName": "Daniela Mandera",
            "userPrincipalName": "damandera@microsoft.com"
          },
          {
            "id": "65f50003-e15d-434a-9e14-0fcfeb3d7817",
            "displayName": "Daniela Mandera",
            "userPrincipalName": "damandera@microsoft.com"
          }
        ]
      }
    }
  ]
}

Примечание.

Вы не можете настроить стиль Persona и Persona Set в адаптивной карточке.

На следующем рисунке показан пример значка людей в адаптивной карточке:

Параметры запроса

В следующей таблице перечислены параметры запроса:

Имя свойства	Описание
`type`	`component`
`name`	Используйте `graph.microsoft.com/users` для поиска всех участников в организации
`view`	`compact`
`properties`	Передается в шаблон компонента
`id`	МРТ пользователя
`displayName`	Имя пользователя
`userPrincipalName`	Имя участника учетной записи пользователя в Microsoft Entra ID

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

Бот может запрашивать список участников и их основные профили пользователей, включая идентификаторы пользователей Teams и Microsoft Entra сведения, такие как name, idи userPrincipalName. Дополнительные сведения см . в разделе Получение списка пользователей или профиля пользователя.

На следующих изображениях отображается значок людей в адаптивной карточке в классических и мобильных клиентах Teams:

Классический клиент:

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

Мобильный клиент

Когда пользователь выбирает значок людей, он отображает людей, карта этого пользователя.

Маскировка сведений в адаптивных карточках

Используйте свойство маскировки информации для маскировки определенных сведений, например пароля или конфиденциальной информации от пользователей, во входном элементе Input.Text адаптивной карточки.

Примечание.

Эта функция поддерживает только маскировку клиентской информации. Маскируемый текст ввода отправляется в виде открытого текста на адрес конечной точки HTTPS, указанный при настройке бота.

Чтобы замаскировать сведения в адаптивных карточках, добавьте style свойство в типinput.text и присвойте ей значение Пароль.

Пример адаптивной карточки со свойством маскировки

В следующем коде показан пример адаптивной карточки со свойством маскировки:

{
    "type": "Input.Text",
    "id": "secretThing",
    "style": "password",
},

На изображении ниже приводится пример маскировки сведений в адаптивных карточках:

Снимок экрана: представление сведений о маскировке в адаптивной карточке.

Полноширинная адаптивная карточка

Свойство можно использовать для msteams расширения ширины адаптивной карточки и использования дополнительного пространства на холсте. В следующем разделе приводятся сведения об использовании этого свойства.

Примечание.

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

Создание полноширинных карточек

Чтобы создать полноширинную адаптивную карточку, для объекта width в свойстве msteams в содержимом карточки необходимо задать значение Full.

Пример полноширинной адаптивной карточки

Чтобы создать полноширинную адаптивную карточку, приложение должно включать элементы из следующего примера кода:

{
    "type": "AdaptiveCard",
    "body": [{
        "type": "Container",
        "items": [{
            "type": "TextBlock",
            "text": "Digest card",
            "size": "Large",
            "weight": "Bolder"
        }]
    }],

    "msteams": {
        "width": "Full"
    },
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1.2"
}

На изображении ниже показана полноширинная адаптивная карточка:

Снимок экрана: полноширинная адаптивная карточка.

На следующем рисунке показано представление адаптивной карточки по умолчанию, если для свойства не задано width значение Full.

Снимок экрана: адаптивная карточка небольшой ширины.

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

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

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

Разработка адаптивных карточек

targetWidth Используйте свойство для любого элемента, чтобы:

Отображение или скрытие любого элемента в зависимости от ширины карта.

Задайте разные целевые ширины для разных элементов, чтобы создать разные макеты.

В следующей таблице перечислены доступные targetWidth значения.

Значение	Описание
`veryNarrow`	Элемент отображается, когда ширина адаптивной карточки очень узкая, например в чате собрания.
`narrow`	Элемент отображается, когда ширина адаптивной карточки узкая, например на мобильном телефоне в книжном режиме.
`standard`	Элемент отображается, когда ширина адаптивной карточки стандартна, например на мобильном телефоне в альбомном режиме, на планшете в книжном режиме или в чате на рабочем столе.
`wide`	Элемент отображается, когда ширина адаптивной карточки широка, например на планшете в альбомном режиме, в канале или чате на рабочем столе при настройке карта полной ширины.

Вы также можете задать targetWidth свойство , чтобы сделать элемент видимым для диапазона карта ширины с помощью atLeast префиксов и atMost . Например, элемент можно сделать видимым только в том случае, если ширина карта " стандартная или выше" или только в том случае, если ширина карта "узкая или ниже". В следующей таблице приведены рекомендации по обеспечению видимости элемента для диапазона карта ширины:

Пример	Описание
`"targetWidth": "atLeast:standard"`	Элемент отображается только в том случае, если ширина адаптивной карточки по крайней мере стандартна, что означает стандартную или широкую.
`"targetWidth": "atMost:narrow"`	Элемент отображается только в том случае, если ширина адаптивной карточки не более узкая, то есть очень узкая или узкая.

Примечание.

Вам не нужно задавать для targetWidth всех элементов. Если для элемента не задано targetWidth значение, элемент всегда отображается независимо от ширины карта.

Ниже приведены примеры JSON для адаптивной карточки, разработанной без использования targetWidth и измененной для использованияtargetWidth:

Адаптивная карточка, разработанная без использования targetWidth:

{
  "type": "AdaptiveCard",
  "body": [
    {
      "type": "ColumnSet",
      "columns": [
        {
          "type": "Column",
          "items": [
            {
              "type": "Image",
              "style": "Person",
              "url": "https://aka.ms/AAp9xo4",
              "size": "Small"
            }
          ],
          "width": "auto"
        },
        {
          "type": "Column",
          "spacing": "medium",
          "verticalContentAlignment": "center",
          "items": [
            {
              "type": "TextBlock",
              "weight": "Bolder",
              "text": "David Claux",
              "wrap": true
            }
          ],
          "width": "auto"
        },
        {
          "type": "Column",
          "spacing": "medium",
          "items": [
            {
              "type": "TextBlock",
              "text": "Platform Architect",
              "isSubtle": true,
              "wrap": true
            }
          ],
          "width": "stretch",
          "verticalContentAlignment": "center"
        }
      ]
    }
  ],
  "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
  "version": "1.5"
}

На следующих изображениях показана отрисовка адаптивной карточки для разных карта ширины:

Если ширина карта широка, карта выглядит хорошо.
Если ширина карта является стандартной или узкой, роль сжимается.
Когда ширина карта очень узкая, имя и роль значительно сжимаются.

Адаптивная карточка обновлена для быстрого реагирования с помощью targetWidth:

  {
    "type": "AdaptiveCard",
    "body": [
      {
        "type": "ColumnSet",
        "columns": [
          {
            "type": "Column",
            "targetWidth": "atLeast:narrow",
            "items": [
              {
                "type": "Image",
                "style": "Person",
                "url": "https://aka.ms/AAp9xo4",
                "size": "Small"
              }
            ],
            "width": "auto"
          },
          {
            "type": "Column",
            "spacing": "medium",
            "verticalContentAlignment": "center",
            "items": [
              {
                "type": "TextBlock",
                "weight": "Bolder",
                "text": "David Claux",
                "wrap": true
              },
              {
                "type": "TextBlock",
                "targetWidth": "atMost:narrow",
                "spacing": "None",
                "text": "Platform Architect",
                "isSubtle": true,
                "wrap": true
              }
            ],
            "width": "auto"
          },
          {
            "type": "Column",
            "targetWidth": "atLeast:standard",
            "spacing": "medium",
            "items": [
              {
                "type": "TextBlock",
                "text": "Platform Architect",
                "isSubtle": true,
                "wrap": true
              }
            ],
            "width": "stretch",
            "verticalContentAlignment": "center"
          }
        ]
      }
    ],
    "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1.5"
  }

Давайте посмотрим, как отрисовывается одна и та же адаптивная карточка targetWidth после использования свойства для разных карта ширины:

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

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

Поддержка опережающего ввода

В элементе схемы Input.Choiceset фильтрация многочисленных вариантов и выбор подходящего пользователями может значительно замедлить выполнение задачи. Поддержка опережающего ввода в адаптивных карточках может упростить выбор, сужая или фильтруя варианты ввода при наборе входных данных пользователем.

Чтобы включить опережающий ввод в Input.Choiceset, задайте для style значение filtered и убедитесь, что для isMultiSelect задано значение false.

Пример адаптивной карточки с поддержкой опережающего ввода

В следующем коде показан пример адаптивной карточки с поддержкой опережающего ввода:

{
   "type": "Input.ChoiceSet",
   "label": "Select a user",
   "isMultiSelect": false,
   "choices":  [
      { "title": "User 1", "value": "User1" },
      { "title": "User 2", "value": "User2" }
    ],
   "style": "filtered"
}

Представление сцены для изображений в адаптивных карточках

В адаптивной карточке msteams можно использовать свойство , чтобы добавить возможность выборочного отображения изображений в Stageview. При наведении курсора на изображения пользователи могут видеть значок "Развернуть", для которого атрибут allowExpand имеет значение true. Следующий код является примером msteams свойства:

{
    "type": "AdaptiveCard",
     "body": [
          {
            "type": "Image",
            "url": "https://picsum.photos/200/200?image=110",
            "msTeams": {
              "allowExpand": true
            }
          }
     ],
    "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
    "version": "1.2"
}

При наведении указателя мыши на изображение в правом верхнем углу отображается значок развертывания, как показано на следующем рисунке:

Изображение появляется в Stageview, когда пользователь выбирает значок развертывания, как показано на следующем рисунке:

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

Примечание.

Возможность увеличения и уменьшения применяется только к элементам изображения типа изображения в адаптивной карточке.
Для мобильных приложений Teams функция Stageview для изображений в адаптивных карточках доступна по умолчанию. Пользователи могут просматривать изображения адаптивных карточек в Stageview, просто касаясь изображения, независимо от того, присутствует ли allowExpand атрибут или нет.

Карточки соединителей поддерживают ограниченное форматирование Markdown и HTML.

Style	Пример	Markdown
Полужирный	text	`text`
Курсив	text	`text`
Заголовок (уровни 1–3)	Text	`### Text`
Зачеркнутый	~~text~~	`~~text~~`
Неупорядоченный список	текст текст	`- Item 1\r- Item 2\r- Item 3`
Упорядоченный список	текст текст	`1. Green\r2. Orange\r3. Blue`
Предварительно отформатированный текст	`text`	`preformatted text`
Цитата	>Текст blockquote	`>blockquote text`
Hyperlink	Bing	`[Bing](https://www.bing.com/)`
Ссылка на изображение		`![Duck](https://aka.ms/Fo983c)`

В карточках соединителей новые строки не отображаются для \n или \r, но отображаются для \n\n.

Различия, связанные с карточками соединителей, в классической и мобильной версиях

В классической версии форматирование Markdown для карточек соединителей отображается следующим образом:

Снимок экрана: форматирование Markdown для карт соединителей.

В iOS форматирование Markdown для карточек соединителей отображается следующим образом:

Снимок экрана: форматирование Markdown для карточек соединителя в клиенте Teams для iOS.

С карточками соединителей, использующими Markdown для iOS, возникают следующие проблемы:

Клиент iOS для Teams не отображает встроенные изображения Markdown или HTML на карточках соединителя.
Цитаты отображаются с отступом, но без серого фона.

В Android форматирование Markdown для карточек соединителей отображается следующим образом:

Снимок экрана: форматирование Markdown для карточек соединителя в клиенте Teams Для Android.

Пример форматирования для карточек соединителей Markdown

В следующем коде показан пример форматирования для карточек соединителей Markdown:

{
  "contentType": "application/vnd.microsoft.teams.card.o365connector",
  "content": {
    "@type": "MessageCard",
    "@context": "https://schema.org/extensions",
    "summary": "Summary",
    "title": "Connector Card Markdown formatting",
    "sections": [
        {
            "text": "This is some **bold** text"
        },
        {
            "text": "This is some _italic_ text"
        },
        {
            "text": "# Header 1\r## Header 2\r### Header 3"
        },
        {
            "text": "- Bullet \r- List \r"
        },
        {
            "text": "1. Numbered\r1. List \r"
        },
        {
            "text": "Link: [Bing](https://www.bing.com)"
        },
        {
            "text": "embedded image link: ![Duck on a rock](https://aka.ms/Fo983c)"
        },
        {
            "text": "`preformatted text`"
        },
        {
            "text": "Newlines (backslash n, backslash n):\n\nline a\n\nline b\n\nline c"
        },
        {
            "text": ">This is a blockquote"
        }
     ]
  }
}

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

Элемент CodeBlock позволяет делиться фрагментами кода в виде форматированных адаптивных карточек в чатах, каналах и собраниях Teams. Адаптивные карточки с элементом CodeBlock упрощают чтение фрагмента кода, так как отступ, нумерация и выделение синтаксиса соответствуют языку программирования. Кроме того, вы можете добавить кнопки действий для просмотра кода в его источнике или изменения кода в интегрированных средах разработки (ИНД), таких как Microsoft Visual Studio или Microsoft Visual Studio Code.

На следующем снимку экрана показана адаптивная карточка с фрагментом кода:

Снимок экрана: адаптивная карточка с фрагментом кода.

Элемент CodeBlock поддерживает следующие языки:

Язык	Поддерживается	Язык	Поддерживается
Bash	✔️	JSON	✔️
В	✔️	Perl	✔️
C++	✔️	PHP	✔️
C#	✔️	PowerShell	✔️
CSS	✔️	Python	✔️
DOS	✔️	SQL	✔️
Go	✔️	TypeScript	✔️
GraphQL	✔️	Visual Basic	✔️
HTML	✔️	Verilog	✔️
Java	✔️	VHDL	✔️
JavaScript	✔️	XML	✔️

Примечание.

Элемент CodeBlock распознает обычный текст как язык, если в свойстве language схемы задано значение PlainText перечисления.

Ниже приведен пример адаптивной карточки, отображающей фрагмент кода:

{
    "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
    "type": "AdaptiveCard",
    "version": "1.5",
    "body": [
        {
            "type": "TextBlock",
            "text": "editor.js",
            "style": "heading"
        },
        {
            "type": "TextBlock",
            "text": "Lines 61 - 76"
        },
        {
            "type": "CodeBlock",
            "codeSnippet": "/**\n* @author John Smith <john.smith@example.com>\n*/\npackage l2f.gameserver.model;\n\npublic abstract strictfp class L2Char extends L2Object {\n  public static final Short ERROR = 0x0001;\n\n  public void moveTo(int x, int y, int z) {\n    _ai = null;\n    log(\"Shouldn't be called\");\n    if (1 > 5) { // what!?\n      return;\n    }\n  }\n}",
            "language": "java",
            "startLineNumber": 61
        }
    ],
    "actions": [
        {
            "type": "Action.OpenUrl",
            "title": "View in Azure Repos",
            "url": "https://azure.microsoft.com/en-us/products/devops/repos/"
        },
        {
            "type": "Action.OpenUrl",
            "title": "Edit in vscode.dev",
            "url": "https://vscode.dev/"
        }
    ]
}

Элемент CodeBlock поддерживает следующие свойства:

Свойство	Тип	Обязательный	Описание
`codeSnippet`	String	Да	Фрагмент кода, отображаемый в адаптивной карточке.
`language`	Перечисление	Да	Язык фрагмента кода, отображаемого в адаптивной карточке.
`startLineNumber`	Номер	Нет	Номер строки в источнике, с которого начинается фрагмент кода. Если оставить пустым, по умолчанию используется значение 1.

Совет

Специальные символы имеют определенные функции в свойстве codeSnippet . Например, символ \n новой строки активирует разрыв строки.
Чтобы отобразить символ \n новой строки как часть фрагмента кода в адаптивной карточке, убедитесь, что он экранироваться как \\n в свойстве codeSnippet . В противном случае Teams отрисовывает код после в \n следующей строке карта.

Ограничения

Адаптивная карточка с элементом CodeBlock поддерживается только в веб- и классических клиентах Teams.
Фрагмент кода в адаптивной карточке доступен только для чтения и не может быть редактируемым.
Адаптивная карточка просматривает только первые 10 строк фрагмента кода. Если содержится более 10 строк кода, пользователь должен нажать кнопку Развернуть , чтобы просмотреть остальную часть фрагмента кода.

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

Действия. В действиях основные кнопки отображаются на адаптивной карточке, а вторичные кнопки находятся в меню переполнения.
ActionSet: ActionSet — это сочетание нескольких действий в адаптивной карточке. Каждый набор действий может иметь меню переполнения.

Примечание.

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

Чтобы включить меню переполнения mode , настройте свойство со значением primary или secondary в схеме адаптивной карточки. В следующей таблице описано mode свойство :

Свойство	Тип	Обязательный	Описание
`mode`	Перечисление (основной, вторичный)	Нет	Является ли действие основным или дополнительным действием. Дополнительные действия сворачиваются в меню переполнения.

В следующем примере показано mode свойство в типе actions и элементе ActionSet :

Действия

В следующем примере есть два основных и одно дополнительное действие. Дополнительное действие создает меню переполнения.

{
   "type": "AdaptiveCard",
   "actions": [
        {
            "type": "Action.Submit",
            "title": "Set due date"
        },
        {
            "type": "Action.OpenUrl",
            "title": "View",
            "url": "https://adaptivecards.io"
        },
        {
            "type": "Action.Submit",
            "title": "Delete",
            "mode": "secondary"
        }
    ]
}

Примечание.

Меню переполнения работает по-разному на боте, отправленном карта, и расширение сообщения карта для корневого уровня actions в адаптивной карточке. Меню переполнения на боте, отправленном карта, отображается как всплывающее контекстное меню, а в расширении сообщения карта оно отображается в правом верхнем углу под значком Дополнительные параметры (...). Поведение не применимо к в адаптивной карточке ActionSet .

На следующем рисунке показан пример меню переполнения в карта, отправленном ботом, и расширение сообщения карта:

Набор действий

В следующем примере все действия помечаются как вторичные, поэтому на карта появляется одно меню переполнения.

{
    "type": "ActionSet",
     "actions": [

          {
           
            "type": "Action.Submit",
            "title": "view",
            "mode": "Secondary" 
       {
       },
            "type": "Action.submit",
            "title": "Delete",
            "mode": "secondary"

       },
       {
             "type": "Action.submit",
            "title": "Delete",
            "mode": "secondary"
       }
     ]
}

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

Компьютер
Мобильные устройства

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

Снимок экрана: пример кнопок в адаптивной карточке в классическом клиенте Teams.

Снимок экрана: пример адаптивной карточки со списком действий в меню переполнения в классическом клиенте Teams.

Форматирование карточек с помощью HTML

Следующие типы карточек поддерживают форматирование HTML в Teams:

Карточки соединителей для Группы Microsoft 365. В карта соединителя для Группы Microsoft 365 поддерживается ограниченное форматирование Markdown и HTML.
Карточки эскизов и главного имиджевого баннера: HTML-теги поддерживаются для простых карточек, таких как карточки эскизов и главного имиджевого баннера.

Форматирование различается в классической и мобильной версиях Teams для карточек соединителей для Группы Microsoft 365 и простых карточек. В этом разделе можно ознакомиться с примером форматирования HTML для карточек соединителей и простых карточек.

Формат HTML для карточек соединителей для Группы Microsoft 365
Форматирование HTML для карточек эскизов и главного имиджевого баннера

Карточки соединителей поддерживают ограниченное форматирование Markdown и HTML.

Style	Пример	HTML
Полужирный	text	`<strong>text</strong>`
Курсив	text	`<em>text</em>`
Заголовок (уровни 1–3)	Text	`<h3>Text</h3>`
Зачеркнутый	~~text~~	`<strike>text</strike>`
Неупорядоченный список	текст текст	`<ul><li>text</li><li>text</li></ul>`
Упорядоченный список	текст текст	`<ol><li>text</li><li>text</li></ol>`
Предварительно отформатированный текст	`text`	`<pre>text</pre>`
Цитата	текст	`<blockquote>text</blockquote>`
Hyperlink	Bing	`<a href="https://www.bing.com/">Bing</a>`
Ссылка на изображение		`<img src="https://aka.ms/Fo983c" alt="Duck on a rock"></img>`

В карточках соединителей новые строки отображаются в HTML с помощью тега <p>.

Различия, связанные с карточками соединителей, в классической и мобильной версиях

В классической версии форматирование HTML для карточек соединителей отображается следующим образом:

Снимок экрана: форматирование HTML для карточек соединителей в классическом клиенте.

В iOS форматирование HTML отображается следующим образом:

Снимок экрана: форматирование HTML для карточек соединителей в клиенте iOS.

С карточками соединителей, использующими HTML для iOS, возникают следующие проблемы:

Встроенные изображения не отображаются в iOS с помощью Markdown или HTML в карточках соединителя.
Предварительно отформатированный текст отображается, но не имеет серого фона.

В Android форматирование HTML отображается следующим образом:

Снимок экрана: форматирование HTML для карточек соединителей в клиенте Android.

Пример форматирования для карточек соединителей HTML

В следующем коде показан пример форматирования для карточек соединителей HTML:

{
  "contentType": "application/vnd.microsoft.teams.card.o365connector",
  "content": {
    "@type": "MessageCard",
    "@context": "https://schema.org/extensions",
    "summary": "Summary",
    "title": "Connector Card HTML formatting",
    "sections": [
        {
            "text": "This is some <strong>bold</strong> text"
        },
        {
            "text": "This is some <em>italic</em> text"
        },
        {
            "text": "This is some <strike>strikethrough</strike> text"
        },
        {
            "text": "<h1>Header 1</h1>\r<h2>Header 2</h2>\r <h3>Header 3</h3>"
        },
        {
            "text": "bullet list <ul><li>text</li><li>text</li></ul>"
        },
        {
            "text": "ordered list <ol><li>text</li><li>text</li></ol>"
        },
        {
            "text": "hyperlink <a href=\"https://www.bing.com/\">Bing</a>"
        },
        {
            "text": "embedded image <img src=\"https://aka.ms/Fo983c\" alt=\"Duck on a rock\"></img>"
        },
        {
            "text": "preformatted text <pre>text</pre>"
        },
        {
            "text": "Paragraphs <p>Line a</p><p>Line b</p>"
        },
        {
            "text": "<blockquote>Blockquote text</blockquote>"
        }
     ]
  }
}

HTML-теги поддерживаются для простых карточек, таких как карточки эскизов и главного имиджевого баннера. Markdown не поддерживается.

Style	Пример	HTML
Полужирный	text	`<strong>text</strong>`
Курсив	text	`<em>text</em>`
Заголовок (уровни 1–3)	Text	`<h3>Text</h3>`
Зачеркнутый	~~text~~	`<strike>text</strike>`
Неупорядоченный список	текст текст	`<ul><li>text</li><li>text</li></ul>`
Упорядоченный список	текст текст	`<ol><li>text</li><li>text</li></ol>`
Предварительно отформатированный текст	`text`	`<pre>text</pre>`
Цитата	текст	`<blockquote>text</blockquote>`
Hyperlink	Bing	`<a href="https://www.bing.com/">Bing</a>`
Ссылка на изображение		`<img src="https://aka.ms/Fo983c" alt="Duck on a rock"></img>`

Различия, связанные с простыми карточками, в классической и мобильной версиях

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

В классической версии форматирование HTML отображается следующим образом:

Снимок экрана: форматирование HTML в классическом клиенте.

В iOS форматирование HTML отображается следующим образом:

Снимок экрана: форматирование HTML в клиенте iOS.

Форматирование символов, например полужирное и курсивное, не отображается в iOS.

В Android форматирование HTML отображается следующим образом:

Снимок экрана: форматирование HTML в клиенте Android.

Форматирование символов, например полужирное и курсивное, правильно отображается в Android.

Пример форматирования для простых карточек

Изображения в предыдущем разделе созданы с использованием Teams App Studio, где свойство текста карточки главного имиджевого баннера задано следующей строкой:

<p>bold: <strong>Bold Text</strong></p><p>italic: <em>Italic Text</em></p><p>strikethrough: <strike>Strikethrough text</strike></p><h1>Header 1</h1><h2>Header 2</h2><h3>Header 3</h3><p>bullet list: <ul><li>text</li><li>text</li></ul></p><p>ordered list: <ol><li>text</li><li>text</li></ol></p><pre>preformatted text</pre><blockquote>blockquote text</blockquote></p><p>hyperlink: <a href=\"https://www.bing.com/\">Bing</a></p><p>embedded image: <img src=\"https://aka.ms/Fo983c\" alt=\"Duck on a rock\"></img></p>

Вы можете проверить форматирование в своих карточках, изменяя этот код.

Примеры кода

S.No.	Описание	.NET	Node.js	Манифест
1	В этом примере приложения показаны различные форматы карта, поддерживаемые в Teams.	Просмотр	Просмотр	Просмотр

Форматирование карточек в Teams

Форматирование карточек с помощью Markdown

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

Различия, связанные с адаптивными карточками, в классической и мобильной версиях

Пример форматирования адаптивных карточек

Поддержка упоминаний в адаптивных карточках

Пример адаптивной карточки с упоминанием

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

Упоминание пользователей в ботах с адаптивными карточками

Пример

Упоминание пользователя во входящем веб-перехватчике с адаптивными карточками

Пример

значок Люди в адаптивной карточке

Параметры запроса

Маскировка сведений в адаптивных карточках

Пример адаптивной карточки со свойством маскировки

Полноширинная адаптивная карточка

Создание полноширинных карточек

Пример полноширинной адаптивной карточки

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

Разработка адаптивных карточек

Поддержка опережающего ввода

Пример адаптивной карточки с поддержкой опережающего ввода

Представление сцены для изображений в адаптивных карточках

Различия, связанные с карточками соединителей, в классической и мобильной версиях

Пример форматирования для карточек соединителей Markdown

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

Ограничения

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

Меню "Включить переполнение"

Форматирование карточек с помощью HTML

Различия, связанные с карточками соединителей, в классической и мобильной версиях

Пример форматирования для карточек соединителей HTML

Различия, связанные с простыми карточками, в классической и мобильной версиях

Пример форматирования для простых карточек

Примеры кода

См. также

Обратная связь

Дополнительные ресурсы