https://github.com/lecoupa/vueflags
🇺🇸🇫🇷 One easy-to-use flag component for Vue.js with all ISO 3166-1 countries.
https://github.com/lecoupa/vueflags
nuxtjs vuejs
Last synced: 7 months ago
JSON representation
🇺🇸🇫🇷 One easy-to-use flag component for Vue.js with all ISO 3166-1 countries.
- Host: GitHub
- URL: https://github.com/lecoupa/vueflags
- Owner: LeCoupa
- License: mit
- Created: 2019-12-07T15:02:15.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2023-03-07T22:09:07.000Z (over 2 years ago)
- Last Synced: 2024-10-17T19:18:16.944Z (12 months ago)
- Topics: nuxtjs, vuejs
- Language: TypeScript
- Homepage: https://www.growthbunker.dev/vueflags
- Size: 2.73 MB
- Stars: 119
- Watchers: 6
- Forks: 37
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://www.npmjs.com/package/@growthbunker/vueflags)
[](https://npm-stat.com/charts.html?package=@growthbunker/vueflags)
[](http://isitmaintained.com/project/growthbunker/vueflags "Average time to resolve an issue")
[](http://isitmaintained.com/project/growthbunker/vueflags "Percentage of issues still open")
[](https://github.com/growthbunker/vueflags/blob/master/LICENSE)
[](https://app.netlify.com/sites/growthbunker/deploys)
## Documentation
You can browse the documentation for Vue Flags [on the website](https://www.growthbunker.dev/vueflags).
## Installation
```bash
npm install @growthbunker/vueflags
# Or if you prefer using yarn
yarn add @growthbunker/vueflags
```
### Vue.js
In your `main.js` file:
```js
import Vue from "vue"
import VueFlags from "@growthbunker/vueflags"
Vue.use(VueFlags)
```
### Nuxt.js
Create a new plugin in `plugins/vueflags.js`:
```js
import Vue from "vue"
import VueFlags from "@growthbunker/vueflags"
Vue.use(VueFlags)
```
Add this new plugin to `nuxt.config.js`.
```js
module.exports = {
// ...
plugins: [{ src: "@/plugins/vueflags.js" }];
}
```
### CDN
Get the latest version from [jsdelivr](https://www.jsdelivr.com/), and import the JavaScript file in your page.
```html
```
We recommend our users to lock Vue Flags's version when using CDN. Requesting the latest version (as opposed to "latest major" or "latest minor") is dangerous because major versions usually come with breaking changes. Only do this if you really know what you are doing. [Please refer to jsdelivr.com](https://www.jsdelivr.com/features) for more information.
## Icons
All the flags are available here. Copy them somewhere in your somewhere in your "public" or "static" folder. You will also have to set the icon path for the component to be able to find them (see package options and component props).
A huge thank you to the author for designing these flags.
## Example
Once the plugin is installed, you can use the component like this:
```html
```
## Contributing
You are more than welcome to contribute to Vue Flags. Just submit changes via pull request and I will review them before merging.
1. Fork it! 🤙
2. Create your feature branch: `git checkout -b my-new-feature`
3. Commit your changes: `git commit -am "Add some feature"`
4. Push to the branch: `git push origin my-new-feature`
5. Submit a pull request 👍
The documentation is available in the `docs` folder. The Vue Flags components are available in the `lib` folder.
## License
Vue Flags is [MIT licensed](LICENSE).