Um complemento do Google Workspace baseado em cards 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 é basicamente uma "página"
da interface do complemento. O Google Apps Script representa
cards no código do projeto usando objetos Card.
Anatomia do card
Um card é um grupo de elementos da interface do usuário que você cria. Um card consiste nas seguintes seções:
- Um cabeçalho de card. Isso identifica os cards. Ele tem um texto de título e pode ter um subtítulo e um ícone.
Uma ou mais seções de card. São subdivisões da área da interface do card. Uma seção pode ter um cabeçalho de seção de texto. As seções de cards são separadas umas das outras por uma linha horizontal. Se uma seção de card for muito grande, ela será renderizada automaticamente como uma seção recolhível que os usuários podem abrir ou fechar conforme necessário. Um card pode ter no máximo 100 seções, mas é recomendável ter apenas algumas para melhorar o desempenho.
Cada seção de card contém um ou mais widgets da interface. Os widgets oferecem informações ou controles interativos ao usuário. Os cards e as seções de cards são widgets estruturais. Por isso, 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 deve ser o mais concisa possível para garantir o melhor desempenho.
Crie cards com base em atividades ou conjuntos de dados específicos do usuário. Por exemplo, um complemento do Google Workspace que mostra dados do Google Planilhas pode ter um card separado para cada planilha de onde ele extrai informações.
Usar vários cards
Os complementos geralmente consistem em mais de um cartão. É possível configurar esses cards como uma lista para navegação básica ou configurar métodos de navegação mais complexos para controlar como o usuário se move entre os cards. Para mais detalhes, consulte navegação básica com vários cards.
Se o complemento usar a navegação básica, quando ele for aberto pela primeira vez, o aplicativo do Google Workspace que ele estende vai criar uma lista dos cabeçalhos dos cards e apresentá-los ao usuário. Clicar no cabeçalho abre o card. Uma seta para voltar também é fornecida para retornar à lista de cabeçalhos de cards. Não é necessário programar o cabeçalho e a funcionalidade de seta para trás. Isso é feito automaticamente quando você define os cards no complemento.
Ao criar complementos, é melhor limitar o número de cards exibidos de uma só vez, já que eles precisam compartilhar uma quantidade limitada de espaço na tela. Também é melhor evitar complexidade desnecessária nos cards.
Por motivos de desempenho, não é possível adicionar mais de 100 widgets ou 100 seções de card a um card.