Compartilhar via

Cartões

  • Artigo

Um cartão é um contêiner de interface do usuário (UI) para obter informações curtas ou relacionadas. Os cartões podem ter várias propriedades e anexos e podem incluir botões que disparam ações de cartão. Ao usar os cartões, você pode organizar informações em grupos e dar aos usuários a oportunidade de interagirem com partes específicas das informações.

Os bots do Microsoft Teams suportam os seguintes tipos de cartões:

  • Cartão Adaptável
  • Cartão Hero
  • Cartão de listagem
  • Conector card para Grupos do Microsoft 365
  • Cartão de recebimento
  • Cartão de entrada
  • Cartão de miniatura
  • Coleções de cartões
  • Menu Overflow em Cartões Ajustáveis

Você pode adicionar a formatação Rich Text aos cartões usando Markdown ou HTML, dependendo do tipo de cartão. Cartões utilizados por bots e extensões de mensagens no Teams, adicione e responda a estas ações card, , , , e signininvoke. imBackmessageBackopenUrl

O Teams usa cartões em três locais diferentes:

  • Conectores
  • Bots
  • Extensões de mensagens

Cartões em conectores

Os cartões foram definidos pela primeira vez como parte do Outlook e do Microsoft 365 e são agora utilizados como parte dos conectores para Grupos do Microsoft 365. Tal como muitas aplicações do Microsoft 365, o Teams suporta conectores. Para obter mais informações, veja Criar conectores para Grupos do Microsoft 365. Você pode encontrar a especificação para cartões nos conectores em referência de cartão de mensagens acionáveis.

Cartões em bots

O Microsoft Bot Framework estende a especificação de cartões adicionando um conjunto de cartões predefinidos que os bots podem usar como parte das mensagens do bot. O Teams oferece suporte aos bots usando o Bot Framework, mas oferece suporte a um conjunto diferente dessas cartas. Informações gerais sobre cartões no Bot Framework podem ser encontradas em adicionar anexos de cartões avançados para mensagens. Esses cartões são chamados de cartões simples no Teams.

Os bots no Teams podem usar cartões simples, cartões de conector ou Cartões Adaptáveis. Os Tipos de cartões fornecem informações sobre cartões, com suporte dos bots no Teams.

Cartões em extensões de mensagem

As Extensões de mensagens também podem retornar um cartão. As extensões de mensagens podem usar cartões simples, cartões de conector ou Cartões Adaptáveis. Esses cartões são encontrados em tipos de cartões.

Tipos de cartões

Todos os cartões usados pelo Teams estão listados em tipos de cartões. Essa referência também descreve as diferenças entre cartões do Bot Framework e cartões no Teams.

Cartões Adaptáveis

Os Cartões Adaptáveis são uma nova especificação de produto cruzado de cartões nos produtos da Microsoft, incluindo bots, Cortana, Outlook e Windows. Eles são o tipo de cartão recomendado para o novo desenvolvimento do Teams. Para obter informações gerais da equipe dos Cartões Adaptáveis, consulte Visão geral dos Cartões Adaptáveis. Pode utilizar Cartões Ajustáveis em qualquer lugar onde utilize cartões de destaque existentes, cartões do Microsoft 365 e cartões de miniaturas.

Além dos Cartões Adaptáveis, o Teams oferece suporte a dois outros tipos de cartões:

  • Cartões de conector: utilizados como parte de conectores para Grupos do Microsoft 365.
  • Cartões simples: usados do Bot Framework, como os carões em miniatura e os cartões hero.

Seletor de Pessoas nos Cartões Adaptáveis

O Seletor de Pessoas adicionado como um controle de entrada nos Cartões Adaptáveis permite a pesquisa e seleção de pessoas. Pode utilizá-lo em chats, canais, caixas de diálogo (referidos como módulos de tarefas no TeamsJS v1.x) e separadores. Os clientes móveis e de área de trabalho suportam o Seletor de Pessoas que fornece uma experiência de digitação em linha.

Pessoas ícone num Cartão Ajustável

Pessoas ícone num Cartão Ajustável ajuda os utilizadores a ver as imagens dos utilizadores no Cartão Ajustável no Teams. Pode ver a imagem de um único utilizador ou de vários utilizadores. Pessoas ícone é suportado em clientes móveis e de ambiente de trabalho do Teams.

Pesquisa de preenchimento automático em cartões adaptáveis

A pesquisa typeahead adicionada como um controlo de entrada em Cartões Ajustáveis permite a experiência de pesquisa dinâmica a partir de um conjunto de dados carregado dinamicamente. Também permite que os utilizadores façam uma pesquisa estática typeahead numa lista com um número limitado de opções. Os clientes móveis e de ambiente de trabalho suportam a experiência de pesquisa dinâmica typeahead.

Entradas dependentes em Cartões Ajustáveis

Pode criar Cartões Ajustáveis no Teams onde o valor de uma entrada depende do valor de outro. Por exemplo, considere um Cartão Ajustável com dois Input.ChoiceSet menus pendentes: um para selecionar um país e outro para selecionar uma cidade específica nesse país. A primeira lista pendente tem de filtrar as cidades apresentadas na segunda lista pendente. Isto pode ser conseguido através da criação de uma lista Input.ChoiceSet pendente com uma pesquisa de cabeça de tipo dinâmica que depende de uma ou mais entradas no card. Para obter mais informações, veja entradas dependentes.

