Pylon<T> class

A widget that provides a value of type T to its descendants in the widget tree.

Pylon is a state management solution that allows values to be passed down the widget tree and accessed by descendant widgets without the need for explicit passing through constructor parameters. It is designed to be simple, reliable, and intuitive, working similarly to but more reliably than the Provider package.

Key features:

• Provides values to descendant widgets
• Can be accessed across navigation routes
• Supports builders for immediate access to values
• Can be combined with other pylons using PylonCluster

Descendant widgets can access the value using BuildContext extensions like:

• context.pylon<T>() - Get the value (throws if not found)
• context.pylonOr<T>() - Get the value or null if not found
• context.hasPylon<T>() - Check if a pylon of type T is available

Inheritance

• Object
• DiagnosticableTree
• Widget
• StatelessWidget
• Pylon

Available extensions

• AnimateWidgetExtensions
• DebugContainer
• IconExtension
• SkeletonExtension
• TextExtension
• WidgetExtension
• XAST
• XOnGestureWidget
• XSliverWidget
• XWidget
• XWidgetArcane
• XWidgetEdge
• XWidgetEffect
• XWidgetFrost
• XWidgetInvert
• XWidgetPixelate
• XWidgetPixelateBlur
• XWidgetRGB
• XWidgetWarp

Constructors

Pylon.new({Key? key, required T value, required PylonBuilder? builder, bool local = false})

Creates a Pylon widget with a builder function.

const

Pylon.data({Key? key, required T value, bool local = false})

Creates a Pylon widget with only data, no child or builder.

const

Pylon.withChild({Key? key, required T value, required Widget? child, bool local = false})

Creates a Pylon widget with a child widget.

const

Properties

asBuilder → NeverWidgetBuilder

Available on Widget, provided by the WidgetExtension extension

no setter

asSliver → Widget

Available on Widget, provided by the XWidgetArcane extension

no setter

ast → Widget

Available on Widget, provided by the XAST extension

no setter

base → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

black → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

blockQuote → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

blurIn → Widget

Available on Widget, provided by the XWidgetEffect extension

no setter

bold → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

builder → PylonBuilder?

Optional builder function to create a child widget with access to the pylon value. If provided, child must be null.

final

centered → Widget

Available on Widget, provided by the XWidget extension

no setter

child → Widget?

Optional child widget. If provided, builder must be null.

final

ellipsis → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

expand → Widget

Available on Widget, provided by the XWidget extension

no setter

extraBold → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

extraLight → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

firstP → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

flexible → Widget

Available on Widget, provided by the XWidget extension

no setter

foreground → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

h1 → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

h2 → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

h3 → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

h4 → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

hashCode → int

The hash code for this object.

no setter, inherited

ih → Widget

Available on Widget, provided by the XWidgetArcane extension

no setter

inlineCode → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

intrinsicHeight → Widget

Available on Widget, provided by the XWidget extension

no setter

intrinsicSize → Widget

Available on Widget, provided by the XWidget extension

no setter

intrinsicWidth → Widget

Available on Widget, provided by the XWidget extension

no setter

italic → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

iw → Widget

Available on Widget, provided by the XWidgetArcane extension

no setter

key → Key?

Controls how one widget replaces another widget in the tree.

final, inherited

large → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

lead → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

li → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

light → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

local → bool

If true, this pylon won't be transferred across navigation routes.

final

medium → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

modify → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

mono → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

muted → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

normal → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

p → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

primaryForeground → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

safeArea → Widget

Available on Widget, provided by the XWidget extension

no setter

sans → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

scrollable → Widget

Available on Widget, provided by the XWidget extension

no setter

scrollableHorizontal → Widget

Available on Widget, provided by the XWidget extension

no setter

secondaryForeground → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

semiBold → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

singleLine → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

small → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

textCenter → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

textEnd → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

textJustify → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

textLarge → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

textLeft → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

textMuted → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

textRight → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

textSmall → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

textStart → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

thin → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

underline → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

value → T

The value of type T that will be provided to descendant widgets.

final

valueType → Type

Returns the type of value stored in this pylon.

no setter

x2Large → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

