react-select-country-list

This package take country-list as reference, and make it more friendly to react-select

Maps ISO 3166-1-alpha-2 codes to English country names and match react-select options props.

Uses data from https://www.iso.org/iso-3166-country-codes.html

Install

1npm install react-select-country-list --save

or

1yarn add react-select-country-list

Example

1import React, { useState, useMemo } from 'react'
2import Select from 'react-select'
3import countryList from 'react-select-country-list'
4
5function CountrySelector() {
6  const [value, setValue] = useState('')
7  const options = useMemo(() => countryList().getData(), [])
8
9  const changeHandler = value => {
10    setValue(value)
11  }
12
13  return <Select options={options} value={value} onChange={changeHandler} />
14}
15
16export default CountrySelector
17

Methods

All input is case-insensitive.

getValue(label)

Expects the English country name. Returns the code for that country. If not found, it returns undefined.

getLabel(value)

Expects a two-digit country code. Returns the name for that country. If not found, it returns undefined.

getValues()

Returns an array of all country codes.

getLabels()

Returns an array of all country names.

getValueList()

Returns a key-value object of all countries using the code as key.

getLabelList()

Returns a key-value object of all countries using the name as key.

getData()

Returns an array of all country information, in the same format as it gets imported.

setLabel(value, label)

Due to different perspectives among different regions, this method can help developers customize the label of specific country. What's more, it can be chained with another methods above.

Usage

1// Make 'Viet Nam' -> 'Vietnam'
2countries.setLabel('VN', 'Vietnam').getLabel('VN') // 'Vietnam'

setEmpty(label)

You may want an empty value option in the list, so here's the helper function for you. Again, it can be chained with another methods above.

Usage

1countries.setEmpty('Select a Country').getLabel('') // 'Select a Country'

We can even chain setLabel and setEmpty together to have list with an empty option and the modified label.

1countries.setLabel('VN', 'Vietnam').setEmpty('Select a Country').getLabel('VN') // 'Vietnam'

native()

You may want to display native name of countries, this is the method for you. The data source of native names can be found here

Usage

1countries.native().getLabel('TW') // 臺灣

License

MIT