This library provides a pair of React components to display connected country and region dropdowns (pick a country, it shows the relevant regions). If you're not using React, check out the plain vanilla JS version instead. The list of countries and regions is maintained separately and found in the country-region-data repo.
Note
4.0.0
has been released! This is a major rewrite of the whole script.
- Breaking changes:
- Minimum react version updated to 16.8.0 (hooks)
classes
prop has been renamedclassName
onBlur
callback is no longer passed the selected value as first argument, just the event
- Improvements:
- completely rewritten in modern React and typescript, plus a new dev environment for working locally
- greatly improved documentation
- now supports integrations with third party component library (Material UI, Fluent UI etc.)
- bundle size now 72KB (previously 88KB)
Please report any issues here on github.
Check out the github pages section for the full documentation + example JSX code.
MIT