intl_messages 1.1.9

Dart native js
Flutter Android iOS web

Simple and easy internationalization and localization messages.

intl_messages #

pub package CI GitHub Tag New Commits Last Commits Pull Requests Code size License Funding Funding

A Simple and easy library for Message Internationalization and Localization (I18N).

Main features:

  • Structure of messages by package/module.

  • Dynamic load of assets/files of messages.

  • Global notification of locale change and registration/discovery of localized messages.

Usage #

A simple usage example:

  • Internationalization file msgs-en.intl:

      hello=Hello world! ## A description of the key.
    
  • Internationalization file msgs-fr.intl:

      hello=Bonjour le monde!
    
  • Dart code:

      import 'package:intl_messages/intl_messages.dart';
    
      main() async {
    
          var messages = IntlMessages.package("demo");
    
          IntlResourceDiscover discover = IntlResourceDiscover("assets/msgs-", ".intl") ;
          await messages.registerResourceDiscover(discover) ; // Default locale: 'en'. Discovered: assets/msgs-en.intl
    
          MessageBuilder msgHello = messages.msg("hello") ;
    
          print( msgHello.build() ) ; // Hello world!
    
          await messages.setLocale( 'fr' ) ; // Locale set to: 'fr'. Discovered: assets/msgs-fr.intl
    
          print( msgHello.build() ) ; // Bonjour le monde!
    
      }
    

Plurals: #

Yes we have plurals ;-)

To use plurals you should declare messages using {...} blocks with conditions zero, one, two and many and respective variable name.

Here's an example of plural usage with variable n:

  • Internationalization file msgs-en.intl:

      total_emails={zero[n]:No e-mails for \$user.|one[n]:One e-mail for \$user.|two[n]:A pair of e-mails for \$user.|many[n]:Received \$n e-mails for \$user.}
    
  • Dart code:

      import 'package:intl_messages/intl_messages.dart';
    
      main() async {
    
          var messages = IntlMessages.package("demo-plural");
    
          IntlResourceDiscover discover = IntlResourceDiscover("assets/msgs-", ".intl") ;
          await messages.registerResourceDiscover(discover) ; // Default locale: 'en'. Discovered: assets/msgs-en.intl
    
          MessageBuilder msgEmail = messages.msg("total_emails") ;
    
          print( msgEmail.build({'n': 0, 'user': 'john@mail.com'}) ) ; // No e-mails for john@mail.com.
          print( msgEmail.build({'n': 1, 'user': 'john@mail.com'}) ) ; // One e-mail for john@mail.com.
          print( msgEmail.build({'n': 2, 'user': 'john@mail.com'}) ) ; // A pair of e-mails for john@mail.com.
          print( msgEmail.build({'n': 8, 'user': 'john@mail.com'}) ) ; // Received 8 e-mails for john@mail.com.
    
      }
    

Features and bugs #

Please file feature requests and bugs at the issue tracker.

Author #

Graciliano M. Passos: gmpassos@GitHub.

License #

Dart free & open-source license.

2
likes
100
pub points
44%
popularity

Simple and easy internationalization and localization messages.

Repository (GitHub)
View/report issues

Documentation

API reference

Uploader

gracilianomp@gmail.com

License

BSD (LICENSE)

Dependencies

enum_to_string, intl, resource_portable, swiss_knife

More

Packages that depend on intl_messages