/pselect

Libreria javascript para rellenar selects / dropdowns html con las provincias y municipios Españoles de forma automática.

Primary LanguageJavaScriptMIT LicenseMIT

PSelect.js

Libreria javascript para rellenar selects con las provincias y municipios Españoles de forma

Instalacion

CDN/Script

La forma más sencilla es copiar directamente este script en tu web.

<script src="https://cdn.jsdelivr.net/npm/pselect.js@4.0.1/dist/pselect.min.js" ></script>

npm

También puedes utilizar npm.

npm install --save pselect.js
var Pslect = require('pselect.js');

Uso

<html>
	<head>
		<meta charset="UTF-8">
		<title>Ejemplo Select provincias Españolas.</title>
		<script src="https://cdn.jsdelivr.net/npm/pselect.js@4.0.1/dist/pselect.min.js" ></script>
	</head>

	<body>
		<h2>Seleccione provincia</h2>
		<!-- Select de provincias -->
		<select id="ps-prov"></select>
		<!-- Select de municipios -->
		<select id="ps-mun"></select>
	</body>

	<script>
		// Crear el selector pasandole los elementos del dom.
		var prov = document.getElementById('ps-prov');
		var mun = document.getElementById('ps-mun');
		new Pselect().create(prov, mun);
	</script>
</html

Recuerda utilizar el operador new para crear un nuevo contexto.

Parametros opcionales

A la función Pselect() se le puede pasar un diccionario con parametros opcionales para permiten personalizar el comportamiento.

  • provinceDefaultText: El texto que se muestra por defecto en el select de provincias.
  • municipesDefaultText: El texto que se muestra por defecto en el select de municipios.

Listado de datos

El objet Pselect incluye dos propiedades a traves de las cuales se puede acceder a los datos de las provincias y los municipios.

const Pselect = require('pselect.js');

Pselect.provincesData[0]  // {id: "04", nm: "Almería"}

Pselect.municipesData[0] // {id: "01002", nm: "Amurrio"}

Origien de los datos

Los datos se obtienen directamente de la web del instituto nacional de estadística donde se pueden descargar dos hojas de cálculo que contienen los códigos de las provincias y los municipios de España.

Estos datos son transformados a json utilizando un dos scripts en python que se encuentran en la carpeta parser junto a las hojas de calculo utilizadas.

Si te interesan solamente los archivos json puedes encontrarlos en la carpeta data.