lipis / flag-icons
A curated collection of all country flags in SVG — plus the CSS for easier integration.
Installs: 9 688
Dependents: 3
Suggesters: 0
Security: 0
Stars: 10 813
Watchers: 155
Forks: 1 867
Open Issues: 25
Language:CSS
- dev-main
- v7.2.3
- v7.2.2
- v7.2.1
- v7.2.0
- v7.1.0
- v7.0.3
- v7.0.2
- v7.0.1
- v7.0.0
- v6.15.0
- v6.14.0
- v6.13.2
- v6.13.1
- v6.13.0
- v6.12.0
- v6.11.2
- v6.11.1
- v6.11.0
- v6.10.1
- v6.10.0
- v6.9.5
- v6.9.4
- v6.9.3
- v6.9.2
- v6.9.1
- v6.9.0
- v6.8.0
- 3.5.0
- 3.4.6
- 3.4.5
- 3.4.4
- 3.4.3
- 3.4.2
- 3.4.1
- 3.4.0
- 3.3.0
- 3.2.1
- 3.2.0
- 3.1.0
- 3.0.0
- 2.9.0
- 2.8.0
- 2.7.0
- 2.6.0
- 2.5.0
- 2.4.0
- 2.3.1
- 2.3.0
- 2.2.0
- 2.1.0
- 2.0.0
- 1.4.0
- 1.3.0
- 1.2.0
- 1.1.0
- 1.0.0
- 0.8.6
- 0.8.5
- 0.8.4
- 0.8.3
- 0.8.2
- v0.8.1
- 0.8.0
- 0.7.1
- 0.7.0
- 0.6.5
- 0.6.4
- 0.6.3
- dev-dependabot/npm_and_yarn/prettier-3.4.2
- dev-dependabot/npm_and_yarn/sass-1.82.0
- dev-dependabot/npm_and_yarn/sass-1.81.0
This package is not auto-updated.
Last update: 2024-12-09 16:01:04 UTC
README
A curated collection of all country flags in SVG — plus the CSS for easier integration. See the demo.
Install
You can either download the whole project as is or install it via npm or Yarn:
npm install flag-icons
# or
yarn add flag-icons
Usage
First, you need to import css:
import "/node_modules/flag-icons/css/flag-icons.min.css";
or use CDN:
<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/lipis/flag-icons@7.2.3/css/flag-icons.min.css" />
For using the flags inline with text add the classes .fi
and .fi-xx
(where xx
is the ISO 3166-1-alpha-2 code of a country) to an empty <span>
. If you want to have a squared version flag then add the class fis
as well. Example:
<span class="fi fi-gr"></span> <span class="fi fi-gr fis"></span>
You could also apply this to any element, but in that case you'll have to use the fib
instead of fi
and you're set. This will add the correct background with the following CSS properties:
background-size: contain; background-position: 50%; background-repeat: no-repeat;
Which means that the flag is just going to appear in the middle of an element, so you will have to set manually the correct size of 4 by 3 ratio or if it's squared add also the flag-icon-squared
class.
Development
Run the yarn
to install the dependencies after cloning the project and you'll be able to:
To build *.scss
files
$ yarn build
To serve it on localhost:8000
$ yarn start
To have only specific countries in the css file, remove the ones that you don't need from the _flag-icons-list.scss
file and build it again.
Credits
- This project wouldn't exist without the awesome and now deleted collection of SVG flags by koppi.
- Thank you Andrejs Abrickis for providing the
flag-icons
name on npm.