Un complemento de Google Workspace basado en tarjetas aparece como un panel en la barra lateral (o, en dispositivos móviles, como otra ventana de actividad a la que se accede a través del menú). El
complemento tiene una barra de herramientas superior que lo identifica y muestra una tarjeta, que es básicamente una "página"
de la IU del complemento. Google Apps Script representa
las tarjetas en el código del proyecto con Card
objetos.
Anatomía de las tarjetas
Una tarjeta es un grupo de elementos de la IU que diseñas. Una tarjeta consta de las siguientes secciones:
- Un encabezado de tarjeta. Esto identifica las tarjetas. Tiene texto de título y, de manera opcional, puede tener un subtítulo y un ícono.
Una o más secciones de tarjetas. Estas son subdivisiones del área de la IU de la tarjeta. Una sección puede tener un encabezado de sección de texto. Las secciones de tarjetas se separan entre sí en la tarjeta con una regla horizontal. Si una sección de tarjeta es particularmente grande, se renderiza automáticamente como una sección contraíble que los usuarios pueden expandir o contraer según sea necesario. Una tarjeta puede tener no más de 100 secciones de tarjetas, y debe tener solo algunas para obtener un mejor rendimiento.
Cada sección de tarjeta contiene uno o más UI widgets. Los widgets proporcionan al usuario información o controles interactivos. Las tarjetas y las secciones de tarjetas son widgets estructurales, por lo que no puedes agregarlos a una sección de tarjeta. Una sección de tarjeta no puede tener más de 100 widgets, y debe ser lo más concisa posible para obtener el mejor rendimiento.
Debes diseñar tarjetas en torno a actividades o conjuntos de datos de usuarios específicos. Por ejemplo, un complemento de Google Workspace que muestra datos tomados de Hojas de cálculo de Google podría tener una tarjeta independiente para cada hoja de la que extrae datos.
Cómo usar varias tarjetas
Por lo general, los complementos constan de más de una tarjeta. Puedes configurar estas tarjetas como una lista para la navegación básica o configurar métodos de navegación más complejos para controlar cómo se mueve el usuario entre las tarjetas. Para obtener más detalles, consulta la navegación básica con varias tarjetas.
Si el complemento usa la navegación básica, cuando se abre por primera vez, la aplicación de Google Workspace que extiende construye una lista de los encabezados de las tarjetas y se los presenta al usuario. Si se hace clic en el encabezado de la tarjeta, se abrirá esa tarjeta. También se proporciona una flecha hacia atrás para volver a la lista de encabezados de tarjetas. No es necesario codificar la funcionalidad del encabezado y la flecha hacia atrás. Esto se realiza automáticamente cuando defines las tarjetas en tu complemento.
Cuando diseñes complementos, es mejor limitar la cantidad de tarjetas que muestras a la vez, ya que las tarjetas deben compartir una cantidad limitada de espacio en la pantalla. También es mejor evitar la complejidad innecesaria en las tarjetas.
Por motivos de rendimiento, no puedes agregar más de 100 widgets ni 100 secciones de tarjetas a una tarjeta.