Un complemento 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. Apps Script representa las tarjetas en el código del proyecto con objetos Card.
Anatomía de la tarjeta
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. De manera opcional, una sección puede tener un encabezado de texto. Las secciones de la tarjeta están separadas entre sí por una regla horizontal. Si una sección de la tarjeta es particularmente grande, se renderiza automáticamente como una sección plegable que los usuarios pueden expandir o contraer según sea necesario. Una tarjeta puede tener no más de 100 secciones y solo debe tener algunas para obtener un mejor rendimiento.
Cada sección de la tarjeta contiene uno o más widgets de la IU. Los widgets le 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 tarjetas. Una sección de tarjetas puede tener no más de 100 widgets y debe ser lo más simple posible para obtener el mejor rendimiento.
Debes diseñar tarjetas en torno a actividades o conjuntos de datos específicos del usuario. Por ejemplo, un complemento de Google Workspace que muestra datos tomados de Hojas de cálculo de Google puede tener una tarjeta independiente para cada hoja de la que extrae datos.
Cómo usar varias tarjetas
Por lo general, los complementos consisten en más de una tarjeta. Puedes configurar estas tarjetas como una lista simple para la navegación básica con varias tarjetas, o bien configurar métodos de navegación más complejos para controlar cómo el usuario se mueve entre las tarjetas.
Si el complemento usa la navegación básica, cuando se abre por primera vez, la aplicación de Google Workspace que lo extiende construye una lista de los encabezados de la tarjeta y se la presenta al usuario. Si haces clic en el encabezado de la tarjeta, se abrirá. También se proporciona una flecha hacia atrás para volver a la lista de encabezados de la tarjeta. No tienes que codificar la funcionalidad del encabezado ni de la flecha hacia atrás. Esto se hace automáticamente cuando defines las tarjetas en tu complemento.
Cuando diseñes complementos, es mejor limitar la cantidad de tarjetas que muestres 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.