WidgetsApp class

A convenience widget that wraps a number of widgets that are commonly required for an application.

One of the primary roles that WidgetsApp provides is binding the system back button to popping the Navigator or quitting the application.

It is used by both MaterialApp and CupertinoApp to implement base functionality for an app.

Find references to many of the widgets that WidgetsApp wraps in the "See also" section.

Constructors

WidgetsApp({Key? key, GlobalKey<NavigatorState>? navigatorKey, RouteFactory? onGenerateRoute, InitialRouteListFactory? onGenerateInitialRoutes, RouteFactory? onUnknownRoute, NotificationListenerCallback<NavigationNotification>? onNavigationNotification, List<NavigatorObserver> navigatorObservers = const <NavigatorObserver>[], String? initialRoute, PageRouteFactory? pageRouteBuilder, Widget? home, Map<String, WidgetBuilder> routes = const <String, WidgetBuilder>{}, TransitionBuilder? builder, String? title, GenerateAppTitle? onGenerateTitle, TextStyle? textStyle, required Color color, Locale? locale, Iterable<LocalizationsDelegate>? localizationsDelegates, LocaleListResolutionCallback? localeListResolutionCallback, LocaleResolutionCallback? localeResolutionCallback, Iterable<Locale> supportedLocales = const <Locale>[Locale('en', 'US')], bool showPerformanceOverlay = false, bool showSemanticsDebugger = false, bool debugShowWidgetInspector = false, bool debugShowCheckedModeBanner = true, ExitWidgetSelectionButtonBuilder? exitWidgetSelectionButtonBuilder, MoveExitWidgetSelectionButtonBuilder? moveExitWidgetSelectionButtonBuilder, TapBehaviorButtonBuilder? tapBehaviorButtonBuilder, Map<ShortcutActivator, Intent>? shortcuts, Map<Type, Action<Intent>>? actions, String? restorationScopeId, @Deprecated('Remove this parameter as it is now ignored. ' 'WidgetsApp never introduces its own MediaQuery; the View widget takes care of that. ' 'This feature was deprecated after v3.7.0-29.0.pre.') bool useInheritedMediaQuery = false}): Creates a widget that wraps a number of widgets that are commonly required for an application.
WidgetsApp.router({Key? key, RouteInformationProvider? routeInformationProvider, RouteInformationParser<Object>? routeInformationParser, RouterDelegate<Object>? routerDelegate, RouterConfig<Object>? routerConfig, BackButtonDispatcher? backButtonDispatcher, TransitionBuilder? builder, String? title, GenerateAppTitle? onGenerateTitle, NotificationListenerCallback<NavigationNotification>? onNavigationNotification, TextStyle? textStyle, required Color color, Locale? locale, Iterable<LocalizationsDelegate>? localizationsDelegates, LocaleListResolutionCallback? localeListResolutionCallback, LocaleResolutionCallback? localeResolutionCallback, Iterable<Locale> supportedLocales = const <Locale>[Locale('en', 'US')], bool showPerformanceOverlay = false, bool showSemanticsDebugger = false, bool debugShowWidgetInspector = false, bool debugShowCheckedModeBanner = true, ExitWidgetSelectionButtonBuilder? exitWidgetSelectionButtonBuilder, MoveExitWidgetSelectionButtonBuilder? moveExitWidgetSelectionButtonBuilder, TapBehaviorButtonBuilder? tapBehaviorButtonBuilder, Map<ShortcutActivator, Intent>? shortcuts, Map<Type, Action<Intent>>? actions, String? restorationScopeId, @Deprecated('Remove this parameter as it is now ignored. ' 'WidgetsApp never introduces its own MediaQuery; the View widget takes care of that. ' 'This feature was deprecated after v3.7.0-29.0.pre.') bool useInheritedMediaQuery = false}): Creates a WidgetsApp that uses the Router instead of a Navigator.

Properties

