Interfaces baseadas em cartão

Os complementos do Google Workspace são baseados em cards. Os complementos do editor são baseados em HTML.

Exemplo de uma interface de card de complemento do Google Workspace.

Os complementos apresentam informações e controles do usuário na barra lateral da interface do aplicativo host. Um complemento do Google Workspace consiste em uma barra de ferramentas de identificação principal e um ou mais cards.

Cada card representa uma "página" específica da interface do complemento. Para navegar até um novo card basta criar esse card e enviá-lo para uma pilha de cards interna. Você pode definir fluxos de navegação entre cards para uma experiência de interação avançada.

Os cards podem ser não contextuais ou contextuais. Os cards contextuais são apresentados ao usuário quando o aplicativo host está em um contexto específico, como ao abrir uma mensagem do Gmail ou um evento do Google Agenda. Os cards não contextuais (como páginas iniciais) são apresentados ao usuário fora de um contexto específico do host, por exemplo, quando o usuário está visualizando a caixa de entrada do Gmail, a pasta principal do Google Drive ou o Google Agenda.

Os complementos do Google Workspace criados no Google Apps Script usam o serviço Card para criar interfaces de usuário com cards. Os complementos criados em outras linguagens precisam retornar JSON formatado corretamente para que a interface seja renderizada como cards.

Cada card consiste em um cabeçalho e uma ou mais seções de card. Cada seção é composta por um conjunto de widgets. Os widgets mostram informações ao usuário ou fornecem controles de interação, como botões.

As interfaces baseadas em cards têm os seguintes benefícios:

  • Não é necessário ter conhecimento de HTML ou CSS para criar interfaces baseadas em cards.
  • Os cards e widgets são estilizados automaticamente para funcionar bem com os aplicativos do Google Workspace que eles estendem.
  • As interfaces baseadas em cards funcionam em computadores e dispositivos móveis, mas você só precisa definir a interface uma vez.

O Gmail é o único aplicativo host que pode ser estendido por complementos do Google Workspace em dispositivos móveis.

Criar interfaces baseadas em cards

Ao criar complementos baseados em cards, é importante entender alguns conceitos e padrões de design. Os guias a seguir fornecem as informações necessárias para criar complementos baseados em cards eficazes:

Consulte essas páginas ao criar cards e implementar o comportamento da interface. Você também pode consultar os seguintes exemplos adicionais ao implementar o complemento: