SettingsTemplate class

A complete settings screen template.

Renders a scrollable list of SettingsGroups inside a Scaffold with an optional app bar, search action and footer. Rows are standard SettingsTiles so switches, sliders and pickers can be placed in the trailing slot.

SettingsTemplate(
  title: 'Settings',
  onSearch: () {},
  groups: <SettingsGroup>[
    SettingsGroup(
      title: 'Preferences',
      tiles: <SettingsTile>[
        SettingsTile(
          title: 'Notifications',
          icon: Icons.notifications_outlined,
          trailing: Switch(value: true, onChanged: (_) {}),
        ),
      ],
    ),
  ],
)

Inheritance

• Object
• DiagnosticableTree
• Widget
• StatelessWidget
• SettingsTemplate

Available extensions

• WidgetAnimateX
• WidgetX

Constructors

SettingsTemplate({Key? key, required String title, List<SettingsGroup> groups = const <SettingsGroup>[], String? subtitle, VoidCallback? onBack, VoidCallback? onSearch, Widget? header, Widget? footer, PreferredSizeWidget? appBar, Color? backgroundColor})

const

Properties

appBar → PreferredSizeWidget?

Custom app bar (overrides the default one).

final

backgroundColor → Color?

Scaffold background color.

final

centered → Widget

Available on Widget, provided by the WidgetX extension

Wraps the widget in a Center.

no setter

footer → Widget?

Widget shown at the bottom of the list.

final

groups → List<SettingsGroup>

Settings groups.

final

hashCode → int

The hash code for this object.

no setter, inherited

header → Widget?

Widget shown below the app bar (banner / account header).

final

key → Key?

Controls how one widget replaces another widget in the tree.

final, inherited

onBack → VoidCallback?

Shows a back button and pops the navigator when tapped.

final

onSearch → VoidCallback?

Shows a search action in the app bar.

final

repaint → Widget

Available on Widget, provided by the WidgetX extension

Wraps in RepaintBoundary to isolate repaints.

no setter

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

subtitle → String?

Optional app bar subtitle.

final

title → String

App bar title.

final

Methods

animatedSwitcher({Duration duration = const Duration(milliseconds: 300), AnimatedSwitcherTransitionBuilder transitionBuilder = _defaultAnimatedSwitcherTransition, AnimatedSwitcherLayoutBuilder layoutBuilder = AnimatedSwitcher.defaultLayoutBuilder}) → Widget

Available on Widget, provided by the WidgetX extension

Wraps in an AnimatedSwitcher with duration and default fade.

build(BuildContext context) → Widget

Describes the part of the user interface represented by this widget.

override

createElement() → StatelessElement

Creates a StatelessElement to manage this widget's location in the tree.

inherited

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

expanded({int flex = 1}) → Widget

Available on Widget, provided by the WidgetX extension

Expands the widget inside a Flex parent.

fadeIn({double opacity = 1, Duration duration = const Duration(milliseconds: 300), Curve curve = Curves.easeIn}) → Widget

Available on Widget, provided by the WidgetAnimateX extension

Wraps in an AnimatedOpacity.

flexible({int flex = 1, FlexFit fit = FlexFit.loose}) → Widget

Available on Widget, provided by the WidgetX extension

Applies flexible sizing.

keyed(Object key) → Widget

Available on Widget, provided by the WidgetX extension

Wraps the widget in a KeyedSubtree with key.

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

onTap(VoidCallback onTap, {HitTestBehavior behavior = HitTestBehavior.opaque}) → Widget

Available on Widget, provided by the WidgetX extension

Wraps the widget in GestureDetector with onTap.

pad({double horizontal = 0, double vertical = 0}) → Widget

Available on Widget, provided by the WidgetX extension

Applies symmetric padding.

padded([double padding = AppSpacing.lg]) → Widget

Available on Widget, provided by the WidgetX extension

Applies uniform padding.

scaleOnTap({double scale = 0.95, required VoidCallback onTap, Duration duration = const Duration(milliseconds: 150)}) → Widget

Available on Widget, provided by the WidgetAnimateX extension

Wraps in an AnimatedScale.

semantics({required String label, bool button = false}) → Widget

Available on Widget, provided by the WidgetX extension

Wraps in a Semantics node with label.

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

visible({bool condition = true}) → Widget

Available on Widget, provided by the WidgetX extension

Hides the widget entirely when condition is false.

withPadding(EdgeInsetsGeometry padding) → Widget

Available on Widget, provided by the WidgetX extension

Applies padding only.

Operators

operator ==(Object other) → bool

The equality operator.

inherited