flag-icon-css

:flags: A collection of all country flags in SVG — plus the CSS for easier integration

Github stars Tracking Chart

flag-icon-css

A 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 Bower or NPM:

$ bower install flag-icon-css
$ npm install flag-icon-css

Usage

For using the flags inline with text add the classes .flag-icon and
.flag-icon-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 flag-icon-squared as well. Example:

<span class="flag-icon flag-icon-gr"></span>
<span class="flag-icon flag-icon-gr flag-icon-squared"></span>

You could also apply this to any element, but in that case you'll have to use the
flag-icon-background instead of flag-icon 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 npm install to install the dependencies after cloning the project and
you'll be able to:

To watch for changes and live reload if served

$ grunt

To build *.less files

$ grunt build

To serve it on localhost:8000

$ grunt connect

To have only specific countries in the css file, remove the ones that you don't
need from the
flag-icon-list.less
file and build it again.

Credits

This project wouldn't exist without the awesome and now deleted collection of
SVG flags by koppi.

Contributors

Code Contributors

This project exists thanks to all the people who contribute. [Contribute].

Financial Contributors

Become a financial contributor and help us sustain our community. [Contribute]

Individuals

Organizations

Support this project with your organization. Your logo will show up here with a link to your website. [Contribute]










Main metrics

Overview
Name With Ownerlipis/flag-icons
Primary LanguageHTML
Program languageCSS (Language Count: 6)
Platform
License:MIT License
所有者活动
Created At2013-09-25 16:39:58
Pushed At2025-07-15 16:55:18
Last Commit At
Release Count109
Last Release Namev7.5.0 (Posted on 2025-05-29 20:52:20)
First Release Name0.1.0 (Posted on )
用户参与
Stargazers Count11.4k
Watchers Count154
Fork Count1.9k
Commits Count1.2k
Has Issues Enabled
Issues Count620
Issue Open Count12
Pull Requests Count544
Pull Requests Open Count5
Pull Requests Close Count210
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private