Cartões

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 de cima que identifica o complemento e mostra um card, que é essencialmente uma "página" da IU do complemento. O Apps Script representa cards no código do projeto usando objetos Card.

Anatomia do cartão

Exemplo de cartão de complemento

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

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

  • Cada seção do card contém um ou mais widgets de IU. Os widgets fornecem ao usuário informações ou controles interativos. As seções e os cards são widgets estruturais. Portanto, não é possível adicioná-los a uma seção de cards. Uma seção de card pode ter no máximo 100 widgets e precisa ser a mais simples possível para ter o melhor desempenho.

Crie cards com atividades específicas do usuário ou conjuntos de dados. Por exemplo, um complemento do Google Workspace que exibe dados retirados das Planilhas Google pode ter um card separado para cada página de onde os dados são extraídos.

Como usar vários cartões

Exemplo de cartão de complemento

Os complementos geralmente consistem em mais de um card. Você pode configurar esses cards como uma lista simples para navegação básica com vários cartões ou configurar métodos de navegação mais complexos para controlar como o usuário se move entre os cards.

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

Ao criar complementos, é melhor limitar o número de cards que você mostra de uma só vez, já que eles precisam compartilhar uma quantidade limitada de espaço na tela. Também é melhor evitar complexidades desnecessária nos cards.