Countryregionjs NPM

CountryRegion A cascading dropdown for loading countries and associated states and local governments.

CountryRegion

CountryRegionJs is a simple-to-use library that provides you with the MOST COMPREHENSIVE cascading dropdown for loading countries, associated states and substates (local governments).

Badges

stable release version:

Nuget package downloads:

NPM downloads:

Tech Stack

Vanilla Javascript, Jest, Axios

How Do I Get Started

Install CountryRegionJS with npm

  npm install CountryRegionJS

or with yarn

   yarn add CountryRegionJS

Sample usage:

   //import countryregionjs
   import CountryRegion from "countryregionjs";

   const countryRegion = new CountryRegion();

    //sample ids
   const countryId = 1;
   const stateId = 1;
   const substateId = 1;

   //get all countries
   const countries = await countryRegion.getCountries();

   //get all statess
   const states = await countryRegion.getStates(countryId);

   //get all substates
   const subStates = await countryRegion.getLGAs(countryId, stateId);  

   //get a country   
   const country = await countryRegion.getCountry(countryId);

   //get a state
   const id = 1;
   const country = await countryRegion.getState(countryId, stateId);

   //get a sub-state
   const id = 1;
   const country = await countryRegion.getLga(countryId, stateId, substateId);