zooper_flutter_localization #

A simple localization library which aims to have multiple localization files. This lib is aimed to work with get_it or injectable, but it should works for any other framework.

Example #

This example aims to use this package with injectable, but you should be able to implement it with any other framework, or even without

Importing #

Add this line to your pubspec.yaml:

zooper_flutter_localization: <latest>

and inside your dart class:

import 'package:zooper_flutter_localization/zooper_flutter_localization.dart';

Registering with injectable #

If you want to register a localizer for a specific View (better use ViewModels if you use the MVVM Pattern), you can define a Module with injectable:

import 'package:injectable/injectable.dart';
import 'package:zooper_flutter_localization/zooper_flutter_localization.dart';

@module
abstract class LocalizationModule {
  LocalizationService get localizationService;

  // Register a named localization
  @preResolve
  @Named('Titles')
  Future<ZooperLocalizer> titlesLocalizations(LocalizationService localizationService) =>
      localizationService.loadAsync('assets/localizations/titles.csv');

  // Register an other named localization
  @preResolve
  @Named('Errors')
  Future<ZooperLocalizer> errorsLocalizations(LocalizationService localizationService) =>
      localizationService.loadAsync('assets/localizations/errors.csv');

  // Register an unnamed localization but with an explicit type
  @preResolve
  Future<ZooperLocalizer<MainViewModel>> viewModelLocalizations(LocalizationService localizationService) =>
      localizationService.loadAsync('assets/localizations/errors.csv');
}

This registers a ZooperLocalizer and loads the translations from the defined file. Then you can inject it easily:

class TestView {
  final ZooperLocalizer<TestViewModel> _localizer;

  TestView(this._localizer);
}

or

class TestView {
  final ZooperLocalizer _localizer;

  TestView(@Named('YourName') this._localizer);
}

Accessing a translation #

This can be done in multiple ways. Easist is this:

_localizer['Hello'];

but you can do also:

_localizer.getLocalization('Hello');

or with a specific locale:

_localizer.getLocalizationByLocale('Hello', Locale('de', 'DE'))