搜索插件、代码仓与 APP 分类

插件详情v2.0.5

flutter_localized_locales

提供 563 个区域设置的区域设置代码到名称映射的 Flutter 包。

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
65.6万
喜欢数
64
Pub 分数
150

安装插件

flutter pub add flutter_localized_locales

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

一个 Flutter 包,提供从区域设置代码到其可读名称的映射,支持 563 个区域设置。它通过使开发者能够在应用程序中显示本地化的语言和国家名称,简化了本地化工作,从而提升面向国际受众的用户体验。该包支持所有主要平台,包括 Android、iOS、Web、macOS、Windows 和 Linux。对于需要准确且一致的区域设置命名而无需手动管理数据的应用程序来说,它是理想选择。

适合场景

  • 在下拉菜单中显示本地化语言名称
  • 支持多语言应用界面
  • 使用可读的区域设置标签增强用户设置
  • 构建语言选择屏幕
  • 国际化应用元数据
  • 提供准确的国家和语言标签

主要特点

  • 563 语言环境代码到名称的映射
  • 跨平台兼容性
  • 简单 API 集成
  • 无外部依赖
  • 维护且最新
  • 在 GitHub 上开源

适合对象

  • 面向全球用户的App
  • 本地化密集型应用
  • 语言选择组件
  • 国际化用户界面元素
  • 寻求现成地区设置数据的开发者

使用建议

  • 不包括翻译或字符串
  • 需要额外的软件包才能实现完整的国际化
  • 区域设置名称是静态的,不可自定义
  • 不适用于运行时翻译
  • 仅限名称映射

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

flutter_localized_locales

pub package

flutter_localized_locales is a Flutter package which enables obtaining localized locale names from locale codes (ISO 639‑1) for 563 locales.

This package is based on the flutter_localized_countries package. Data is taken from https://github.com/umpirsky/locale-list.

Getting started

Adding the localizations delegate

This package bundles required assets and provides a LocalizationsDelegate for loading them. Specify localizationsDelegates for your MaterialApp, CupertinoApp, or WidgetsApp.

import 'package:flutter_localized_locales/flutter_localized_locales.dart';

void main() {
  runApp(MaterialApp(
    localizationsDelegates: [
      LocaleNamesLocalizationsDelegate(),
      // ... more localization delegates
    ],
    ...
  );

Usage

Locale name

LocaleNames.of(context)!.nameOf(String locale)

// Invalid locale string
print(LocaleNames.of(context)!.nameOf('zzzzz'));    // null

// On a device whose locale is English (en)
print(LocaleNames.of(context)!.nameOf('fr_CA'));   // French (Canada)

// On a device whose locale is Spanish (es)
print(LocaleNames.of(context)!.nameOf('fr_CA'));   // francés (Canadá)

// On a device whose locale isn't supported, an attempt is made to find a supported one
// e.g. for a device whose locale is German (United Kingdom), returns German (de) names
print(LocaleNames.of(context)!.nameOf('fr_CA'));   // Französisch (Kanada)

// On a device whose selected locale isn't supported, and no supported locale can be found,
// fallback to English (en) names. 
// You can specify a different fallback locale
// e.g. to fallback to Afrikaans (af) names instead of English
LocaleNamesLocalizationsDelegate(fallbackLocale: 'af')

Supported locales are listed in lib/locales.dart.

All locale names, sorted

LocaleNames.sortedByCode()

LocaleNames.sortedByName()

Respective locale names

LocaleNamesLocalizationsDelegate.nativeLocaleNames

For convenience, this package provides a map of locale codes to their respective locale names. This always returns the same data, irrespective of the device locale.

print(LocaleNamesLocalizationsDelegate.nativeLocaleNames);      // { ... af_ZA: Afrikaans (Suid-Afrika), ... ar: ال العربية السعودية) ...  as: অসমীয়া ... fr: Français ... en: English ... }

Known Bugs

所属分类

依赖

依赖清单 1 项

源码仓库

使用此插件的项目