Tarjetas

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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 identifica el 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 mediante objetos Card.

Anatomía de la tarjeta

Ejemplo de tarjeta complementaria

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, opcionalmente, 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 sección de texto. Las secciones de la tarjeta están separadas una de otra por una regla horizontal. Si una sección de 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 tarjetas y solo debe tener algunas para un mejor rendimiento.

  • Cada sección de tarjeta contiene uno o más widgets de IU. Los widgets proporcionan al usuario información o controles interactivos. Las secciones de tarjetas y tarjetas 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 para actividades o conjuntos de datos específicos de los usuarios. 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 consistir en 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 el complemento se abre por primera vez en la aplicación de Google Workspace, extiende una lista de los encabezados de la tarjeta y los 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 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 de tu complemento.

Cuando se diseñan 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.