TResult class

An operation result / status presentation widget.

Used to communicate the outcome of a significant user workflow (e.g. checkout success, 403 forbidden access, 404 not found, or 500 internal server failure). Can be displayed standalone as a full screen, or embedded inside cards and modal sheets.

Inheritance

• Object
• DiagnosticableTree
• Widget
• StatelessWidget
• TResult

Available extensions

• WidgetX

Constructors

TResult({Key? key, String? title, Widget? titleWidget, String? subtitle, Widget? subtitleWidget, TResultStatus status = TResultStatus.info, dynamic icon, Color? iconColor, double iconSize = 64.0, Widget? primaryAction, Widget? secondaryAction, Widget? extra, bool fullPage = false, bool docked = false, EdgeInsetsGeometry padding = const EdgeInsets.all(32.0)})

const

TResult.error({Key? key, String? title = 'Operation Failed', Widget? titleWidget, String? subtitle = 'Please check your input parameters and try again.', Widget? subtitleWidget, dynamic icon, Color? iconColor, double iconSize = 64.0, Widget? primaryAction, Widget? secondaryAction, Widget? extra, bool fullPage = false, bool docked = false, EdgeInsetsGeometry padding = const EdgeInsets.all(32.0)})

Generic error outcome preset (red alert icon).

const

TResult.forbidden({Key? key, String? title = '403 Forbidden', Widget? titleWidget, String? subtitle = 'Sorry, you do not have permission to access this resource.', Widget? subtitleWidget, dynamic icon, Color? iconColor, double iconSize = 64.0, Widget? primaryAction, Widget? secondaryAction, Widget? extra, bool fullPage = false, bool docked = false, EdgeInsetsGeometry padding = const EdgeInsets.all(32.0)})

403 Forbidden preset (security shield lock).

const

TResult.info({Key? key, String? title = 'Notice', Widget? titleWidget, String? subtitle, Widget? subtitleWidget, dynamic icon, Color? iconColor, double iconSize = 64.0, Widget? primaryAction, Widget? secondaryAction, Widget? extra, bool fullPage = false, bool docked = false, EdgeInsetsGeometry padding = const EdgeInsets.all(32.0)})

Informational outcome preset (blue info circle).

const

TResult.notFound({Key? key, String? title = '404 Not Found', Widget? titleWidget, String? subtitle = 'Sorry, the requested page or data record does not exist.', Widget? subtitleWidget, dynamic icon, Color? iconColor, double iconSize = 64.0, Widget? primaryAction, Widget? secondaryAction, Widget? extra, bool fullPage = false, bool docked = false, EdgeInsetsGeometry padding = const EdgeInsets.all(32.0)})

404 Not Found preset (missing route/entity search).

const

TResult.serverError({Key? key, String? title = '500 Server Error', Widget? titleWidget, String? subtitle = 'Internal system error occurred. Our engineering team has been notified.', Widget? subtitleWidget, dynamic icon, Color? iconColor, double iconSize = 64.0, Widget? primaryAction, Widget? secondaryAction, Widget? extra, bool fullPage = false, bool docked = false, EdgeInsetsGeometry padding = const EdgeInsets.all(32.0)})

500 Internal Server Error preset (cloud error breakdown).

const

TResult.success({Key? key, String? title = 'Successfully Completed', Widget? titleWidget, String? subtitle, Widget? subtitleWidget, dynamic icon, Color? iconColor, double iconSize = 64.0, Widget? primaryAction, Widget? secondaryAction, Widget? extra, bool fullPage = false, bool docked = false, EdgeInsetsGeometry padding = const EdgeInsets.all(32.0)})

Success outcome preset (green checkmark).

const

TResult.warning({Key? key, String? title = 'Warning', Widget? titleWidget, String? subtitle, Widget? subtitleWidget, dynamic icon, Color? iconColor, double iconSize = 64.0, Widget? primaryAction, Widget? secondaryAction, Widget? extra, bool fullPage = false, bool docked = false, EdgeInsetsGeometry padding = const EdgeInsets.all(32.0)})

