MaterialApp在上一篇文章讲到它是App程序中最重要的组件,可以构建出了app基本的轮廓、主题和色彩。下面我们来认识下它吧。
有一个TextStyle类型的属性_errorTextStyle 和ThemeMode枚举。以及下列一些属性
{
this.navigatorKey,
this.scaffoldMessengerKey,
this.home,
Map<String, WidgetBuilder> this.routes = const <String, WidgetBuilder>{},
this.initialRoute,
this.onGenerateRoute,
this.onGenerateInitialRoutes,
this.onUnknownRoute,
List<NavigatorObserver> this.navigatorObservers = const <NavigatorObserver>[],
this.builder,
this.title = '',
this.onGenerateTitle,
this.color,
this.theme,
this.darkTheme,
this.highContrastTheme,
this.highContrastDarkTheme,
this.themeMode = ThemeMode.system,
this.locale,
this.localizationsDelegates,
this.localeListResolutionCallback,
this.localeResolutionCallback,
this.supportedLocales = const <Locale>[Locale('en', 'US')],
this.debugShowMaterialGrid = false,
this.showPerformanceOverlay = false,
this.checkerboardRasterCacheImages = false,
this.checkerboardOffscreenLayers = false,
this.showSemanticsDebugger = false,
this.debugShowCheckedModeBanner = true,
this.shortcuts,
this.actions,
this.restorationScopeId,
this.scrollBehavior,
this.useInheritedMediaQuery = false,
}
属性较多,重点介绍常用属性:
title | 标题。在Android上,标题显示在任务管理器的应用程序快照上方,当用户按下“最近的应用程序”按钮时,会显示这些快照。在iOS上,无法使用此值。在web上,它用作页面标题,显示在浏览器的打开选项卡列表中 |
debugShowCheckedModeBanner | 在调试模式下打开一个小“DEBUG”横幅,模拟机(右上角)debug标记是否隐藏,默认true是显示 |
home | 应用程序默认路由的小部件([Navigator.defaultRouteName],即/)。 这是正常启动应用程序时首先显示的路由,除非指定了[initialRoute]。 如果home指定了,那么 routes属性中就不能再注册根路由,记不能有 {"/": (context) => 一个组件,} home 将会取代根路由。 如果[initialRoute]指定了路由则不显示home的部件而显示initialRoute路由;如果[initialRoute]指定的路由无法显示,又将会显示home的部件。 |
routes | 路由地址注册,将要跳转的页面的标识,在跳转的地方使用 Navigator.pushNamed(context, '/routName')就可以实现 |
initialRoute | 初始化路由的名称。如果有[navigator],则显示的是它,也是第一条路由。 默认为[dart:ui.PlatformDispatcher.defaultRouteName],这可能会被启动应用程序的代码覆盖。 只有在提供了路线(通过[home]、[routes]、[onGenerateRoute]或[onUnknownRoute])的情况下,才能构建[navigator];如果不是,[initialRoute]必须为null,[navigator]不得为null。 如果应用程序中initialRoute没有实现或者实现错误从而找不到相应的路由,那么将忽略指定的[initialRoute]指定路由,而使用“/”根路由或者使用[home]指定的部件。 如果[initialRoute]指定了路由则不显示home的部件而显示initialRoute路由,initialRoute路由“返回上一级页面”的操作将是返回到[home]指定的部件。 |
onGenerateRoute | 将应用导航到命名路由时使用的路由生成器回调。 |
onGenerateInitialRoutes | 如果提供了[initialRoute],则用于生成初始路由的路由生成器回调。 如果未设置此属性,则基础[Navigator.onGenerateInitialRoutes]将默认为[Navigator.defaultGenerateInitialRoutes]。 |
onUnknownRoute | 当[onGenerateRoute]无法生成路由(initialRoute除外)时调用。 此回调通常用于错误处理。例如,此回调可能始终生成一个“未找到”页面,描述未找到的路由。 |
theme | 此应用程序的材质小部件的默认视觉属性,如颜色、字体和形状。 还可以指定第二个[darkTheme(暗主题)][ThemeData(主题数据)]值,用于提供用户界面的暗版本。如果提供了[darkTheme(暗主题)],则[themeMode(主题模式)]将控制使用哪个主题。 此属性的默认值是[ThemeData.light()]。 |
navigatorKey | 构建[导航器]时要使用的键。 如果指定了[navigatorKey],则可以直接操作[Navigator],而无需首先通过[Navigator.of]:从[navigatorKey]获取[BuildContext],使用[GlobalKey.currentState]获取器。 如果更改,将创建一个新的[导航器],从而丢失过程中的所有应用程序状态;在这种情况下,还必须更改[navigatorObservers],因为以前的观察员将附加到以前的导航器。 只有当[onGenerateRoute]不为null时,才会生成[导航器];如果为null,[navigatorKey]也必须为null。 |
color | 操作系统界面中应用程序使用的主颜色。 例如,在Android上,这是应用程序切换器中应用程序使用的颜色。 |
useInheritedMediaQuery | 如果为true,则将使用继承的MediaQuery。如果它不可用,或者是错误的,那么将从窗口构建一个。 不能为null,默认为false。 |
ScrollBehavior | [滚动行为]描述[可滚动]小部件的行为。提供[滚动行为]可以设置应用程序中的默认[滚动物理],并管理[滚动条]和[发光或滚动指示器]等[可滚动]装饰。 如果为null,则默认为[材质CrollBehavior]。 |
记: