Countries API - CountriesDB

Inserta un selector de país y región en Webflow

Usa Code Embed y el widget de CountriesDB para añadir un selector de país y otro de región a un formulario propio en Webflow.

Inserta un selector de país y región en Webflow

Una lista fija de países en Webflow es fácil de crear. Mantener la lista y actualizar las provincias cada vez que cambia el país requiere más trabajo. Si controlas el HTML del formulario, un elemento Code Embed puede cargar ambas listas y actualizar la segunda al cambiar el país.

La guía para formularios web reúne el fragmento HTML común y los pasos para empezar.


Qué necesitas

Necesitas acceso a Code Embed en Webflow, tu propio HTML de formulario y un destino para los envíos. Crea un proyecto de CountriesDB, copia la clave pública y autoriza el host donde vas a publicar. Si usas el sitio de pruebas de Webflow y tu configuración lo permite, autoriza también ese host.


Cómo preparar el código insertado

1. Coloca los campos dentro del formulario

Añade Code Embed donde quieras que aparezcan los dos campos. Si el elemento ya contiene todo tu formulario personalizado, inserta los campos en ese formulario. Los selectores y el botón de envío deben pertenecer al mismo formulario.

2. Pega los campos y carga el script

Usa los nombres de campo que espera el destino y asigna identificadores únicos para asociar las etiquetas. Carga el widget una sola vez con tu clave pública.

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

<label for="country">País</label>
<select id="country" name="country" class="country-selection"
        data-name="country" data-label="Selecciona un país" data-preselected="" required></select>

<label for="region">Estado / provincia / región</label>
<select id="region" name="region" class="subdivision-selection"
        data-country="country" data-label="Selecciona una región"></select>

3. Publica y revisa los datos recibidos

Prueba en un host publicado y permitido aunque el Designer muestre un marcador para el script. Cambia de país y verifica que se actualiza la lista de regiones. Haz un envío de prueba y comprueba ambos códigos en el destino configurado. Si los campos se ven pero sus valores no llegan, revisa primero la posición y los nombres.


Preguntas frecuentes

¿Necesito ayuda de desarrollo?
Puedes insertar el código si controlas el HTML y conoces el destino de los envíos. Pide ayuda si tienes que conectar o cambiar el sistema que los procesa.

¿Puedo incluir estados y provincias?
Sí. La lista de regiones muestra las subdivisiones disponibles del país seleccionado.

¿Llegarán los dos valores al destino?
Depende de cómo se envíen y se asignen los campos. Haz una prueba completa con el destino que uses.

¿Por qué solo funciona en una dirección?
El dominio publicado y el sitio de pruebas de Webflow tienen hosts distintos. Revisa si el host que estás probando está permitido en el proyecto.


Enlaces


Guías relacionadas