Integrations-Widgets: Bild und klickbare Liste im selben Widget anzeigen?

Hallo zusammen,

Ich entwickle eine externe Integration für Gladys 5: « Karte der Handwerker » (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). Sie sucht nach Handwerkern in der Nähe des Hauses anhand der öffentlichen Sirene-Daten. Sie bietet zwei Widgets:

  • eine Liste (card-list) : jedes Unternehmen ist anklickbar und öffnet die Details mit Adresse, Telefonnummer und den Links „Profil anzeigen“ / „Route“;
  • eine Karte (image PNG, die im Container generiert wird) : das Haus, der Suchradius und die nummerierten Unternehmen.

Was ich gerne machen würde: Im selben Widget die Karte oben anzeigen und darunter die gleiche anklickbare Liste, nummeriert wie die Punkte auf der Karte.

Was blockiert: Laut der Spezifikation dashboard-widgets.md und normalizeWidgetContent akzeptiert ein Widget nur eine einzige „fokale“ Komponente (chart, card-list oder image). Mit image + card-list wird die zweite ignoriert. Als Workaround zeige ich die Ergebnisse unter der Karte mit einem status an, aber dessen Zeilen akzeptieren weder Links noch Aktionen. Heute verwende ich daher einen „Liste / Karte“-Button, der das eine durch das andere ersetzt.

Meine Frage: Wäre es möglich, eine dieser Lösungen hinzuzufügen?

  1. die Kombination image + card-list im selben Widget zu erlauben (z. B. das Bild oben, mit begrenzter Höhe);
  2. oder Links (oder Aktionen) in den Zeilen eines status zu erlauben;
  3. oder jede andere Lösung, die Sie für eleganter in der Widget-Logik halten.

Wenn eine dieser Optionen Ihnen akzeptabel erscheint, kann ich versuchen, einen Pull Request vorzuschlagen. Ich bin offen für Ihre Ratschläge zur besten Herangehensweise.

Danke.

Hallo @Tlse-vins, danke für die Nachricht und für den Entwurf, das ist sehr klar!

Ich antworte dir lieber ehrlich: Ich werde die Widgets nicht in diese Richtung weiterentwickeln, und ich denke, das Problem ist nicht die Grenze, auf die du stößt, sondern das, was du in ein Widget hineinzwängen willst.

Ein Widget ist kein Produkt

Ein Dashboard-Widget ist eine Information, die man auf einen Blick liest, und eventuell ein Button, den man drückt: die tägliche Solarproduktion, der Zustand des Staubsaugers, die nächsten Kinostarts. Was du baust, ist etwas anderes: eine Suche, eine Liste von Ergebnissen, eine Karte, detaillierte Karten, Routen, ein Umschalten zwischen zwei Ansichten. Das ist eine vollständige Anwendung, und du verbiegst gerade die Widget-Sprache, um sie in eine Dashboard-Karte zu zwängen.

Die Grenzen, auf die du stößt (ein einzelnes fokussiertes Element, kein Link auf einen status, der Liste/Karte-Button als Workaround), sind keine Lücken, die gefüllt werden müssen. Sie sind genau dafür da: zu verhindern, dass ein Widget zu einer Seite wird. Wenn ich image + card-list erlaube, wird die nächste Anforderung chart + card-list sein, dann Registerkarten, dann Filter, und wir werden einen Interface-Engine in das Dashboard einbauen.

Auf mobilen Geräten wird das nicht funktionieren

Auf einem Telefon ist das Dashboard eine einzelne Spalte von etwa 350 px Breite. Deine Karte wird dort zu einem festen Bild von 350 × 200 px, ohne Zoom, mit nummerierten Markierungen von einigen Pixeln. Darunter kommen die Liste, dann die Buttons, dann das Suchformular: mehrere Bildlaufbildschirme in der Mitte des Dashboards, zwischen der Wohnzimmertemperatur und den Jalousien. Selbst wenn ich die Grenze aufhebe, wäre das Ergebnis dort, wo Gladys am häufigsten konsultiert wird, unbrauchbar.

Was in ein Widget gehört

Die „Dashboard“-Version deiner Integration, meiner Meinung nach, ist eine einzelne card-list: die nächstgelegenen Handwerker für einen Beruf und einen Radius, die in den Widget-Einstellungen gewählt wurden, mit dem Detailpanel (Adresse, Telefon, „Karte anzeigen“, „Route“). Keine Suche, kein Umschalten. Das macht die aktuelle Sprache sehr gut, und es bleibt auf dem Telefon lesbar.

Und für den Rest

Das Suchwerkzeug mit seiner Karte entspricht den benutzerdefinierten Integrationsseiten (dieses Thema), die noch nicht spezifiziert sind. Dort wird dein Anwendungsfall seinen Platz haben, nicht im Dashboard.

Für die Karte selbst ist der in der Spezifikation vorgesehene Ansatz ein map-Komponente: Die Integration sendet Punkte, Gladys zeichnet die Karte, mit dem Thema, dem Dunklen Modus und dem Zoom.

Eine Frage nebenbei: Wofür steht das „Sponsorisiert“-Badge in deinem Entwurf?

Danke für deine offene und detaillierte Antwort, genau das habe ich gebraucht.

Du hast recht beim Thema Mobile: Ich hatte nur am Computer getestet, und die Karte wäre dort nutzlos. Ich werde also zum Grundgedanken des Dashboards zurückkehren: ein einziges Widget als Kartenliste, mit dem Beruf und dem Bereich, die in den Einstellungen ausgewählt wurden, und dem Detailpanel (Adresse, Telefon, „Profil anzeigen“, „Route“). Ich entferne die manuelle Suche, den Schalter und das Karten-Widget. Die Aktionsszene „Handwerker suchen“ bleibt unverändert.

Die Suche und die Karte warten auf die benutzerdefinierten Integrationsseiten und die Komponente map. Ich werde das Thema verfolgen und kann dann, wenn es weitergeht, konkrete Rückmeldungen zur Spezifikation geben.

Zum Badge „Gesponsert“: Auf der Website cartedesartisans.fr kann ein Handwerker dafür bezahlen, in einem „Gesponsert“-Einschub zu erscheinen, wenn man nach seinem Beruf in seiner Zone sucht. Die Regeln sind überall gleich: maximal 3 Unternehmen, immer als „Gesponsert“ gekennzeichnet, in einem separaten Block am Anfang der Liste. Die normalen Ergebnisse ändern sich nicht: zuerst die zertifizierten Unternehmen, dann die nächsten. Dieser Block erscheint nie in der Aktionsszene, und keine Nutzerdaten werden übertragen: die Position des Hauses verlässt nie den Container. Falls dieser Inhalt für den Store ein Problem darstellt, lass es mich wissen, und ich entferne ihn aus der Gladys-Integration.