Lista estática de países en HTML o widget de CountriesDB
Una lista breve en HTML puede bastar si tu formulario solo admite tres mercados. Con más países, etiquetas traducidas o un segundo selector que depende del primero, cambia el coste de mantenimiento. Cada copia de la lista es otro lugar donde revisar las actualizaciones.
La guía para formularios web contiene el fragmento y los pasos de configuración del widget.
Cómo elegir para tu formulario
1. Usa una lista fija para un conjunto pequeño
Si solo atiendes a unos pocos mercados y las opciones son parte de tus reglas de negocio, puedes escribirlas directamente en el HTML. Usa valores estables y nombres fáciles de leer. Este ejemplo ofrece dos países.
<label for="fixed-country">País</label>
<select id="fixed-country" name="country" required>
<option value="">Selecciona un país</option>
<option value="CA">Canadá</option>
<option value="US">Estados Unidos</option>
</select>
2. Usa el widget si mantener los datos te lleva tiempo
El widget resulta útil si necesitas más países o regiones que cambien según el país. Crea un proyecto de CountriesDB, genera una clave pública y autoriza el host del formulario. Coloca los campos dentro del formulario existente y carga el script una sola vez.
<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. Prueba el formulario en la página publicada
Comprueba que el script se carga, las listas se rellenan y se guardan los códigos esperados. Decide qué debe hacer el formulario si no puede cargar las opciones. Si vas a reemplazar una lista fija, comprueba antes si tus integraciones aceptan los valores que envía el widget.
Preguntas frecuentes
¿Necesito ayuda de desarrollo?
Puedes pegar cualquiera de los ejemplos si controlas el HTML. Pide ayuda si tienes que cambiar el procesamiento del formulario o conectar los valores con un CRM.
¿Qué hago si necesito estados y provincias?
La versión fija requiere sus propios datos de regiones y lógica para actualizarlos. Con el widget, añade el selector de subdivisiones y pruébalo en tus mercados.
¿Puedo limitar los países a mis mercados?
Sí. Usa las opciones de filtrado del widget y verifica los países permitidos al procesar el envío.
¿Qué opción funciona sin JavaScript?
El selector estático. El widget necesita JavaScript y acceso a su servicio de datos.