// =========================================================================
// lib/ex21_i18n/main.dart - 一个双语应用
// -------------------------------------------------------------------------
// - 应用的文本(TEXTS):字典(translations.dart),
// 通过 provider 提供给所有界面(见示例 20);
// - 日期和金额:intl 包,使用当前语言
// (见示例 09);
// - Flutter 自身(ITSELF)的文本(日历、它的按钮……):
// flutter_localizations 包的本地化 "delegates",
// 它们跟随 MaterialApp 的 locale 属性。
// 切换语言会重新翻译整个界面,无需重启。
// =========================================================================
import 'package:flutter/material.dart';
import 'package:flutter_localizations/flutter_localizations.dart';
import 'package:intl/date_symbol_data_local.dart';
import 'package:intl/intl.dart';
import 'package:provider/provider.dart';
import 'package:shared_preferences/shared_preferences.dart';
import 'translations.dart';
// RdvMedecins 服务器会返回的内容(见关于黑盒的一章)
const serverResponses = [
(statusCode: 409, key: 'ERRORS.LOGIN_TAKEN', params: <String, String>{}),
(statusCode: 429, key: 'ERRORS.TOO_MANY_ATTEMPTS', params: {'minutes': '15'}),
];
// context.t('KEY'):一个快捷方式,通过 BuildContext 的扩展实现
extension Translate on BuildContext {
String t(String key, [Map<String, Object?> params = const {}]) => watch<Translations>().t(key, params);
}
Future<void> main() async {
WidgetsFlutterBinding.ensureInitialized();
await initializeDateFormatting();
final translations = Translations('ex21', await SharedPreferences.getInstance());
await translations.start();
runApp(ChangeNotifierProvider.value(value: translations, child: const Application()));
}
class Application extends StatelessWidget {
const Application({super.key});
@override
Widget build(BuildContext context) {
return MaterialApp(
debugShowCheckedModeBanner: false,
// onGenerateTitle:应用的标题,已翻译
onGenerateTitle: (context) => context.t('APP.TITLE'),
theme: ThemeData(colorSchemeSeed: Colors.indigo),
locale: Locale(context.watch<Translations>().language),
supportedLocales: [for (final l in languages) Locale(l)],
localizationsDelegates: GlobalMaterialLocalizations.delegates,
home: const TranslatedPage(),
);
}
}
class TranslatedPage extends StatefulWidget {
const TranslatedPage({super.key});
@override
State<TranslatedPage> createState() => _TranslatedPageState();
}
class _TranslatedPageState extends State<TranslatedPage> {
int _count = 2;
final _today = DateTime.now();
@override
Widget build(BuildContext context) {
final translations = context.watch<Translations>();
final language = translations.language;
// 使用当前(CURRENT)语言的格式化器
final date = DateFormat.yMMMMEEEEd(language).format(_today);
final price = NumberFormat.currency(locale: language, name: 'EUR', symbol: '€').format(1234.5);
return Scaffold(
appBar: AppBar(
title: Text(context.t('APP.TITLE')),
actions: [
// 语言:"分段" 按钮
Padding(
padding: const EdgeInsets.only(right: 8),
child: SegmentedButton<String>(
showSelectedIcon: false,
segments: [for (final l in languages) ButtonSegment(value: l, label: Text(l.toUpperCase()))],
selected: {language},
onSelectionChanged: (choice) => translations.changeLanguage(choice.first),
),
),
],
),
body: ListView(
padding: const EdgeInsets.all(16),
children: [
Card(
child: Padding(
padding: const EdgeInsets.all(12),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(context.t('HOME.HELLO', {'name': 'Marie'})),
Text(context.t('HOME.TODAY', {'date': date})),
Text(context.t('HOME.PRICE', {'price': price})),
const SizedBox(height: 8),
// count:选择复数形式,并替换 {{count}}
Text(
context.t('HOME.APPOINTMENTS', {'count': _count}),
style: const TextStyle(fontWeight: FontWeight.bold),
),
Wrap(
spacing: 8,
children: [
TextButton(onPressed: () => setState(() => _count++), child: Text(context.t('HOME.ADD'))),
TextButton(
onPressed: _count == 0 ? null : () => setState(() => _count--),
child: Text(context.t('HOME.REMOVE')),
),
],
),
// Flutter 的日历:它的文本跟随 MaterialApp 的语言
OutlinedButton.icon(
icon: const Icon(Icons.calendar_month),
label: Text(context.t('HOME.CALENDAR')),
onPressed: () =>
showDatePicker(context: context, firstDate: DateTime(2026), lastDate: DateTime(2027, 12, 31)),
),
],
),
),
),
Card(
child: Padding(
padding: const EdgeInsets.all(12),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(context.t('SERVER.TITLE'), style: Theme.of(context).textTheme.titleSmall),
Text(context.t('SERVER.EXPLANATION')),
const SizedBox(height: 8),
// 服务器的键就是字典中的一个键;params 提供它的参数
for (final r in serverResponses) ...[
Text('${r.statusCode} ${r.key}', style: const TextStyle(fontFamily: 'RobotoMono', fontSize: 12)),
Text('→ ${context.t(r.key, r.params)}'),
const SizedBox(height: 6),
],
],
),
),
),
],
),
);
}
}