CupertinoTabBar 需要 Localizations 父级
概述
#CupertinoTabBar
的实例必须有一个 Localizations
父级,以便提供本地化的 Semantics
提示。尝试在没有本地化的情况下实例化 CupertinoTabBar
会导致如下断言错误:
CupertinoTabBar requires a Localizations parent in order to provide an appropriate Semantics hint
for tab indexing. A CupertinoApp provides the DefaultCupertinoLocalizations, or you can
instantiate your own Localizations.
'package:flutter/src/cupertino/bottom_tab_bar.dart':
Failed assertion: line 213 pos 7: 'localizations != null'
背景
#为了支持本地化的语义信息,CupertinoTabBar
需要本地化。
在此更改之前,提供给 CupertinoTabBar
的 Semantics
提示是一个硬编码的字符串,即 'tab, $index of $total'。语义提示的内容也从这个原始字符串更新为英文的 'Tab $index of $total'。
如果您的 CupertinoTabBar
在 CupertinoApp
的范围内,DefaultCupertinoLocalizations
已经实例化,并且可能适合您的需求,而无需更改现有代码。
如果您的 CupertinoTabBar
不在 CupertinoApp
中,您可以使用 Localizations
小部件提供您选择的本地化。
迁移指南
#如果您看到 'localizations != null'
断言错误,请确保已向您的 CupertinoTabBar
提供区域设置信息。
迁移前的代码
dart
import 'package:flutter/cupertino.dart';
void main() => runApp(Foo());
class Foo extends StatelessWidget {
@override
Widget build(BuildContext context) {
return MediaQuery(
data: const MediaQueryData(),
child: CupertinoTabBar(
items: const <BottomNavigationBarItem>[
BottomNavigationBarItem(
icon: Icon(CupertinoIcons.add_circled),
label: 'Tab 1',
),
BottomNavigationBarItem(
icon: Icon(CupertinoIcons.add_circled_solid),
label: 'Tab 2',
),
],
currentIndex: 1,
),
);
}
}
迁移后的代码(通过 CupertinoApp
提供本地化)
dart
import 'package:flutter/cupertino.dart';
void main() => runApp(Foo());
class Foo extends StatelessWidget {
@override
Widget build(BuildContext context) {
return CupertinoApp(
home: CupertinoTabBar(
items: const <BottomNavigationBarItem>[
BottomNavigationBarItem(
icon: Icon(CupertinoIcons.add_circled),
label: 'Tab 1',
),
BottomNavigationBarItem(
icon: Icon(CupertinoIcons.add_circled_solid),
label: 'Tab 2',
),
],
currentIndex: 1,
),
);
}
}
迁移后的代码(通过使用 Localizations
小部件提供本地化)
dart
import 'package:flutter/cupertino.dart';
void main() => runApp(Foo());
class Foo extends StatelessWidget {
@override
Widget build(BuildContext context) {
return Localizations(
locale: const Locale('en', 'US'),
delegates: <LocalizationsDelegate<dynamic>>[
DefaultWidgetsLocalizations.delegate,
DefaultCupertinoLocalizations.delegate,
],
child: MediaQuery(
data: const MediaQueryData(),
child: CupertinoTabBar(
items: const <BottomNavigationBarItem>[
BottomNavigationBarItem(
icon: Icon(CupertinoIcons.add_circled),
label: 'Tab 1',
),
BottomNavigationBarItem(
icon: Icon(CupertinoIcons.add_circled_solid),
label: 'Tab 2',
),
],
currentIndex: 1,
),
),
);
}
}
时间线
#发布版本:1.18.0-9.0.pre
稳定版本:1.20.0
参考资料
#API 文档
相关 PR