Generic Filter Filter
Die generic_filter Komponente zeigt eine Filterleiste mit mehreren Dropdown-Menüs an. Bei einer Änderung der Filter werden die Ergebnisse automatisch über HTMX aktualisiert.
For more complex filtering needs, consider the Query Builder component.
Funktionen
-
HTMX-Integration: Die Ergebnisse werden bei einer Filteränderung automatisch aktualisiert.
Anordnungsoptionen: Horizontale oder vertikale Anordnung.
Tooltips: Optionaler Erklärungstext für jeden Filter.
Verwendung
Die Komponente wird über das generic_filter Tag eingebunden.
Parameter
config (GenericFilterConfig oder als kwargs oder als Kombination aus beidem)
Dataclass für die Komponentenkonfiguration.
| Name | Typ | Beschreibung | Standardwert | Erforderlich |
|---|---|---|---|---|
| filters | Liste der Filterkonfigurationen. |
[] |
False
|
|
| request_url | str | URL für den Formular-Request. Nicht zusammen mit htmx_config verwenden; stattdessen htmx_config.request_url für HTMX-Anfragen verwenden. |
"" |
False
|
| vertical | bool | Wenn „True“, werden die Filter vertikal angeordnet. |
False |
False
|
| htmx_config | HTMX-Konfiguration für AJAX-Anfragen. |
None |
False
|
Barrierefreiheit
| WCAG AA | WCAG AAA | |
|---|---|---|
| Status |
|
N/A
|
WCAG AA (Grundlagen)
Das Formularelement verfügt über die Eigenschaft role='search' für die Orientierungsnavigation.
Filterfelder verwenden die select-Komponente mit den entsprechenden Beschriftungszuordnungen.