localize_and_translate
Flutter localization in easy steps
Share your love to this
❤️
Screenshots
Tutorial
Video
- Arabic : https://www.youtube.com/watch?v=nfDYussovfQ
- English : soon..
Methods
| Method | Job |
|---|---|
init() |
initialize things, before runApp() |
"word".tr() |
word translation - string extension |
translate('word') |
word translation |
translate('word',{"key":"value"}) |
word translation with replacement arguments |
setNewLanguage(context,newLanguage:'en',restart: true, remember: true,) |
change language |
isDirectionRTL() |
is Direction RTL check |
currentLanguage |
Active language code |
locale |
Active Locale |
locals() |
Locales list |
delegates |
Localization Delegates |
Installation
- add
.jsontranslation files as assets
- For example :
'assets/lang/ar.json'|'assets/lang/en.json' - structure should look like
{
"appTitle": "تطبيق تجريبى",
"buttonTitle": "English",
"textArea": "هذا مجرد نموذج للتأكد من اداء الأداة"
}
- define them as assets in pubspec.yaml
flutter:
assets:
- assets/lang/en.json
- assets/lang/ar.json
Initialization
- Add imports to main.dart
- Make
main()asyncand do the following - Ensure flutter activated
WidgetsFlutterBinding.ensureInitialized() - Initialize
await translator.init();with neccassry parameters - Inside
runApp()wrap entry class withLocalizedApp() - Note : make sure you define it's child into different place "NOT INSIDE"
import 'package:flutter/material.dart';
import 'package:localize_and_translate/localize_and_translate.dart';
main() async {
// if your flutter > 1.7.8 : ensure flutter activated
WidgetsFlutterBinding.ensureInitialized();
await translator.init(
localeType: LocalizationDefaultType.device,
languagesList: <String>['ar', 'en'],
assetsDirectory: 'assets/lang/',
);
runApp(
LocalizedApp(
child: MyApp(),
),
);
}
LocalizedApp()child example ->MaterialApp()
class MyApp extends StatefulWidget {
@override
_MyAppState createState() => _MyAppState();
}
class _MyAppState extends State<MyApp> {
@override
Widget build(BuildContext context) {
return MaterialApp(
home: Home(),
localizationsDelegates: translator.delegates, // Android + iOS Delegates
locale: translator.locale, // Active locale
supportedLocales: translator.locals(), // Locals list
);
}
}
Usage
- use
translate("appTitle") - use
setNewLanguage(context, newLanguage: 'ar', remember: true, restart: true);
class Home extends StatelessWidget {
@override
Widget build(BuildContext context) {
return Scaffold(
drawer: Drawer(),
appBar: AppBar(
title: Text('appTitle'.tr()),
// centerTitle: true,
),
body: Container(
width: double.infinity,
child: Column(
crossAxisAlignment: CrossAxisAlignment.center,
mainAxisAlignment: MainAxisAlignment.spaceAround,
children: <Widget>[
SizedBox(height: 50),
Text(
'textArea'.tr(),
textAlign: TextAlign.center,
style: TextStyle(fontSize: 35),
),
OutlineButton(
onPressed: () {
translator.setNewLanguage(
context,
newLanguage: translator.currentLanguage == 'ar' ? 'en' : 'ar',
remember: true,
restart: true,
);
},
child: Text('buttonTitle'.tr()),
),
],
),
),
);
}
}
Contributors
thanks in advance
3 Oct 24, 2022
49 Oct 18, 2022
138 Dec 15, 2022
56 Nov 5, 2022
5 Oct 21, 2022
1 Nov 23, 2022
13 Nov 23, 2022
2 Mar 7, 2022
214 Jan 9, 2023
1 Mar 8, 2022
3 Mar 24, 2022
16 Oct 25, 2022
81 Jan 1, 2023
55 Sep 15, 2022
1 Jan 5, 2022
150 Jan 7, 2023
12 Nov 3, 2022
0 Jan 1, 2022
497 Dec 21, 2022