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 mostra 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 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 texto opcional. As seções do card são separadas por uma linha horizontal. Se uma seção de cards 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 ao usuário informações ou controles interativos. Os cards e as 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 card pode ter no máximo 100 widgets e precisa ser o mais simples possível para ter 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 das Planilhas Google pode ter um card separado para cada planilha de onde ele extrai informações.
Como usar vários cards
Os complementos geralmente consistem em mais de um cartão. Você pode 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 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 do card abre o card. Uma seta para voltar também é fornecida para retornar à lista de cabeçalhos de cards. Não é preciso programar a funcionalidade do cabeçalho e da seta para trás. Isso é feito automaticamente quando você define os cards no complemento.
Ao criar complementos, é recomendável limitar o número de cards que você mostra de uma vez, já que eles precisam compartilhar uma quantidade limitada de espaço na tela. Também é melhor evitar complexidade desnecessária nos cards.