NiceAppShell class

Adaptive app shell that provides:

  • Bottom navigation on mobile
  • Rail navigation on tablet
  • Sidebar navigation on desktop
NiceAppShell(
  items: [
    NiceNavItem(path: '/', icon: Icons.home, label: 'Home'),
    NiceNavItem(path: '/settings', icon: Icons.settings, label: 'Settings'),
  ],
  currentPath: currentPath,
  onNavigate: (path) => router.push(path),
  child: currentPage,
)
Inheritance
Available extensions

Constructors

NiceAppShell({Key? key, required List<NiceNavItem> items, required String currentPath, required ValueChanged<String> onNavigate, required Widget child, String? title, Widget? titleWidget, List<Widget> actions = const [], Widget? footer, Widget? userMenu, double sidebarWidth = 240, double railWidth = 72, bool showLabelsOnRail = false, bool enableDrawerOnMobile = true, PreferredSizeWidget? appBar})
const

Properties

actions → List<Widget>
final
appBar → PreferredSizeWidget?
final
child → Widget
final
currentPath → String
final
enableDrawerOnMobile → bool
final
final
hashCode → int
The hash code for this object.
no setterinherited
items → List<NiceNavItem>
final
key → Key?
Controls how one widget replaces another widget in the tree.
finalinherited
final
onNavigate → ValueChanged<String>
final
railWidth → double
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
showLabelsOnRail → bool
final
sidebarWidth → double
final
title → String?
final
titleWidget → Widget?
final
userMenu → Widget?
final

Methods

asFocusable({FocusNode? focusNode, bool autofocus = false}) → Widget

Available on Widget, provided by the NiceAccessibilityExtension extension

Mark this widget as focusable.
asSemanticButton({String? label, VoidCallback? onTap}) → Widget

Available on Widget, provided by the NiceAccessibilityExtension extension

Mark this widget as a button for screen readers.
asSemanticHeading(String label) → Widget

Available on Widget, provided by the NiceAccessibilityExtension extension

Mark this widget as a heading for screen readers.
createElement() → StatefulElement
Creates a StatefulElement to manage this widget's location in the tree.
inherited
createState() → State<NiceAppShell>
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
excludeFromSemantics() → Widget

Available on Widget, provided by the NiceAccessibilityExtension extension

Exclude this widget from the semantic tree.
mergeSemantics() → Widget

Available on Widget, provided by the NiceAccessibilityExtension extension

Merge semantics of child widgets.
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
withSemanticLabel(String label) → Widget

Available on Widget, provided by the NiceAccessibilityExtension extension

Add a semantic label to this widget.

Operators

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