Lorixen.
DE

Filter in der Adresse speichern und teilen

Kurz gesagt: In vielen internen Web-Apps und Kundenportalen stellt man mühsam Filter ein: nur offene Aufträge, nur Region Steiermark, sortiert nach Fälligkeit. Dann lädt man die Seite neu, klickt auf Zurück oder möchte einer Kollegin genau diese Ansicht schicken, und alles ist weg. Der Grund: Die Filter leben nur im Arbeitsspeicher des Browsers. Wenn Sie den Filterzustand in die Adresse schreiben, also in die Parameter nach dem Fragezeichen, lässt sich jede Ansicht als Link teilen, als Lesezeichen speichern und nach dem Neuladen wiederherstellen. Mit den Browserfunktionen URLSearchParams und der History-API ist das ohne großen Aufwand umsetzbar.

Wo verlorene Filter Zeit kosten

Typische Situationen in Betrieben:

  • Die Disponentin filtert Aufträge nach Datum und Monteur, klickt einen Auftrag an und landet beim Zurückgehen wieder in der ungefilterten Liste.
  • Ein Teamleiter möchte einem Mitarbeiter „alle überfälligen Rechnungen von Kunde X“ zeigen und muss am Telefon beschreiben, welche Filter er einstellen soll.
  • Im Kundenportal sucht ein Großkunde jeden Montag dieselbe Ansicht seiner offenen Bestellungen und stellt sie jedes Mal neu ein.
  • Nach einem automatischen Neuladen, etwa nach einem Update der App, sind alle Einstellungen verschwunden.

Jede dieser Situationen kostet ein paar Minuten und viel Geduld. Über Wochen summiert sich das.

Das Prinzip: Die Adresse beschreibt die Ansicht

Eine Adresse kann neben dem Pfad auch Parameter enthalten, etwa status gleich offen, region gleich stmk und sortierung gleich faellig. Wenn Ihre App beim Laden der Seite diese Parameter liest und die Filter entsprechend setzt, und bei jeder Filteränderung die Parameter aktualisiert, ist die Adresse immer ein genaues Abbild der Ansicht.

Daraus ergeben sich mehrere Vorteile auf einmal:

  • Teilen: Die Adresse kopieren und schicken, die andere Person sieht dieselbe Ansicht.
  • Lesezeichen: Häufige Ansichten lassen sich im Browser speichern.
  • Neuladen: Die Ansicht bleibt erhalten.
  • Zurück-Knopf: Der Browser kann zur vorherigen Ansicht zurückspringen.

Die Bausteine im Browser

Zum Lesen und Schreiben der Parameter gibt es im Browser die Schnittstelle URLSearchParams. MDN beschreibt unter anderem die Methode set, die den Wert eines Parameters setzt und weitere Werte mit demselben Namen entfernt, und toString, die eine fertige Parameterzeichenkette für die Adresse liefert. Damit müssen Sie die Adresse nicht von Hand zusammensetzen und vermeiden Fehler bei Sonderzeichen und Umlauten.

Um die Adresse zu ändern, ohne die Seite neu zu laden, nutzen Sie die History-API. MDN beschreibt die Methoden pushState und replaceState. Der Unterschied ist für Filter wichtig:

  • pushState legt einen neuen Eintrag im Verlauf an. Der Zurück-Knopf führt dann zur vorherigen Filtereinstellung.
  • replaceState ersetzt den aktuellen Eintrag. Der Zurück-Knopf führt dann zur vorherigen Seite, nicht zur vorherigen Filtereinstellung.

Für die meisten Filter ist replaceState angenehmer, besonders bei Suchfeldern, die bei jedem Tastendruck filtern. Sonst muss man zwanzigmal zurückklicken, um die Seite zu verlassen. Für größere Wechsel, etwa von „offene“ zu „erledigte“ Aufträge, kann pushState sinnvoll sein.

Was in die Adresse gehört und was nicht

Nicht alles, was eine Ansicht ausmacht, sollte in die Adresse:

  • Ja: Filter, Sortierung, Suchbegriff, Seitenzahl, gewählte Spalten oder Ansichtsart.
  • Nein: persönliche Daten, vertrauliche Inhalte, Zugangsdaten oder interne Kennungen, die nicht jeder sehen soll.

Adressen landen in Browserverläufen, in E-Mails und manchmal in Protokollen von Servern und Analysewerkzeugen. Ein Suchbegriff wie ein Kundenname kann deshalb heikel sein. Überlegen Sie, ob die Filterung nach Namen besser über eine Kundennummer läuft.

