Um complemento 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 exibe um card, que é basicamente uma "página" da
interface do complemento. O Apps Script representa cards no código do projeto usando objetos Card.
Anatomia do card
Um card é um grupo de elementos da interface que você projeta. 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 uma legenda e um ícone.
Uma ou mais seções de card. Essas 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 do card são separadas umas das outras por uma linha horizontal. Se uma seção de card for particularmente grande, ela será renderizada automaticamente como uma seção colapsável que os usuários podem abrir ou fechar conforme necessário. Um card pode ter até 100 seções e deve ter apenas algumas para melhorar o desempenho.
Cada seção de card contém um ou mais widgets de interface. Os widgets fornecem ao usuário informações ou controles interativos. Cards e seções de cards são widgets estruturais, então não é possível adicioná-los a uma seção de cards. Uma seção de cards pode ter no máximo 100 widgets e precisa ser o mais simples possível para ter a melhor performance.
Você deve projetar cards com base em atividades ou conjuntos de dados específicos do usuário. Por exemplo, um complemento do Google Workspace que mostra dados extraídos das Planilhas Google pode ter um card separado para cada planilha de onde ele extrai dados.
Usar vários cards
Os complementos geralmente consistem em mais de um cartão. É possível configurar esses cards como uma lista simples para navegação básica com vários cards ou configurar métodos de navegação mais complexos para controlar como o usuário se move entre os cards.
Se o complemento usa a navegação básica, quando ele é aberto pela primeira vez, o aplicativo Google Workspace cria uma lista dos cabeçalhos de cartão e os apresenta ao usuário. Clicar no cabeçalho do card abre esse card. Uma seta para voltar também é fornecida para voltar à lista de cabeçalhos do card. Não é necessário programar a funcionalidade do cabeçalho e da seta para voltar. Isso é feito automaticamente quando você define os cards no seu complemento.
Ao projetar complementos, é melhor limitar o número de cards exibidos de uma vez, já que eles precisam compartilhar uma quantidade limitada de espaço na tela. Também é melhor evitar complexidades desnecessárias nos cards.