dash_flags 0.0.2

dash_flags: ^0.0.2 copied to clipboard

Dash Flags

💡 Overview #

A Flutter package for displaying Countries and Languages flags 🌍

This package provides a set of widgets and enums to display flags of countries and languages inspired by blade-flags package for Laravel by Mohamed Ashraf from Egypt.

The package uses flags from TwEmoji Countries & Languages Flags by Twitter

This GIF is taken from the Example Project

💻 Usage #

Import the package:

import 'package:dash_flags/dash_flags.dart';

Display a flag of a country:

CountryFlag(
  country: Country.eg, // You can also use Country.fromCode('eg')
  height: 50,
)

Display a flag of a language:

LanguageFlag(
  language: Language.ar, // You can also use Language.fromCode('ar')
  height: 50,
)

📘 You can checkout the complete API Reference here

📃 Notes #

• If you have the Country Code or Language Code as Strings, then you can use Country.fromCode(countryCode) or Language.fromCode(languageCode).
• If the the Country Code or Language Code consists of more than one part, then you will find it separated by an underscore, for example: sh_ac and en_au.
• If the the Country Code or Language Code is a reserved keyword in Dart, then you will find it prefixed with c_ or l_ respectively, for example: c_as and l_as.
• If an unknown Country Code or Language Code used with .fromCode(String) method, an unknown flag would be displayed.

✅ Roadmap #

• ❌ Add Tests 🧪
• ❌ Add a simple way to use the raw svg assets 🎨
• ❌ Make an online Gallery with all the available flags 📘
• ❌ Add the ability to use the flags from the internet, such as, CountryFlag.network(...) 🌐
• ❌ Add the ability to automatically detect the current Country or Language, such as, Country.autoDetect & Language.autoDetect 🕵🏻‍♂️

❤ Laravel Version #

If you are looking for a Laravel Version of this package, check blade-flags, the original parent package of this library which that provides a set of flags for all countries and languages by Mohamed Ashraf from Egypt.

💪🏻 Contribution Guide #

I would be happy to have your contributions 💙

If you find a bug or want a feature, but don't know how to fix/implement it, please fill an Issue.
If you fixed a bug or implemented a feature, please send a Pull Request.

Made with contrib.rocks.