Lesbare und stabile Parameter

Wählen Sie kurze, sprechende Namen und Werte, die sich nicht ändern. Ein Parameter status gleich offen versteht jeder. Eine interne Datenbankkennung für den Status ist schwer lesbar und bricht, wenn sich die Datenbank ändert. Wenn Sie Parameter später umbenennen müssen, sollte die App die alten Namen noch eine Weile verstehen, damit gespeicherte Lesezeichen nicht ins Leere führen.

Prüfen Sie Parameter beim Laden immer. Wer eine Adresse von Hand verändert, darf nicht auf Daten zugreifen können, die ihm sonst verborgen wären. Filter in der Adresse ersetzen keine Berechtigungsprüfung auf dem Server.

Standardwerte weglassen

Damit Adressen kurz bleiben, schreiben Sie nur Abweichungen vom Standard hinein. Ist „alle Regionen“ der Standard, braucht es keinen Parameter dafür. So bleibt die Adresse der ungefilterten Liste sauber, und geteilte Links sind übersichtlich.

Und wenn die Adresse zu lang wird?

Bei vielen gleichzeitigen Filtern kann eine Adresse lang werden. Für die meisten Anwendungen ist das kein Problem. Wenn es doch eines wird, etwa bei sehr komplexen Ansichten, kann die App die Einstellungen auf dem Server speichern und nur eine kurze Kennung in die Adresse schreiben. Das ist im Grunde eine gespeicherte Ansicht mit eigenem Link.

Gespeicherte Ansichten als Ergänzung

Für Ansichten, die jemand täglich braucht, reicht ein Lesezeichen im Browser oft schon. Wer mehr Komfort bieten möchte, ergänzt die App um eine Liste „Meine Ansichten“: Ein Klick speichert die aktuelle Adresse mit einem Namen wie „Offene Einsätze Graz-Nord“, ein weiterer Klick öffnet sie wieder. Weil die Ansicht ohnehin vollständig in der Adresse steht, ist das technisch einfach. Auch Teamansichten lassen sich so anlegen, die für alle gelten, etwa „Heute fällig“. Damit wird aus einer kleinen technischen Änderung eine Funktion, die im Alltag spürbar Zeit spart.

Beispiel aus der Praxis

Ein Reinigungsunternehmen in Graz verwaltet Einsätze in einer eigenen Web-App (Beispiel zur Veranschaulichung). Die Einsatzleitung filterte täglich nach Bezirk, Datum und Status und verlor die Einstellungen bei jedem Wechsel in einen Einsatz. Nach der Umstellung schreibt die App alle Filter in die Adresse, nutzt replaceState für Änderungen und liest die Parameter beim Laden aus. Die Einsatzleitung hat sich ihre drei wichtigsten Ansichten als Lesezeichen gespeichert und schickt Teamleitern bei Bedarf einfach den Link.

Typische Fehler

  • Filter nur im Arbeitsspeicher, nicht in der Adresse.
  • pushState bei jedem Tastendruck im Suchfeld.
  • Vertrauliche Daten in Parametern.
  • Interne Kennungen statt lesbarer Werte.
  • Parameter ohne Prüfung und Berechtigung auf dem Server.

Häufige Fragen

Ist das nur für interne Tools sinnvoll?

Nein, auch Kundenportale profitieren. Für öffentliche Shop-Filter gelten zusätzlich Fragen der Suchmaschinenoptimierung, die hier nicht das Thema sind.

Funktioniert das mit jeder Tabellenkomponente?

Die meisten Komponenten lassen sich von außen mit Filterwerten versorgen. Prüfen Sie, ob Ihre Komponente Ereignisse bei Filteränderungen meldet.

Was passiert mit alten Lesezeichen nach einem Update?

Wenn die App alte Parameternamen weiter versteht, funktionieren sie. Sonst sollte sie unbekannte Parameter ignorieren und die Standardansicht zeigen.

Muss die Seite beim Filtern neu laden?

Nein. Mit replaceState oder pushState ändert sich nur die Adresse, die Liste wird per Skript aktualisiert. Nur beim ersten Aufruf liest die Seite die Parameter und baut die Ansicht danach auf.

Wenn Ihr Team in der Web-App ständig dieselben Filter neu einstellt, machen wir die Ansichten gern teilbar und speicherbar: Filter und Ansichten verbessern.

Quellen

WhatsAppTermin buchen