Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev2.8.0

toml_localizations

Um pacote de localização TOML mínimo construído sobre LocalizationsDelegate.

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
94
Curtidas
3
Pontos Pub
150

Instalar pacote

flutter pub add toml_localizations

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Um pacote leve do Flutter para gerenciar traduções de aplicativos usando arquivos TOML (Linguagem Obvia e Mínima de Tom). Construído sobre o LocalizationsDelegate do Flutter, permite a fácil integração de strings localizadas carregando pares chave-valor a partir de arquivos TOML. O pacote suporta múltiplos idiomas e simplifica os fluxos de tradução com uma formatação limpa e legível por humanos. Ideal para desenvolvedores que buscam uma alternativa mínima e estruturada ao JSON ou YAML para localização. Funciona em todas as principais plataformas do Flutter, incluindo Android, iOS, Web, macOS, Windows e Linux.

Casos de uso

  • Gerenciando conteúdo de aplicativo multilíngue
  • Carregando traduções de arquivos TOML
  • Simplificando a configuração de localização em aplicativos Flutter
  • Apoio à troca dinâmica de idioma
  • Integração de arquivos de texto estruturados para traduções

Principais recursos

  • arquivos de tradução baseados em TOML
  • Pé de dependência mínima
  • Construído no LocalizationsDelegate
  • Suporte multiplataforma
  • Formato de configuração fácil de ler
  • Detecção automática de localidade

Indicado para

  • Desenvolvedores que preferem TOML em vez de JSON/YAML
  • Projetos que exigem localização leve
  • Equipes usando formatos de texto estruturado
  • Aplicativos direcionados a múltiplos idiomas
  • Aplicativos Flutter que precisam de gerenciamento simples de tradução

Considerações

  • Requer configuração manual de arquivos TOML
  • Limitado a traduções básicas de strings
  • Nenhum ferramenta de edição de tradução integrada
  • A análise de TOML pode ser menos familiar do que a de JSON
  • Não adequado para estruturas de localização complexas

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

toml_localizations

A minimal TOML localization package for Flutter.

TOML is a minimal, easy to read, configuration file format, which allows you to represent strings (and other types) as key/value pairs.

Install

Add toml_localizations and flutter_localizations as dependencies to your pubspec.yaml.

dependencies:
  flutter_localizations:
    sdk: flutter
  toml_localizations: <last-version>
Add assets

Add a TOML file per language to a asset path and define it in your pubspec.yaml.

flutter:
  assets:
    - assets/toml_translations

The TOML file name must match exactly the combination of language and country code described in supportedLocales.

That is Locale('en', 'US') must have a corresponding assetPath/en-US.toml file.

Add localization delegate and supported locales

Add TomlLocalizationsDelegate to MaterialApp and set supportedLocales to supported language/country codes.

MaterialApp(
  localizationsDelegates: [
    // delegate from flutter_localization
    GlobalMaterialLocalizations.delegate,
    GlobalWidgetsLocalizations.delegate,
    GlobalCupertinoLocalizations.delegate,
    // toml localizations delegate
    TomlLocalizationsDelegate(path: 'assets/toml_translations')
  ],
  supportedLocales: [
    Locale('en', 'GB'),
    Locale('en', 'US'),
    Locale('en'),
    Locale('nb'),
  ],
}
Note on iOS

Add supported languages to ios/Runner/Info.plist as described here.

Example:

<key>CFBundleLocalizations</key>
<array>
	<string>en</string>
	<string>en-GB</string>
	<string>en-US</string>
	<string>nb</string>
</array>

Format

Example TOML file:

str = "The quick brown fox jumps over the lazy dog."

literal_str = 'C:\Users\nodejs\templates'

multiline_str = """\
The quick brown \
fox jumps over \
the lazy dog.\
"""

literal_multiline_str = '''
The first newline is
trimmed in raw strings.
   All other whitespace
   is preserved.
'''

list = [ 'one', 'two', 'three' ]

Tip: Toml supports several ways of expressing strings. See Toml documentation for more info.

API

Translate strings or other types using:

TomlLocalizations.of(context)!.value(this);

We keep the API simple, but you can easily add an extension method to String like this:

extension LocalizedString on String {
  String tr(BuildContext context) => TomlLocalizations.of(context)!.value(this);
}

Se you could translate strings like this:

'Hi'.tr(context)

Example

See example

Categorias

Dependências

Lista de dependências 1 itens

Repositório-fonte

Projetos que usam este pacote

Ainda não há dados.