x3Large → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

x4Large → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

x5Large → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

x6Large → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

x7Large → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

x8Large → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

x9Large → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

xLarge → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

xSmall → TextModifier

Available on Widget, provided by the TextExtension extension

no setter

Methods

animate({Key? key, List<Effect>? effects, AnimateCallback? onInit, AnimateCallback? onPlay, AnimateCallback? onComplete, bool? autoPlay, Duration? delay, AnimationController? controller, Adapter? adapter, double? target, double? value}) → Animate

Available on Widget, provided by the AnimateWidgetExtensions extension

Wraps the target Widget in an Animate instance, and returns the instance for chaining calls. Ex. myWidget.animate() is equivalent to Animate(child: myWidget).

asSkeleton({bool enabled = true, bool leaf = false, Widget? replacement, bool unite = false, AsyncSnapshot? snapshot}) → Widget

Available on Widget, provided by the SkeletonExtension extension

asSkeletonSliver({bool enabled = true}) → Widget

Available on Widget, provided by the SkeletonExtension extension

build(BuildContext context) → Widget

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

override

center({Key? key}) → Widget

Available on Widget, provided by the WidgetExtension extension

clip({Clip clipBehavior = Clip.hardEdge}) → Widget

Available on Widget, provided by the WidgetExtension extension

clipOval({Clip clipBehavior = Clip.antiAlias}) → Widget

Available on Widget, provided by the WidgetExtension extension

clipPath({Clip clipBehavior = Clip.antiAlias, required CustomClipper<Path> clipper}) → Widget

Available on Widget, provided by the WidgetExtension extension

clipRRect({BorderRadiusGeometry borderRadius = BorderRadius.zero, Clip clipBehavior = Clip.antiAlias}) → Widget

Available on Widget, provided by the WidgetExtension extension

constrained({double? minWidth, double? maxWidth, double? minHeight, double? maxHeight, double? width, double? height}) → Widget

Available on Widget, provided by the WidgetExtension extension

copyWithBuilder(PylonBuilder builder) → Pylon<T>

Returns a copy of this widget with the builder function set to builder.

copyWithChild(Widget child) → Pylon<T>

Returns a copy of this widget with the child widget set to child.

createElement() → StatelessElement

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

inherited

debugContainer([Color color = Colors.red]) → Widget

Available on Widget, provided by the DebugContainer extension

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

excludeSkeleton({bool exclude = true}) → Widget

Available on Widget, provided by the SkeletonExtension extension

expanded({int flex = 1}) → Widget

Available on Widget, provided by the WidgetExtension extension

iconDestructiveForeground() → Widget

Available on Widget, provided by the IconExtension extension

iconLarge() → Widget

Available on Widget, provided by the IconExtension extension

iconMedium() → Widget

Available on Widget, provided by the IconExtension extension

iconMutedForeground() → Widget

Available on Widget, provided by the IconExtension extension

iconPrimary() → Widget

Available on Widget, provided by the IconExtension extension

iconPrimaryForeground() → Widget

Available on Widget, provided by the IconExtension extension

iconSecondary() → Widget

Available on Widget, provided by the IconExtension extension

iconSecondaryForeground() → Widget

Available on Widget, provided by the IconExtension extension

iconSmall() → Widget

Available on Widget, provided by the IconExtension extension

iconX2Large() → Widget

Available on Widget, provided by the IconExtension extension

iconX2Small() → Widget

Available on Widget, provided by the IconExtension extension

iconX3Large() → Widget

Available on Widget, provided by the IconExtension extension

iconX3Small() → Widget

Available on Widget, provided by the IconExtension extension

iconX4Large() → Widget

Available on Widget, provided by the IconExtension extension

iconX4Small() → Widget

Available on Widget, provided by the IconExtension extension

iconXLarge() → Widget

Available on Widget, provided by the IconExtension extension

iconXSmall() → Widget

Available on Widget, provided by the IconExtension extension

ignoreSkeleton() → Widget

Available on Widget, provided by the SkeletonExtension extension

intrinsic({double? stepWidth, double? stepHeight}) → Widget

Available on Widget, provided by the WidgetExtension extension

