@icetoast/react-world-flags v2.0.2

Attention! This is a fork of react-world-flags and provides two alternative methods of usage which can greatly reduce bundle size when using ESM-friendly bundlers: Cherry-Picking and Raster Flags

react-world-flags

Easy to use SVG flags of the world for react

Demo

Installation

npm install --save @weston/react-world-flags

Usage

import Flag from '@weston/react-world-flags'

<Flag code={ code } />

Where code is the two letter, three letter or three digit country code.

You can also pass an optional fallback which renders if the given code doesn't correspond to a flag:

import Flag from '@weston/react-world-flags'

<Flag code="foo" fallback={ <span>Unknown</span> } />

All props but code and fallback are passed through to the rendered img

<Flag code="nor" height="16" />

// <img src="data:image/svg+xml..." height="16">

SVG's are inlined using Data_URIs.

Alternative Usage

By default, bundlers will include all flags provided by this library which will add about 1.2 MB gzipped to your application.

This fork (@weston/react-world-flags) provides two alternative methods of usage which can greatly reduce bundle size when using ESM-friendly bundlers: Cherry-Picking and Raster Flags

Option 1: Cherry-Picking

Import just the flags needed for your application. This is useful for scenarios in which you only need a small subset of available flags and don't need to look them up by country code. Unused flags should automatically be omitted by your bundler via static analysis (tree-shaking).

// Only import flags for USA and Canada
import { FlagUS, FlagCA } from '@weston/react-world-flags'

<FlagUS />
<FlagCA />

Option 2: Raster Flags

Substitute default SVG flags with raster versions for flags having large amounts of detail (highly detailed images are generally more compact when represented as bitmaps). This approach automatically replaces these flags with WebP versions which can significantly reduce bundle size. Use this for scenarios where your application still needs the entire catalog of flags but having flags of fixed size is acceptable (e.g. icons).

The following example will produce either an SVG or WebP (of height 128px) depending on which is more compact given a particular country's flag:

import { Flag128 as Flag } from '@weston/react-world-flags'

// Mexico's flag is detailed and always smaller as WebP
<Flag code="mx" />
// result: <img src="data:image/webp..." height="128">

// Japan's flag is simple and always smaller as SVG
<Flag code="jp" />
// result: <img src="data:image/svg+xml..." height="128">

// Still able to customize image height
<Flag code="mx" height="100" />
// result: <img src="data:image/webp..." height="100">

Rasters are available in 32px, 64px, 128px, 256px, and 512px versions (i.e. Flag32, Flag64, Flag128, Flag256, or Flag512).

Bundle Footprint