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
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 exibe dados coletados pelo Planilhas Google pode ter um card separado para cada página de onde ele extrai dados.
Como usar vários cartões
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 o complemento for aberto pela primeira vez, o aplicativo Google Workspace vai criar uma lista de cabeçalhos do card 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.