actions → Map<Type, Action<Intent>>?: The default map of intent keys to actions for the application.
final
backButtonDispatcher → BackButtonDispatcher?: A delegate that decide whether to handle the Android back button intent.
final
builder → TransitionBuilder?: A builder for inserting widgets above the Navigator or - when the WidgetsApp.router constructor is used - above the Router but below the other widgets created by the WidgetsApp widget, or for replacing the Navigator/Router entirely.
final
color → Color: The primary color to use for the application in the operating system interface.
final
debugShowCheckedModeBanner → bool: Turns on a little "DEBUG" banner in debug mode to indicate that the app is in debug mode. This is on by default (in debug mode), to turn it off, set the constructor argument to false. In release mode this has no effect.
final
debugShowWidgetInspector → bool: Turns on an overlay that enables inspecting the widget tree.
final
exitWidgetSelectionButtonBuilder → ExitWidgetSelectionButtonBuilder?: Builds the widget the WidgetInspector uses to exit selection mode.
final
hashCode → int: The hash code for this object.
no setterinherited
home → Widget?: The widget for the default route of the app (Navigator.defaultRouteName, which is /).
final
initialRoute → String?: The name of the first route to show, if a Navigator is built.
final
key → Key?: Controls how one widget replaces another widget in the tree.
finalinherited
locale → Locale?: The initial locale for this app's Localizations widget is based on this value.
final
localeListResolutionCallback → LocaleListResolutionCallback?: This callback is responsible for choosing the app's locale when the app is started, and when the user changes the device's locale.
final
localeResolutionCallback → LocaleResolutionCallback?: This callback is responsible for choosing the app's locale when the app is started, and when the user changes the device's locale.
final
localizationsDelegates → Iterable<LocalizationsDelegate>?: The delegates for this app's Localizations widget.
final
moveExitWidgetSelectionButtonBuilder → MoveExitWidgetSelectionButtonBuilder?: Builds the widget the WidgetInspector uses to move the exit selection mode button.
final
navigatorKey → GlobalKey<NavigatorState>?: A key to use when building the Navigator.
final
navigatorObservers → List<NavigatorObserver>?: The list of observers for the Navigator created for this app.
final
onGenerateInitialRoutes → InitialRouteListFactory?: The routes generator callback used for generating initial routes if initialRoute is provided.
final
onGenerateRoute → RouteFactory?: The route generator callback used when the app is navigated to a named route.
final
onGenerateTitle → GenerateAppTitle?: If non-null this callback function is called to produce the app's title string, otherwise title is used.
final
onNavigationNotification → NotificationListenerCallback<NavigationNotification>?: The callback to use when receiving a NavigationNotification.
final
onUnknownRoute → RouteFactory?: Called when onGenerateRoute fails to generate a route, except for the initialRoute.
final
pageRouteBuilder → PageRouteFactory?: The PageRoute generator callback used when the app is navigated to a named route.
final
restorationScopeId → String?: The identifier to use for state restoration of this app.
final
routeInformationParser → RouteInformationParser<Object>?: A delegate to parse the route information from the routeInformationProvider into a generic data type to be processed by the routerDelegate at a later stage.
final
routeInformationProvider → RouteInformationProvider?: A object that provides route information through the RouteInformationProvider.value and notifies its listener when its value changes.
final
routerConfig → RouterConfig<Object>?: An object to configure the underlying Router.
final
routerDelegate → RouterDelegate<Object>?: A delegate that configures a widget, typically a Navigator, with parsed result from the routeInformationParser.
final
routes → Map<String, WidgetBuilder>?: The application's top-level routing table.
final
runtimeType → Type: A representation of the runtime type of the object.
no setterinherited
shortcuts → Map<ShortcutActivator, Intent>?: The default map of keyboard shortcuts to intents for the application.
final
showPerformanceOverlay → bool: Turns on a performance overlay.
final
showSemanticsDebugger → bool: Turns on an overlay that shows the accessibility information reported by the framework.
final
supportedLocales → Iterable<Locale>: The list of locales that this app has been localized for.
final
tapBehaviorButtonBuilder → TapBehaviorButtonBuilder?: Builds the widget the WidgetInspector uses to change the default behavior when tapping on widgets in the app.
final
textStyle → TextStyle?: The default text style for Text in the application.
final
title → String?: A one-line description used by the device to identify the app for the user.
final
useInheritedMediaQuery → bool: Deprecated. This setting is now ignored.
final

Methods

createElement() → StatefulElement: Creates a StatefulElement to manage this widget's location in the tree.
inherited
createState() → State<WidgetsApp>: Creates the mutable state for this widget at a given location in the tree.
override
debugDescribeChildren() → List<DiagnosticsNode>: Returns a list of DiagnosticsNode objects describing this node's children.
inherited
debugFillProperties(DiagnosticPropertiesBuilder properties) → void: Add additional properties associated with the node.
inherited
noSuchMethod(Invocation invocation) → dynamic: Invoked when a nonexistent method or property is accessed.
inherited
toDiagnosticsNode({String? name, DiagnosticsTreeStyle? style}) → DiagnosticsNode: Returns a debug representation of the object that is used by debugging tools and by DiagnosticsNode.toStringDeep.
inherited
toString({DiagnosticLevel minLevel = DiagnosticLevel.info}) → String: A string representation of this object.
inherited
toStringDeep({String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug, int wrapWidth = 65}) → String: Returns a string representation of this node and its descendants.
inherited
toStringShallow({String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) → String: Returns a one-line detailed description of the object.
inherited
toStringShort() → String: A short, textual description of this widget.
inherited

Operators

operator ==(Object other) → bool: The equality operator.
inherited

Static Properties

debugAllowBannerOverride ↔ bool: If false, prevents the debug banner from being visible.
getter/setter pair
debugShowWidgetInspectorOverride ↔ bool: If true, forces the widget inspector to be visible.
getter/setter pair
defaultActions ↔ Map<Type, Action<Intent>>: The default value of WidgetsApp.actions.
getter/setter pair
defaultShortcuts → Map<ShortcutActivator, Intent>: Generates the default shortcut key bindings based on the defaultTargetPlatform.
no setter
showPerformanceOverlayOverride ↔ bool: If true, forces the performance overlay to be visible in all instances.
getter/setter pair