Countries API - CountriesDB

Länder- und Regions-Dropdown in Webflow einbinden

Füge mit Code Embed ein Länder-Dropdown und eine abhängige Regionsauswahl in ein eigenes Webflow-Formular ein.

Länder- und Regions-Dropdown in Webflow einbinden

Ein festes Länderfeld in Webflow ist schnell angelegt. Sobald auch Bundesländer oder Provinzen zur Auswahl stehen, musst du die passenden Optionen für jedes Land pflegen. Wenn du Zugriff auf das Formular-HTML hast, kannst du beide Listen über ein Code Embed laden.

Die Anleitung für Website-Formulare enthält das gemeinsame HTML-Beispiel und die Schritte zur Einrichtung.


Was du brauchst

Du brauchst Zugriff auf das Code-Embed-Element von Webflow, eigenes Formular-HTML und ein Ziel für Einsendungen. Erstelle ein CountriesDB-Projekt, kopiere den öffentlichen Schlüssel und erlaube den Hostnamen, unter dem du veröffentlichst. Falls du die Webflow-Staging-Adresse nutzt und deine Konfiguration es erlaubt, füge auch deren Hostnamen hinzu.


So richtest du das Embed ein

1. Platziere die Felder im Formular

Setze das Code Embed an die Stelle, an der die Auswahllisten erscheinen sollen. Enthält das Embed bereits das gesamte eigene Formular, ergänze die Felder darin. Beide Felder und die Schaltfläche zum Absenden müssen zum selben Formular gehören.

2. Füge die Felder hinzu und lade das Skript

Verwende die Feldnamen, die dein Zielsystem erwartet, und eindeutige IDs für die Zuordnung der Beschriftungen. Lade das Widget einmal mit deinem öffentlichen Schlüssel.

<script src="https://unpkg.com/@countriesdb/widget@latest/dist/index.js?public_key=YOUR_PUBLIC_KEY"></script>

<label for="country">Land</label>
<select id="country" name="country" class="country-selection"
        data-name="country" data-label="Land auswählen" data-preselected="" required></select>

<label for="region">Bundesland / Provinz / Region</label>
<select id="region" name="region" class="subdivision-selection"
        data-country="country" data-label="Region auswählen"></select>

3. Prüfe die Einsendung auf der veröffentlichten Seite

Teste unter einem erlaubten Hostnamen, auch wenn der Designer für das Skript nur einen Platzhalter anzeigt. Wechsle das Land und prüfe, ob die Regionsliste neu geladen wird. Kontrolliere nach einer Testeinsendung beide Codes im Zielsystem. Fehlen sie dort, prüfe zuerst die Position und die Namen der Felder.


Häufige Fragen

Brauche ich Unterstützung aus der Entwicklung?
Wenn du das Formular-HTML und das Ziel für Einsendungen kennst, kannst du das Embed selbst einfügen. Für Änderungen an der Verarbeitung kann Entwicklungshilfe sinnvoll sein.

Kann ich Bundesländer und Provinzen anzeigen?
Ja. Die Regionsliste enthält die verfügbaren Unterteilungen des gewählten Landes.

Kommen beide Werte im Zielsystem an?
Das hängt davon ab, wie das Formular seine Felder übermittelt und zuordnet. Prüfe den ganzen Ablauf mit deinem Zielsystem.

Warum funktioniert es nur unter einer Adresse?
Deine veröffentlichte Domain und die Webflow-Staging-Adresse haben verschiedene Hostnamen. Prüfe, ob der verwendete Hostname im Projekt erlaubt ist.


Links


Verwandte Anleitungen