Cartões

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 o identifica 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 Card objetos.

Anatomia do card

Exemplo de um cartão complementar mostrando detalhes de contato

Um card é um grupo de elementos de interface que você cria. Ele consiste nas seguintes seções:

  • Um cabeçalho de card. Isso identifica os cards. Ele tem um texto de título e, opcionalmente, 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 texto. As seções de card são separadas umas das outras por uma regra 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 expandir ou recolher conforme necessário. Um card pode ter no máximo 100 seções, e apenas algumas para melhorar a performance.

  • Cada seção de card contém um ou mais UI widgets. Os widgets fornecem informações ou controles interativos ao usuário. Cards e seções de card são widgets estruturais, então não é possível adicioná-los a uma seção de card. Uma seção de card pode ter no máximo 100 widgets, e precisa ser o mais concisa possível para melhor performance.

Você precisa criar 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 do Google Sheets pode ter um card separado para cada planilha de que extrai dados.

Usar vários cards

Exemplo de card de complemento mostrando uma interface simples

Os complementos geralmente consistem em mais de um card. Você pode 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 usa a navegação básica, quando ele é aberto pela primeira vez, o aplicativo do Google Workspace que ele estende cria uma lista dos cabeçalhos dos cards e os apresenta ao usuário. Clicar no cabeçalho do card abre esse card. Uma seta para voltar também é fornecida para retornar à lista de cabeçalhos de cards. 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 criar complementos, é recomendável 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 é recomendável evitar complexidade desnecessária nos cards.

Por motivos de performance, não é possível adicionar mais de 100 widgets ou 100 seções de card a um card.