CupertinoSliverNavigationBar class

An iOS-styled navigation bar with iOS-11-style large titles using slivers.

The CupertinoSliverNavigationBar must be placed in a sliver group such as the CustomScrollView.

This navigation bar consists of two sections, a pinned static section on top and a sliding section containing iOS-11-style large title below it.

It should be placed at top of the screen and automatically accounts for the iOS status bar.

Minimally, a largeTitle widget will appear in the middle of the app bar when the sliver is collapsed and transfer to the area below in larger font when the sliver is expanded.

For advanced uses, an optional middle widget can be supplied to show a different widget in the middle of the navigation bar when the sliver is collapsed.

Like CupertinoNavigationBar, it also supports a leading and trailing widget on the static section on top that remains while scrolling.

The leading widget will automatically be a back chevron icon button (or a close button in case of a fullscreen dialog) to pop the current route if none is provided and automaticallyImplyLeading is true (true by default).

The largeTitle widget will automatically be a title text from the current CupertinoPageRoute if none is provided and automaticallyImplyTitle is true (true by default).

When transitionBetweenRoutes is true, this navigation bar will transition on top of the routes instead of inside them if the route being transitioned to also has a CupertinoNavigationBar or a CupertinoSliverNavigationBar with transitionBetweenRoutes set to true. If transitionBetweenRoutes is true, none of the Widget parameters can contain any GlobalKeys in their subtrees since those widgets will exist in multiple places in the tree simultaneously.

By default, only one CupertinoNavigationBar or CupertinoSliverNavigationBar should be present in each PageRoute to support the default transitions. Use transitionBetweenRoutes or heroTag to customize the transition behavior for multiple navigation bars per route.

CupertinoSliverNavigationBar by default disables text scaling to match the native iOS behavior. To override this behavior, wrap each of the CupertinoSliverNavigationBar's components inside a MediaQuery with the desired TextScaler.

The stretch parameter determines whether the nav bar should stretch to fill the over-scroll area. The nav bar can still expand and contract as the user scrolls, but it will also stretch when the user over-scrolls if the stretch value is true. Defaults to false.

This example shows CupertinoSliverNavigationBar in action inside a CustomScrollView.
link

To create a local project with this code sample, run:
flutter create --sample=cupertino.CupertinoSliverNavigationBar.1 mysample

See also:

Inheritance

Constructors

CupertinoSliverNavigationBar({Key? key, Widget? largeTitle, Widget? leading, bool automaticallyImplyLeading = true, bool automaticallyImplyTitle = true, bool alwaysShowMiddle = true, String? previousPageTitle, Widget? middle, Widget? trailing, Border? border = _kDefaultNavBarBorder, Color? backgroundColor, bool automaticBackgroundVisibility = true, bool enableBackgroundFilterBlur = true, Brightness? brightness, EdgeInsetsDirectional? padding, bool transitionBetweenRoutes = true, Object heroTag = _defaultHeroTag, bool stretch = false})
Creates a navigation bar for scrolling lists.
const

Properties

alwaysShowMiddle → bool
Controls whether middle widget should always be visible (even in expanded state).
final
automaticallyImplyLeading → bool
Controls whether we should try to imply the leading widget if null.
final
automaticallyImplyTitle → bool
Controls whether we should try to imply the largeTitle widget if null.
final
automaticBackgroundVisibility → bool
Whether the navigation bar appears transparent when no content is scrolled under.
final
backgroundColor → Color?
The background color of the navigation bar. If it contains transparency, the tab bar will automatically produce a blurring effect to the content behind it. This behavior can be disabled by setting enableBackgroundFilterBlur to false.
final
border → Border?
The border of the navigation bar. By default renders a single pixel bottom border side.
final
brightness → Brightness?
The brightness of the specified backgroundColor.
final
enableBackgroundFilterBlur → bool
Whether to have a blur effect when a non-opaque background color is used.
final
hashCode → int
The hash code for this object.
no setterinherited
heroTag → Object
Tag for the navigation bar's Hero widget if transitionBetweenRoutes is true.
final
key → Key?
Controls how one widget replaces another widget in the tree.
finalinherited
largeTitle → Widget?
The navigation bar's title.
final
leading → Widget?
Widget to place at the start of the navigation bar. Normally a back button for a normal page or a cancel button for full page dialogs.
final
middle → Widget?
A widget to place in the middle of the static navigation bar instead of the largeTitle.
final
opaque → bool
True if the navigation bar's background color has no transparency.
no setter
padding → EdgeInsetsDirectional?
Padding for the contents of the navigation bar.
final
previousPageTitle → String?
Manually specify the previous route's title when automatically implying the leading back button.
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
stretch → bool
Whether the nav bar should stretch to fill the over-scroll area.
final
trailing → Widget?
Widget to place at the end of the navigation bar. Normally additional actions taken on the page such as a search or edit function.
final
transitionBetweenRoutes → bool
Whether to transition between navigation bars.
final

Methods

createElement() → StatefulElement
Creates a StatefulElement to manage this widget's location in the tree.
inherited
createState() → State<CupertinoSliverNavigationBar>
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