intrinsicHeight() → Widget

Available on Widget, provided by the WidgetExtension extension

intrinsicWidth({double? stepWidth, double? stepHeight}) → Widget

Available on Widget, provided by the WidgetExtension extension

isSliver(BuildContext context) → bool

Available on Widget, provided by the XSliverWidget extension

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

onDoublePressed(VoidCallback action, {HitTestBehavior? behavior, Set<PointerDeviceKind>? supportedDevices}) → Widget

Available on Widget, provided by the XOnGestureWidget extension

Adds a handler for double press/tap gestures.

onHover(void action(bool hovering)) → Widget

Available on Widget, provided by the XOnGestureWidget extension

Adds a handler for hover events.

onLongPressed(VoidCallback action, {HitTestBehavior? behavior, Set<PointerDeviceKind>? supportedDevices}) → Widget

Available on Widget, provided by the XOnGestureWidget extension

Adds a handler for long press gestures with the primary button.

onLongSecondaryPressed(VoidCallback action, {HitTestBehavior? behavior, Set<PointerDeviceKind>? supportedDevices}) → Widget

Available on Widget, provided by the XOnGestureWidget extension

Adds a handler for long press gestures with the secondary button.

onLongTertiaryPressed(VoidCallback action, {HitTestBehavior? behavior, Set<PointerDeviceKind>? supportedDevices}) → Widget

Available on Widget, provided by the XOnGestureWidget extension

Adds a handler for long press gestures with the tertiary button.

onPressed(VoidCallback action, {HitTestBehavior? behavior, Set<PointerDeviceKind>? supportedDevices}) → Widget

Available on Widget, provided by the XOnGestureWidget extension

Adds a handler for primary press/tap gestures (equivalent to onTap).

onSecondaryPressed(VoidCallback action, {HitTestBehavior? behavior, Set<PointerDeviceKind>? supportedDevices}) → Widget

Available on Widget, provided by the XOnGestureWidget extension

Adds a handler for secondary press gestures (equivalent to right-click).

onTertiaryPressed(VoidCallback action, {HitTestBehavior? behavior, Set<PointerDeviceKind>? supportedDevices}) → Widget

Available on Widget, provided by the XOnGestureWidget extension

Adds a handler for tertiary press gestures (equivalent to middle-click).

pad(double all) → Widget

Available on Widget, provided by the XWidget extension

padBottom(double value) → Widget

Available on Widget, provided by the XWidget extension

padBy({double? left, double? top, double? right, double? bottom, double? horizontal, double? vertical}) → Widget

Available on Widget, provided by the XWidgetArcane extension

padLeft(double value) → Widget

Available on Widget, provided by the XWidget extension

padOnly({double left = 0, double top = 0, double right = 0, double bottom = 0}) → Widget

Available on Widget, provided by the XWidget extension

padRight(double value) → Widget

Available on Widget, provided by the XWidget extension

padSliverBy({double? left, double? top, double? right, double? bottom, double? horizontal, double? vertical}) → Widget

Available on Widget, provided by the XWidgetArcane extension

padTop(double value) → Widget

Available on Widget, provided by the XWidget extension

positioned({Key? key, double? left, double? top, double? right, double? bottom}) → Widget

Available on Widget, provided by the WidgetExtension extension

shadeEdge(double radius) → Widget

Available on Widget, provided by the XWidgetEdge extension

shadeFrost(double value) → Widget

Available on Widget, provided by the XWidgetFrost extension

shadeInvert() → Widget

Available on Widget, provided by the XWidgetInvert extension

shadePixelate(double radius) → Widget

Available on Widget, provided by the XWidgetPixelate extension

shadePixelateBlur({int samples = 4, double pixelSize = 8, double radius = 2}) → Widget

Available on Widget, provided by the XWidgetPixelateBlur extension

shadeRGB({double radius = 5, double spin = 1}) → Widget

Available on Widget, provided by the XWidgetRGB extension

shadeWarp({double amplitude = 1, double frequency = 1, double z = 1, int octaves = 2}) → Widget

Available on Widget, provided by the XWidgetWarp extension

