language_info_plus 1.1.0

SDKflutter
Platformandroidioswindowslinuxmacosweb

A Flutter package that provides a comprehensive list of world languages with their ISO 639-1 codes, English names, and optional localized names based on the device's locale.

Language Info Plus Flutter Package

pub package Score Platform GitHub stars GitHub forks GitHub issues GitHub pull requests

language_info_plus is a Flutter package designed to provide a comprehensive list of world languages with localized names and ISO 639-1 codes. It helps developers display language information customized to the user's device locale.

demo

Features

  • Extensive Language Data: Access a wide range of languages with their ISO codes and English names.
  • Localization: Optionally load localized language names based on the device's locale.
  • Easy Integration: Simplified APIs to access all languages, the device language, or retrieve a language by its code.
  • Optional Initialization: Call initializeLanguage() in your app's main() to load localized language names.

Quick Start

Optional: Initialize Localized Language Names

If you want to use the localizedName field for languages, initialize it first by loading the appropriate JSON file based on the device's locale.

import 'package:language_info_plus/language_info_plus.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // IMPORTANT: Call this to load localized language names, if needed.
  await initializeLanguage();

  runApp(const MyApp());
}

Basic Usage

// Getting all available languages
List<Language> languages = LanguageInfoPlus.languages;
print('Total languages: ${languages.length}');

// Getting the device locale
Locale deviceLocale = LanguageInfoPlus.deviceLocale;
print('Device Locale: ${deviceLocale.toString()}');

// Getting the device language (based on locale)
Language deviceLanguage = LanguageInfoPlus.deviceLanguage;
print('Device Language: ${deviceLanguage.name}');

// Fetching a specific language by ISO 639-1 code
Language? languageEN = LanguageInfoPlus.getLanguageByCode('en');
print('Language Name: ${languageEN?.name}');
print('Localized Name: ${languageEN?.localizedName ?? "N/A"}');

Public API

The language_info_plus library provides a set of static methods and properties through the LanguageInfoPlus class:

APIReturn TypeDescription
LanguageInfoPlus.languagesList<Language>Returns a list of all available languages.
LanguageInfoPlus.deviceLocaleLocaleThe current device locale derived from WidgetsBinding.instance.platformDispatcher.locale.
LanguageInfoPlus.deviceLanguageLanguageMatches the device’s language code to a Language.
LanguageInfoPlus.getLanguageByCode(String languageCode)Language?Fetches a Language by its ISO 639-1 code (e.g., “en”, “ko”). Returns null if not found.
initializeLanguage()Future<void>Loads localized language names. Must be called before accessing localizedName. Recommended in main().

Language Model

Each language is represented by the Language class with the following properties:

PropertyTypeDescription
codeStringISO 639-1 code (e.g., en, ko).
nameStringEnglish name of the language (e.g., English, Korean).
localizedNameString?Localized name of the language (e.g., 한국어). Nullable if not initialized.

Example usage of Language:

// Assuming the device locale's language is zh.
final language = LanguageInfoPlus.getLanguageByCode('en');
if (language != null) {
  print('Code: ${language.code}'); // en
  print('Name: ${language.name}'); // English
  print('Localized Name: ${language.localizedName ?? "No localized name loaded"}'); // 英语
}

Contributions

Contributions are welcome! Please open issues and pull requests to improve this package.