So sieht die Komponente in einer Seite aus. Unten ist sie als <agrarmedien-events> eingebunden.
<script src="https://DEINE-DOMAIN/embed.js" async></script> <agrarmedien-events></agrarmedien-events>
Die Komponente liest Parameter aus der URL der Seite, in die sie eingebunden ist. Die URL hat Vorrang vor den Attributen.
| Parameter | Bedeutung |
|---|---|
| kategorie | Kategorie-Slugs, kommagetrennt (auch: category) |
| kanton | Kantonskürzel, kommagetrennt, CH = Überregional (auch: canton) |
| ansicht | agenda, kalender oder karte |
| suche | Suchtext |
| event | ID eines Termins, öffnet dessen Detailansicht |
Beispiele:
?kanton=LU,ZG – Nur Luzern und Zug?kategorie=kurse&ansicht=karte – Kurse auf der Karte?kanton=AG&kategorie=diverses&ansicht=kalender – Kalender für Aargau, Diverses?suche=ziegen – Suche nach «ziegen»Mit dem Attribut param-prefix (z. B. ak-) heissen die Parameter ak-kanton usw.; so gibt es keine Konflikte mit der Seite. Mit url-sync schreibt die Komponente Änderungen zurück in die URL (teilbare Links).
| Attribut | Bedeutung |
|---|---|
| api-url | Basis-URL der API (Standard: beim Build eingestellt) |
| category | Vorgewählte Kategorien (Slugs, kommagetrennt), z. B. kurse,tagungen |
| canton | Vorgewählte Kantone, z. B. BE,LU; CH = Überregional |
| default-view | agenda (Standard), calendar oder map |
| hide-header | Blendet die Kopfzeile aus (z. B. wenn die Seite schon einen Titel hat) |
| title / subtitle | Texte der Kopfzeile |
| url-sync | Schreibt Ansicht, Filter und Suche in die URL der Seite (history.replaceState) |
| param-prefix | Präfix für die URL-Parameter, z. B. ak- |