shadeWarpAnimation({double amplitude = 1, double frequency = 1, double z = 1, double zSpeed = 1, int octaves = 2}) → Widget

Available on Widget, provided by the XWidgetWarp extension

shimmer({bool loading = true}) → Widget

Available on Widget, provided by the XWidgetArcane extension

sized({double? width, double? height}) → Widget

Available on Widget, provided by the XWidget extension

sized({double? width, double? height}) → Widget

Available on Widget, provided by the WidgetExtension extension

then(InlineSpan span) → Widget

Available on Widget, provided by the TextExtension extension

thenButton({required VoidCallback onPressed, required Widget child}) → Widget

Available on Widget, provided by the TextExtension extension

thenInlineCode(String text) → Widget

Available on Widget, provided by the TextExtension extension

thenText(String text) → Widget

Available on Widget, provided by the TextExtension extension

toBox(BuildContext context, {bool softWarn = true}) → Widget

Available on Widget, provided by the XSliverWidget extension

toDiagnosticsNode({String? name, DiagnosticsTreeStyle? style}) → DiagnosticsNode

Returns a debug representation of the object that is used by debugging tools and by DiagnosticsNode.toStringDeep.

inherited

toSliver(BuildContext context, {bool fillRemaining = false, bool softWarn = true}) → Widget

Available on Widget, provided by the XSliverWidget extension

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

transform({Key? key, required Matrix4 transform}) → Widget

Available on Widget, provided by the WidgetExtension extension

withAlign(AlignmentGeometry alignment) → Widget

Available on Widget, provided by the WidgetExtension extension

withMargin({double? top, double? bottom, double? left, double? right, double? horizontal, double? vertical, double? all}) → Widget

Available on Widget, provided by the WidgetExtension extension

withOpacity(double opacity) → Widget

Available on Widget, provided by the WidgetExtension extension

withPadding({double? top, double? bottom, double? left, double? right, double? horizontal, double? vertical, double? all, EdgeInsetsGeometry? padding}) → Widget

Available on Widget, provided by the WidgetExtension extension

withTooltip(String tooltip) → Widget

Available on Widget, provided by the XWidgetArcane extension

Operators

operator ==(Object other) → bool

The equality operator.

inherited

Static Methods

cupertinoPageRoute<T extends Object?>(BuildContext context, Widget builder(BuildContext), {RouteSettings? settings}) → CupertinoPageRoute<T>

Creates a CupertinoPageRoute with all pylon values from the current context transferred to the new route.

materialPageRoute<T extends Object?>(BuildContext context, Widget builder(BuildContext), {RouteSettings? settings}) → MaterialPageRoute<T>

Creates a MaterialPageRoute with all pylon values from the current context transferred to the new route.

mirror(BuildContext context, Widget builder(BuildContext)) → Widget Function(BuildContext)

Creates a builder function that incorporates all visible pylon values from the current context.

push<T extends Object?>(BuildContext context, Widget child, {RouteSettings? settings, PylonRouteType type = PylonRouteType.material, Route<T>? route}) → Future<T?>

Pushes a new route to the navigator with all visible Pylon widgets from the current context.

pushAndRemoveUntil<T extends Object?>(BuildContext context, Widget child, {RouteSettings? settings, PylonRouteType type = PylonRouteType.material, Route<T>? route, required RoutePredicate predicate}) → Future<T?>

Pushes a new route and removes routes until predicate returns true, transferring pylon values.

pushReplacement<T extends Object?, TO extends Object?>(BuildContext context, Widget child, {RouteSettings? settings, PylonRouteType type = PylonRouteType.material, Route<T>? route}) → Future<T?>

Replaces the current route with a new one, transferring pylon values.

visiblePylons(BuildContext context, {bool ignoreLocals = false}) → List<Pylon>

Returns a list of all visible Pylon widgets in the widget tree, starting from context.

widgetOf<T>(BuildContext context) → Pylon<T>

Returns the value of the nearest ancestor Pylon widget of type T or throws an error if not found.

widgetOfOr<T>(BuildContext context) → Pylon<T>?

Returns the value of the nearest ancestor Pylon widget of type T or null if not found.