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 haya accedido a través del menú). El complemento tiene una barra de herramientas superior que
Identifica el complemento y muestra una tarjeta, que es una "página". de los
de la IU del complemento. Apps Script representa tarjetas en código de proyecto usando
Objetos Card
Anatomía de las tarjetas
Una tarjeta es un grupo de elementos de la interfaz de usuario que diseñas. Una tarjeta consta de lo siguiente: las siguientes secciones:
- El encabezado de una tarjeta Aquí se identifican las tarjetas. Tiene el texto del título y puede opcionalmente un subtítulo y un icono.
Una o más secciones de tarjetas. Estas son subdivisiones del área de 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í mediante una regla horizontal. Si la sección de una tarjeta es muy grande, se renderiza automáticamente como sección contraíble que los usuarios pueden expandir o contraer según sea necesario. Una tarjeta no puede tener más de 100 secciones de tarjeta, y debería tener solo algunas para obtener un mejor rendimiento.
Cada sección de la tarjeta contiene una o más IU widgets. Los widgets le proporcionan al usuario información o controles interactivos. Las tarjetas y las secciones de tarjetas son estructurales, por lo que no puedes agregarlos a una sección de tarjetas. Una tarjeta no puede tener más de 100 widgets, y debe ser lo más sencilla posible para obtener el mejor rendimiento.
Debes diseñar tarjetas en torno a actividades de usuario o conjuntos de datos particulares. Para ejemplo, un complemento de Google Workspace que muestra datos extraídas de las Hojas de cálculo de Google podrían tener una tarjeta separada para cada hoja que extraiga los datos de origen.
Uso de varias tarjetas
Por lo general, los complementos consisten en más de una tarjeta. Puedes configurar estas tarjetas como una lista sencilla de navegación básica con varias tarjetas o configurar una configuración más compleja métodos de navegación para controlar cómo se mueve el usuario entre las tarjetas.
Si el complemento utiliza la navegación básica, cuando la ventana complemento se abre por primera vez, una aplicación de Google Workspace extiende construcciones una lista de encabezados de las tarjetas y se los presenta al usuario. Haciendo clic en la tarjeta se abre esa tarjeta. También se proporciona una flecha hacia atrás para regresar a la tarjeta lista de encabezados. No es necesario codificar el encabezado ni la flecha hacia atrás en la nube, esto se hace automáticamente cuando defines las tarjetas en tu complemento.
Cuando diseñas complementos, es mejor limitar la cantidad de tarjetas que muestres al mismo tiempo, ya que las tarjetas deben compartir una cantidad limitada de espacio en pantalla. También es mejor evitar la complejidad innecesaria en las tarjetas.