Widgets de integración: ¿mostrar una imagen y una lista clicable en el mismo widget?

Hola a todos,

Estoy desarrollando una integración externa para Gladys 5: « Mapa de artesanos » (GitHub - tlse-vins/gladys-carte-des-artisans: Intégration Gladys Assistant de la Carte des artisans : artisans près de chez vous (widget et action de scène) · GitHub). Busca artesanos alrededor de la casa a partir de los datos públicos Sirene. Ofrece dos widgets:

  • una lista (card-list) : cada empresa es cliqueable y abre el detalle con la dirección, el teléfono y los enlaces « Ver la ficha » / « Ruta » ;
  • un mapa (image PNG generado en el contenedor) : la casa, el radio de búsqueda y las empresas numeradas.

Lo que me gustaría hacer: mostrar en el mismo widget el mapa arriba, y debajo la misma lista cliqueable, numerada como los puntos del mapa.

Lo que bloquea: según la especificación dashboard-widgets.md y normalizeWidgetContent, un widget solo acepta un único componente « focal » (chart, card-list o image). Con image + card-list, el segundo se ignora. Para sortearlo, muestro los resultados debajo del mapa con un status, pero sus líneas no aceptan ni enlace ni acción. Hoy, uso un botón « Lista / Mapa » que reemplaza uno por el otro.

Mi pregunta: ¿sería posible añadir una de estas soluciones?

  1. permitir la combinación image + card-list en un mismo widget (por ejemplo la imagen arriba, a una altura limitada) ;
  2. o permitir un link (o una action) en las líneas de un status ;
  3. o cualquier otra solución que consideren más limpia en la lógica de los widgets.

Si alguna de estas opciones les parece aceptable, puedo intentar proponer un PR. Acepto sus consejos sobre el mejor enfoque.

Gracias.

¡Hola @Tlse-vins, gracias por el mensaje y por el boceto, es muy claro!

Prefiero responderte con franqueza: no voy a hacer evolucionar los widgets en ese sentido, y creo que el problema no es el límite que encuentras, sino lo que intentas meter en un widget.

Un widget no es un producto

Un widget de panel de control es una información que se lee de un vistazo, y eventualmente un botón que se toca: la producción solar del día, el estado del aspirador, las próximas salidas de cine. Lo que estás construyendo es otra cosa: una búsqueda, una lista de resultados, un mapa, fichas detalladas, rutas, un cambio entre dos vistas. Es una aplicación completa, y estás retorciendo el vocabulario de los widgets para hacerla caber en una tarjeta del panel de control.

Los límites que encuentras (un solo componente focal, sin enlace en un status, el botón Lista / Mapa como contorno) no son carencias que llenar. Están ahí exactamente para eso: evitar que un widget se convierta en una página. Si permito image + card-list, la siguiente solicitud será chart + card-list, luego pestañas, luego filtros, y habremos recreado un motor de interfaz en el panel de control.

En móvil, no funcionará

En un teléfono, el panel de control es una sola columna de aproximadamente 350 px de ancho. Tu tarjeta se convierte en una imagen fija de 350 × 200 px, sin zoom, con pastillas numeradas de unos pocos píxeles. Debajo vienen la lista, luego los botones, luego el formulario de búsqueda: varios pantallas de desplazamiento en medio del panel de control, entre la temperatura de la sala y las persianas. Incluso si levantara el límite, el resultado sería inutilizable donde Gladys se consulta más.

Lo que tiene cabida en un widget

La versión «panel de control» de tu integración, en mi opinión, es una card-list sola: los artesanos más cercanos para un oficio y un radio elegidos en los ajustes del widget, con el panel de detalles (dirección, teléfono, «Ver la ficha», «Ruta»). Sin búsqueda, sin cambio. Eso, el vocabulario actual lo hace muy bien, y sigue siendo legible en el teléfono.

Y para el resto

La herramienta de búsqueda con su mapa corresponde a las páginas de integración personalizadas (este tema), que aún no están especificadas. Es allí donde tu caso de uso tendrá su lugar, no en el panel de control.

Para el mapa en sí, la pista prevista en la especificación es un componente map: la integración envía puntos, Gladys dibuja el mapa, con el tema, el modo oscuro y el zoom.

Una pregunta de paso: ¿a qué corresponde la insignia «Patrocinado» en tu boceto?

Gracias por tu respuesta franca y detallada, es exactamente lo que necesitaba.

Tienes razón sobre el móvil: solo lo había probado en ordenador, y el mapa no serviría de nada. Por lo tanto, volveré al espíritu del panel de control: un solo widget en lista de tarjetas, con la profesión y el radio elegidos en la configuración, y el panel de detalles (dirección, teléfono, « Ver la ficha », « Itinerario »). Eliminaré la búsqueda escrita, el interruptor y el widget del mapa. La acción de escena « Buscar un artesano » se mantendrá tal cual.

La búsqueda y el mapa esperarán a las páginas de integración personalizadas y el componente map. Seguiré el tema y podré dar un feedback concreto sobre la especificación cuando avance.

Para el distintivo « Patrocinado »: en el sitio web cartedesartisans.fr, un artesano puede pagar para aparecer en un recuadro « Patrocinado » cuando se busca su profesión en su zona. Las reglas son las mismas en todas partes: como máximo 3 empresas, siempre marcadas como « Patrocinado », en un bloque aparte al principio de la lista. Los resultados normales no cambian: primero las empresas etiquetadas, luego las más cercanas. Este bloque nunca aparece en la acción de escena, y ningún dato del usuario se transmite: la posición de la casa nunca sale del contenedor. Si este tipo de contenido plantea algún problema para la tienda, dime y lo retiraré de la integración Gladys.