Pakete, Repositories und App-Kategorien suchen

Paketdetailsv2.8.0

toml_localizations

Ein minimales TOML-Lokalisierungspaket, basierend auf LocalizationsDelegate.

AndroidiOSWebmacOSWindowsLinux
30-Tage-Downloads
94
Likes
3
Pub-Punkte
150

Paket installieren

flutter pub add toml_localizations

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Ein leichtgewichtiges Flutter-Paket zur Verwaltung von App-Übersetzungen mithilfe von TOML-Dateien (Tom's Obvious, Minimal Language). Auf Flutter's LocalizationsDelegate aufgebaut, ermöglicht es die einfache Integration lokalisierter Zeichenketten durch Laden von Schlüssel-Wert-Paaren aus TOML-Dateien. Das Paket unterstützt mehrere Sprachen und vereinfacht Übersetzungsworkflows mit einer sauberen, menschenlesbaren Formatierung. Ideal für Entwickler, die eine minimale, strukturierte Alternative zu JSON oder YAML für die Lokalisierung suchen. Es funktioniert auf allen wichtigen Flutter-Plattformen wie Android, iOS, Web, macOS, Windows und Linux.

Anwendungsfälle

  • Verwaltung mehrsprachigen App-Inhalts
  • Übersetzungen aus TOML-Dateien werden geladen
  • Einfachere Einrichtung der Lokalisierung in Flutter-Apps
  • Unterstützung der dynamischen Sprachwechsel
  • Integration strukturierter Textdateien für Übersetzungen

Hauptmerkmale

  • TOML-basierte Übersetzungsdateien
  • Minimale Abhängigkeitsspur
  • Auf LocalizationsDelegate aufgebaut
  • Plattformübergreifende Unterstützung
  • Einfach lesbare Konfigurationsformat
  • Automatische Lokalisierungserkennung

Geeignet für

  • Entwickler, die TOML gegenüber JSON/YAML bevorzugen
  • Projekte, die eine leichte Lokalisierung erfordern
  • Teams, die strukturierte Textformate verwenden
  • Apps, die mehrere Sprachen ansprechen
  • Flutter-Apps, die eine einfache Übersetzungsverwaltung benötigen

Hinweise

  • Benötigt manuelle Einrichtung von TOML-Dateien
  • Beschränkt auf grundlegende String-Übersetzungen
  • Keine integrierten Übersetzungs-Editoren
  • Die Analyse von TOML ist möglicherweise weniger vertraut als die von JSON
  • Nicht geeignet für komplexe Lokalisierungsstrukturen

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

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

Kategorien

Abhängigkeiten

Abhängigkeiten 1 Einträge

Quell-Repository

Projekte, die dieses Paket verwenden

Noch keine Daten verfügbar.