Widgets d'intégration : afficher une image et une liste cliquable dans le même widget?

Bonjour à tous,

Je développe une intégration externe pour Gladys 5 : « Carte des artisans » (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). Elle cherche des artisans autour de la maison à partir des données publiques Sirene. Elle propose deux widgets :

  • une liste (card-list) : chaque entreprise est cliquable et ouvre le détail avec l’adresse, le téléphone et les liens « Voir la fiche » / « Itinéraire » ;
  • une carte (image PNG générée dans le conteneur) : la maison, le rayon de recherche et les entreprises numérotées.

Ce que je voudrais faire : afficher dans le même widget la carte en haut, puis en dessous la même liste cliquable, numérotée comme les points de la carte.

Ce qui bloque : d’après la spec dashboard-widgets.md et normalizeWidgetContent, un widget n’accepte qu’un seul composant « focal » (chart, card-list ou image). Avec image + card-list, le second est ignoré. Pour contourner, j’affiche les résultats sous la carte avec un status, mais ses lignes n’acceptent ni lien ni action. Aujourd’hui, j’utilise donc un bouton « Liste / Carte » qui remplace l’un par l’autre.

Ma question : serait-il possible d’ajouter l’une de ces solutions ?

  1. autoriser la combinaison image + card-list dans un même widget (par exemple l’image au-dessus, à une hauteur limitée) ;
  2. ou permettre un link (ou une action) sur les lignes d’un status ;
  3. ou toute autre solution que vous jugeriez plus propre dans la logique des widgets.

Si une de ces options vous paraît acceptable, je peux essayer de proposer une PR. Je suis preneur de vos conseils sur la bonne approche.

Merci.

Salut @Tlse-vins, merci pour le message et pour la maquette, c’est très clair !

Je préfère te répondre franchement : je ne vais pas faire évoluer les widgets dans ce sens, et je pense que le problème n’est pas la limite que tu rencontres, mais ce que tu essaies de faire rentrer dans un widget.

Un widget n’est pas un produit

Un widget de tableau de bord, c’est une information qu’on lit d’un coup d’œil, et éventuellement un bouton qu’on touche : la production solaire du jour, l’état de l’aspirateur, les prochaines sorties ciné. Ce que tu construis, c’est autre chose : une recherche, une liste de résultats, une carte, des fiches détaillées, des itinéraires, une bascule entre deux vues. C’est une application complète, et tu es en train de tordre le vocabulaire des widgets pour la faire tenir dans une carte du tableau de bord.

Les limites que tu rencontres (un seul composant focal, pas de lien sur un status, le bouton Liste / Carte comme contournement) ne sont pas des manques à combler. Elles sont là exactement pour ça : empêcher qu’un widget devienne une page. Si j’autorise image + card-list, la demande suivante sera chart + card-list, puis des onglets, puis des filtres, et on aura recréé un moteur d’interface dans le tableau de bord.

Sur mobile, ça ne marchera pas

Sur un téléphone, le tableau de bord est une seule colonne d’environ 350 px de large. Ta carte y devient une image fixe de 350 × 200 px, sans zoom, avec des pastilles numérotées de quelques pixels. Dessous viennent la liste, puis les boutons, puis le formulaire de recherche : plusieurs écrans de défilement au milieu du tableau de bord, entre la température du salon et les volets. Même si je levais la limite, le résultat serait inutilisable là où Gladys est le plus consultée.

Ce qui a sa place dans un widget

La version « tableau de bord » de ton intégration, à mon avis, c’est une card-list seule : les artisans les plus proches pour un métier et un rayon choisis dans les réglages du widget, avec le panneau de détail (adresse, téléphone, « Voir la fiche », « Itinéraire »). Pas de recherche, pas de bascule. Ça, le vocabulaire actuel le fait très bien, et ça reste lisible sur téléphone.

Et pour le reste

L’outil de recherche avec sa carte correspond aux pages d’intégration personnalisées (ce sujet), qui ne sont pas encore spécifiées. C’est là que ton cas d’usage aura sa place, pas dans le tableau de bord.

Pour la carte elle-même, la piste prévue dans la spec est un composant map : l’intégration envoie des points, Gladys dessine la carte, avec le thème, le mode sombre et le zoom.

Une question au passage : à quoi correspond le badge « Sponsorisé » sur ta maquette ?

Merci pour ta réponse franche et détaillée, c’est exactement ce dont j’avais besoin.

Tu as raison sur le mobile : je n’avais testé que sur ordinateur, et la carte n’y servirait à rien. Je vais donc revenir à l’esprit du tableau de bord : un seul widget en card-list, avec le métier et le rayon choisis dans les réglages, et le panneau de détail (adresse, téléphone, « Voir la fiche », « Itinéraire »). Je retire la recherche tapée, la bascule et le widget carte. L’action de scène « Chercher un artisan » reste telle quelle.

La recherche et la carte attendront les pages d’intégration personnalisées et le composant map. Je suivrai le sujet et je pourrai faire un retour concret sur la spec quand elle avancera.

Pour le badge « Sponsorisé » : sur le site cartedesartisans.fr, un artisan peut payer pour apparaître dans un encart « Sponsorisé » quand on cherche son métier dans sa zone. Les règles sont les mêmes partout : 3 entreprises au plus, toujours marquées « Sponsorisé », dans un bloc à part en tête de liste. Les résultats normaux ne changent pas : les entreprises labellisées d’abord, puis les plus proches. Ce bloc n’apparaît jamais dans l’action de scène, et aucune donnée sur l’utilisateur n’est transmise : la position de la maison ne sort jamais du conteneur. Si ce type de contenu pose problème pour le store, dis-le-moi et je le retirerai de l’intégration Gladys.