Um complemento baseado em cards aparece como um painel na barra lateral (ou, em dispositivos móveis, como outro
janela de atividade acessada pelo menu). O complemento tem uma barra de ferramentas na parte de cima
identifica o complemento e exibe um card, que é uma página da
na interface do usuário do complemento. O Apps Script representa cards no código do projeto usando
Objetos Card.
Anatomia do cartão
Um card é um grupo de elementos de interface que você projeta. Um cartão é composto pelo seguinte: seções a seguir:
- Cabeçalho do cartão. Isso identifica os cards. Ele contém o texto do título e pode podem ter um subtítulo e um ícone.
Uma ou mais seções do card. Essas são subdivisões da área da interface do cartão. Opcionalmente, uma seção pode ter um cabeçalho de seção de texto. As seções são separadas umas das outras no card por uma regra horizontal. Se uma seção de cartão for particularmente grande, ela será automaticamente renderizada como um 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, e ter apenas alguns para um melhor desempenho.
Cada seção do card contém uma ou mais interfaces widgets. Os widgets oferecem ao usuário informações ou controles interativos. Cards e seções de cards são estruturais, então não é possível adicioná-los a uma seção de cards. Um cartão pode ter no máximo 100 widgets, e deve ser o mais simples possível para garantir o melhor desempenho.
Crie cards relacionados a atividades do usuário ou conjuntos de dados específicos. Para exemplo, um complemento do Google Workspace que exibe dados das Planilhas Google podem ter um cartão separado para cada folha extraído dados.
Como usar vários cartões
Os complementos geralmente consistem em mais de um cartão. É possível configurar como uma lista simples para navegação básica com vários cards, ou configurar camadas mais complexas métodos de navegação para controlar como o usuário navega entre os cards.
Se o complemento usar navegação básica, quando o for aberto pela primeira vez aplicativo do Google Workspace, ele constrói uma lista de cabeçalhos do cartão e apresenta-os ao usuário. Clicando no card cabeçalho abre o cartão. Uma seta "Voltar" também é exibida para voltar ao card. lista de cabeçalhos. Não é necessário codificar o cabeçalho e a seta para trás personalizada. Isso é feito automaticamente quando você define os cards em seu .
Ao projetar complementos, é melhor limitar o número de cards são exibidos de uma vez, já que os cards precisam compartilhar uma quantidade limitada de espaço na tela. Também é melhor evitar complexidade desnecessária nos cards.