Skip to Content

Filtry

IronFlock pozwala filtrować dane w wielu widgetach jednocześnie, dając użytkownikom potężną kontrolę nad tym co widzą — wszystko bez żadnego kodowania backendu. Dodaj widgety filtrów do panelu, a każdy wykres, tabela, mapa lub miernik podłączony do tego filtru aktualizuje się natychmiast, gdy użytkownik dokonuje wyboru.

Jak działa filtrowanie

Filtry działają przez URL. Gdy użytkownik wybiera wartość filtru, ten wybór jest dodawany do URL jako parametr. Każdy widget na stronie może odczytać ten parametr i pokazywać tylko pasujące dane.

  1. Użytkownik wybiera wartość filtru → URL aktualizuje się automatycznie
  2. Widgety odczytują URL → pokazują tylko dane pasujące do filtru

Jeden wybór kontroluje wiele widgetów jednocześnie.

Dwa typy filtrów

Lista rozwijana filtru

Idealna do danych kategorycznych — lokalizacje, statusy, typy maszyn lub dowolna predefiniowana lista opcji.

Przykłady użycia:

  • Filtruj według lokalizacji (Berlin, Londyn, Tokio)
  • Filtruj według statusu (Aktywny, Nieaktywny)
  • Filtruj według kategorii produktu

Kalendarz filtru

Idealny do danych czasowych — konkretne daty, znaczniki czasu lub zakresy dat.

Przykłady użycia:

  • Pokaż dane z ostatnich 7 dni
  • Wyświetl odczyty czujników dla konkretnego miesiąca
  • Filtruj dzienniki według niestandardowego zakresu dat i czasu

Konfigurowanie widgetu filtru

Gdy dodajesz widget filtru do panelu, kluczową rzeczą do ustawienia jest Klucz parametru — to nazwa, której inne widgety używają do identyfikacji tego filtru.

Przykład: Tworzysz listę rozwijana filtru z opcjami Jabłko, Banan i Pomarańcza i ustawiasz Klucz parametru na owoc. Gdy użytkownik wybierze Jabłko, URL zawiera ...?owoc=jabłko. Każdy widget skonfigurowany do używania filtru owoc pokazuje wtedy tylko dane, gdzie kolumna owoc równa się jabłku.

Dla Kalendarza filtru:

  • Ustaw tylko klucz Czas początku aby pozwolić użytkownikom wybrać pojedynczy znacznik czasu.
  • Ustaw zarówno Czas początku jak i Czas końca aby pozwolić użytkownikom wybrać zakres dat.

Podłączanie widgetów do filtrów

Widgety filtrów nie rozmawiają bezpośrednio z innymi widgetami — aktualizują URL, a inne widgety go odczytują. Aby podłączyć widget do filtru, otwórz ustawienia tego widgetu i wybierz, na który klucz parametru filtru powinien reagować.

Możesz mieć wiele widgetów filtrów na tej samej stronie z różnymi kluczami parametrów. Każdy widget niezależnie wybiera jakie filtry zastosować.

Czyszczenie filtrów

Użytkownicy zawsze mogą zresetować filtr, aby zobaczyć wszystkie dane:

  • Lista rozwijana — Wybierz pustą opcję ”---” na górze listy
  • Kalendarz — Wyczyść pole daty

Gdy filtr jest wyczyszczony, jego parametr jest usuwany z URL a podłączone widgety wracają do pokazywania niefiltrowanych danych.

Last updated on