Cartões

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Um complemento baseado em cartão aparece como um painel na barra lateral ou, em dispositivos móveis, como outra janela de atividade acessada pelo menu. O complemento tem uma barra de ferramentas na parte superior que identifica o complemento e exibe um cartão, basicamente uma "página" da IU do complemento. O Apps Script representa cartões no código do projeto usando objetos Card.

Anatomia do cartão

Exemplo de card de complemento

Um card é um grupo de elementos de IU que você cria. Um cartão consiste nas seguintes seções:

  • Um cabeçalho de card. Isso identifica os cartões. Ele tem texto de título e, opcionalmente, um subtítulo e um ícone.
  • Uma ou mais seções de cards. Estas são subdivisões da área da IU do cartão. Uma seção pode conter um cabeçalho de seção de texto. As seções do cartão são separadas umas das outras por uma regra horizontal. Se uma seção do card for particularmente grande, ela vai ser renderizada automaticamente como uma seção recolhível que os usuários podem abrir ou fechar conforme necessário. Um cartão pode ter no máximo 100 seções e precisa ter apenas algumas para melhorar o desempenho.

  • Cada seção do card contém um ou mais widgets da IU. Os widgets oferecem ao usuário informações ou controles interativos. Cartões e seções de cartões são widgets estruturais, que não podem ser adicionados a uma seção de cartões. Uma seção de cards pode ter no máximo 100 widgets e precisa ser o mais simples possível para ter o melhor desempenho.

Projete os cards com base nas atividades específicas dos usuários ou em conjuntos de dados. Por exemplo, um complemento do Google Workspace que mostra dados coletados pelo Planilhas Google pode ter um card separado para cada página de que ele extrai dados.

Como usar vários cartões

Exemplo de card de complemento

Os complementos geralmente consistem em mais de um cartão. É possível configurar esses cartões como uma lista simples de navegação básica com vários cartões ou configurar métodos de navegação mais complexos para controlar a movimentação do usuário entre os cards.

Se o complemento usar a navegação básica, quando ele for aberto pela primeira vez, o aplicativo Google Workspace vai criar uma lista de cabeçalhos de cards e os apresentar ao usuário. Clique no cabeçalho do card para abri-lo. Uma seta para voltar também é fornecida para voltar à lista de cabeçalhos do cartão. Não é necessário codificar a funcionalidade do cabeçalho e da seta para voltar, isso é feito automaticamente quando você define os cards no complemento.

Ao projetar complementos, é melhor limitar o número de cartões exibidos de uma só vez, já que eles precisam compartilhar uma quantidade limitada de espaço na tela. Também é melhor evitar complexidades desnecessárias em cards.