Elementos multimédia em Cartões Ajustáveis

Os elementos multimédia no Cartão Ajustável proporcionam uma experiência multimédia melhorada e aumentam a interação com o Cartão Ajustável. Pode adicionar ficheiros de multimédia, tais como clips de áudio ou vídeo, vídeos do YouTube, Vimeo ou Dailymotion ao seu Cartão Ajustável. Para obter mais informações, veja Elementos multimédia no Cartão Ajustável.

Cartões adaptáveis e Webhooks de entrada

Observação

Os Cartões Adaptáveis com Webhooks de Entrada permitem que você use os recursos avançados e flexíveis dos Cartões Adaptáveis. Ele envia dados usando os Webhooks de entrada no Teams do seu serviço Web.

CodeBlock em Cartões Ajustáveis

Partilhe fragmentos de código como Cartões Ajustáveis formatados em chats, canais e reuniões do Teams com o CodeBlock elemento . Os Cartões Adaptáveis com o CodeBlock elemento tornam o fragmento de código mais fácil de ler à medida que o avanço, a numeração e o realce da sintaxe correspondem à linguagem de programação. Para obter mais informações, veja CodeBlock em Cartões Ajustáveis.

Esquema reativo do Cartão Ajustável

Tem de estruturar os seus Cartões Ajustáveis para ter um ótimo aspeto em qualquer dispositivo para proporcionar uma experiência de utilizador melhorada em chat, canais e chat de reunião. O esquema reativo do Cartão Adaptável ajuda-o a estruturar cartões com esquemas diferentes que visam diferentes larguras de card. Para obter mais informações, veja Esquema reativo do Cartão Adaptável.

Limites e cantos arredondados

Pode adicionar limites aos Containerelementos , ColumnSet, Columne Table em Cartões Ajustáveis para delinear diferentes secções do card. Pode adicionar cantos arredondados aos Containerelementos , ColumnSet, Column, Tablee Image em Cartões Ajustáveis para que a estrutura do card pareça moderna e visualmente apelativa. Para obter mais informações, veja limites e cantos arredondados em Cartões Ajustáveis.

Contentores deslocáveis

Um contentor com muitos elementos pode levar a um card longo e ilegível. Utilize a maxHeight propriedade para definir a altura máxima do contentor. Quando o contentor tem uma altura máxima e o respetivo conteúdo excede essa altura, é apresentada uma barra de deslocamento vertical. Para obter mais informações, veja contentores deslocáveis em Cartões Ajustáveis.

Botão composto

O botão Composto é um tipo especial de botão com um ícone, título e descrição. Pode adicionar um botão Composto com o CompoundButton elemento . Este elemento permite-lhe replicar o aspeto dos iniciadores de pedidos num Cartão Ajustável. Para obter mais informações, veja Botão Composto em Cartões Ajustáveis.

Ícones fluentes

Os Cartões Ajustáveis suportam a adição de ícones da biblioteca de ícones Fluent com o Icon elemento . Para obter mais informações, veja ícones no Cartão Ajustável.

Classificações de estrelas

Pode adicionar uma entrada de classificação star ao seu Cartão Ajustável com o Input.Rating elemento . Também pode incluir uma classificação de star só de leitura com o Rating elemento . Para obter mais informações, veja classificações em Cartões Ajustáveis.

Ativação condicional de botões de ação

Pode utilizar a conditionallyEnabled propriedade para desativar os botões de ação até que o utilizador altere o valor de, pelo menos, uma das entradas necessárias. Esta propriedade só pode ser utilizada com Action.Submit e Action.Execute ações. Para obter mais informações, veja Ativação condicional de botões de ação.

Menu Overflow em Cartões Ajustáveis

O Cartão Ajustável no Teams suporta o menu de capacidade excedida. Pode preencher um menu de capacidade excedida para todas as ações secundárias num Cartão Ajustável.

Suporte para Microsoft Entra ID de Objeto e UPN no menção do utilizador

Os bots com Cartões Ajustáveis suportam IDs de menção de utilizador, como Microsoft Entra ID de Objeto e Nome principal de utilizador (UPN), além dos IDs existentes. Os Webhooks recebidos começam a suportar menção de utilizador no Cartão Ajustável com o ID de Objeto Microsoft Entra e UPN.

Gráficos em Cartões Ajustáveis

Os bots suportam IDs de menção de utilizador, como Microsoft Entra ID de Objeto e Nome do Principal de Utilizador (UPN), além dos IDs existentes. Os Webhooks recebidos começam a suportar menção de utilizador no Cartão Ajustável com o ID de Objeto Microsoft Entra e UPN.

Esquemas de contentor em Cartões Ajustáveis

Pode criar contentores reativos para diferentes larguras de Cartão Adaptável com os Layout.Stackesquemas , Layout.Flowe Layout.AreaGrid . Para obter mais informações, veja Esquemas de contentor.

Próxima etapa

Tipos de cartões

Confira também