Cartões

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Um complemento baseado em cartão 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 superior que identifica o complemento e exibe um card, essencialmente uma "quot;page"" da IU do complemento. O Apps Script representa cartões no código do projeto usando objetos Card.

Anatomia do cartão

Exemplo de card de complementos

Um card é um grupo de elementos da IU criados por você. Um card consiste nas seguintes seções:

  • Um cabeçalho de cartão. Isso identifica os cards. Ele tem texto de título e, opcionalmente, um subtítulo e um ícone.
  • Uma ou mais seções do card. Essas são subdivisões da área de IU do cartão. Uma seção pode também ter um cabeçalho de seção de texto. As seções do cartão são separadas umas das outras por uma regra horizontal. Se uma seção do cartão for particularmente grande, ela será renderizada automaticamente como 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 de cartão e precisa ter apenas algumas para melhorar o desempenho.

  • Cada seção do card contém um ou mais widgets de IU. Os widgets fornecem informações ou controles interativos ao usuário. Cartões e seções de cartões são widgets estruturais. Por isso, não é possível adicioná-los a uma seção de cartões. Uma seção de cartões pode ter no máximo 100 widgets e precisa ser o mais simples possível para ter o melhor desempenho.

Você precisa criar cards com base em atividades ou conjuntos de dados do usuário específicos. Por exemplo, um complemento do Google Workspace que exibe dados coletados do Planilhas Google pode ter um cartão separado para cada página de onde dados são extraídos.

Como usar vários cartões

Exemplo de card de complementos

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 vai ampliar a lista de cabeçalhos do cartão e apresentá-los ao usuário. Clique no cabeçalho do card para abri-lo. Uma seta para voltar também é fornecida para retornar à lista de cabeçalhos do card. Não é necessário codificar a funcionalidade de cabeçalho e seta para voltar. Isso é feito automaticamente quando você define os cards no complemento.

Ao criar complementos, é melhor limitar o número de cartões exibidos de uma só vez, já que os cartões precisam compartilhar uma quantidade limitada de espaço na tela. Também é melhor evitar complexidades desnecessárias em cards.