Tarjetas

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 accedió a través del menú). El complemento tiene una barra de herramientas superior que identifica al complemento y muestra una tarjeta, básicamente una "página" de la IU del complemento. Apps Script representa tarjetas en el código del proyecto con objetos Card.

Anatomía de las tarjetas

Ejemplo de tarjeta complementaria

Una tarjeta es un grupo de elementos de IU que diseñas. Una tarjeta consta de las siguientes secciones:

  • Un encabezado de tarjeta Esto identifica las tarjetas. Tiene texto del título y, de forma opcional, puede tener un subtítulo y un ícono.
  • Una o más secciones de tarjeta. Estas son subdivisiones del área de la IU de la tarjeta. De manera opcional, una sección puede tener un encabezado de sección de texto. Las secciones de la tarjeta están separadas entre sí en una tarjeta según una regla horizontal. Si una sección de una tarjeta es muy 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 tarjeta y solo debe tener algunas para un mejor rendimiento.

  • Cada sección de tarjeta contiene uno o más widgets de IU. Los widgets le proporcionan al usuario información o controles interactivos. Las tarjetas y las secciones de tarjeta son widgets estructurales, por lo que no puedes agregarlas a una sección de tarjeta. Una sección de tarjeta puede tener no más de 100 widgets y debe ser lo más simple posible para lograr un mejor rendimiento.

Debes diseñar tarjetas en torno a actividades del usuario o conjuntos de datos particulares. Por ejemplo, un complemento de Google Workspace que muestra datos tomados de Hojas de cálculo de Google puede tener una tarjeta separada para cada hoja de la que extrae datos.

Uso de varias tarjetas

Ejemplo de tarjeta complementaria

Los complementos suelen tener más de una tarjeta. Puedes configurar estas tarjetas como una lista simple para la navegación básica con varias tarjetas o configurar métodos de navegación más complejos a fin de controlar cómo se mueve el usuario entre las tarjetas.

Si el complemento usa la navegación básica, cuando se abre el complemento por primera vez en la aplicación de Google Workspace, se extiende una lista de los encabezados de la tarjeta y se los presenta al usuario. Si haces 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 la tarjeta. No es necesario que codifiques la funcionalidad del encabezado y la flecha hacia atrás, ya que esto se hace de forma automática cuando defines las tarjetas en tu complemento.

Cuando diseñes complementos, es mejor limitar la cantidad de tarjetas que se muestran a la vez, ya que las tarjetas deben compartir una cantidad limitada de espacio en pantalla. También se recomienda evitar la complejidad innecesaria de las tarjetas.