Warning outcome preset (amber warning triangle).

const

Properties

docked → bool

When true together with fullPage, the actions are docked in a bottom bar (stacked, full width, above the system inset) instead of sitting inline under the content. Use for handheld "completed" screens so the next action is always in the thumb zone.

final

extra → Widget?

Extra structured information widget (e.g. receipt card, stack trace).

final

fullPage → bool

Whether this result occupies the full page (centers with expanded padding).

final

hashCode → int

The hash code for this object.

no setter, inherited

icon → dynamic

Leading icon override (defaults to status-based semantic icon).

final

iconColor → Color?

Custom color override for the result icon.

final

iconSize → double

Size of the status icon. Defaults to 64.0.

final

key → Key?

Controls how one widget replaces another widget in the tree.

final, inherited

padding → EdgeInsetsGeometry

Padding around the result widget.

final

primaryAction → Widget?

Primary call-to-action (e.g. "Go to Dashboard", "Try Again").

final

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

secondaryAction → Widget?

Secondary call-to-action (e.g. "View Order", "Contact Support").

final

status → TResultStatus

Outcome status.

final

subtitle → String?

Explanatory subtitle or guidance text.

final

subtitleWidget → Widget?

Custom subtitle widget override.

final

title → String?

Primary outcome title.

final

titleWidget → Widget?

Custom title widget override.

final

Methods

box({double minW = 0.0, double minH = 0.0, double maxW = double.infinity, double maxH = double.infinity}) → Widget

Available on Widget, provided by the WidgetX extension

Wraps this widget in a ConstrainedBox to apply layout constraints.

build(BuildContext context) → Widget

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

override

card({TCardShadow shadow = TCardShadow.none, EdgeInsetsGeometry padding = const EdgeInsets.all(12), EdgeInsetsGeometry margin = EdgeInsets.zero, BorderRadius? borderRadius, Color? backgroundColor, Color? borderColor, VoidCallback? onTap}) → Widget

Available on Widget, provided by the WidgetX extension

Wraps this widget in a TCard with a preset shadow depth.

cardLg({EdgeInsetsGeometry padding = const EdgeInsets.all(12), VoidCallback? onTap}) → Widget

Available on Widget, provided by the WidgetX extension

card with a prominent TCardShadow.lg shadow.

cardMd({EdgeInsetsGeometry padding = const EdgeInsets.all(12), VoidCallback? onTap}) → Widget

Available on Widget, provided by the WidgetX extension

card with a standard TCardShadow.md shadow.

cardSm({EdgeInsetsGeometry padding = const EdgeInsets.all(12), VoidCallback? onTap}) → Widget

Available on Widget, provided by the WidgetX extension

card with a subtle TCardShadow.sm shadow.

center({bool when = true}) → Widget

Available on Widget, provided by the WidgetX extension

Wraps this widget in a Center widget.

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

Wraps this widget in an Expanded widget.

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

padding([double left = 0.0, double top = 0.0, double right = 0.0, double bottom = 0.0]) → Widget

Available on Widget, provided by the WidgetX extension

Wraps this widget in a Padding with flexible edge control.

paddingSymmetric({double h = 0.0, double v = 0.0}) → Widget

Available on Widget, provided by the WidgetX extension

Wraps this widget in a Padding with symmetric horizontal and vertical spacing.

size({double? w, double? h}) → Widget

Available on Widget, provided by the WidgetX extension

Wraps this widget in a SizedBox to apply fixed width and/or height.

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 visible, {bool maintainState = false}) → Widget

Available on Widget, provided by the WidgetX extension

Wraps this widget in a Visibility widget.

when(bool condition) → Widget

Available on Widget, provided by the WidgetX extension

Returns this widget if condition is true, otherwise returns SizedBox.shrink(). Usage: Text('Hello').when(isVisible)

Operators

operator ==(Object other) → bool

The equality operator.

inherited