react-native-country-flag

This is a react-native package to display every 254 country flag with the ISO 3166-1 alpha-2 Standard!

!preview image


📖 Table of Contents

- ⬇️ Install package
- 💾 Flag Data (local or remote)
- 🚩 Flag component (props)>)
- 📝 License>)


 

⬇️ Install package

``bash
npm install --save react-native-country-flag
`

 

💾 Data

Data required for the countryflag component to work has been completely decoupled from the library. That gives developers the flexibility to better control their app bundle size and let them choose how and when this data is loaded. Data can be:

$3

- Pros: Data fetched only when needed, does not affect your app bundle size
- Cons: Network latency, doesn’t work offline

`js
import CountryFlag from "react-native-country-flag";


`

$3

🚧 Note: Still in progress (probely available in v2.1)

- Pros: Component renders instantly, data is available offline
- Cons: Does affect your app bundle size

`sh
npm install --save react-native-country-flag/data
`

`jsx
import CountryFlag from "react-native-country-flag";
import flags from "react-native-country-flag/data";


`


 

🚩 Flag component (props)

`js
import CountryFlag from "react-native-country-flag";


`

You can only use the ISO 3166-1 alpha-2 Standard for the isoCode property.

| Prop | Type | Desciption |
| ------- | :--------: | :---------------------------------------------------------------------------------------------------------------: |
| isoCode | String | Define the country flag with the ISO 3166-1 alpha-2 Standard. |
| size | Integer | Define the size from the country flag. |
| style | Stylesheet | Customize the style from the CountryFlag component. |
| flags | | Optional: pass bundeled flags CountryFlag` component. |


 

📝 License

MIT © Yannis Hofmann