AppWidthLimiter class

Limits the effective content width and resets scaling for large screens.

On screens wider than maxWidth, this widget:

  1. Centers the content with a ConstrainedBox.
  2. Overrides MediaQuery in the subtree, capping size.width to maxWidth. This causes any child reading MediaQuery.sizeOf to see the constrained width, ensuring scaling stays consistent.
  3. Wraps the subtree in a new ScalifyProvider so that all responsive extensions (.w, .h, .fz, etc.) recalculate based on the capped width.
  4. Uses RepaintBoundary to isolate the content paint — significantly reducing paint cost during rapid Desktop/Web window resizing.

If minWidth is set (or ScalifyConfig.minWidth > 0), the content will horizontally scroll rather than shrink below that threshold.

Example

AppWidthLimiter(
  maxWidth: 1200,
  minWidth: 360,
  child: MyPageContent(),
)
Inheritance

Constructors

AppWidthLimiter({Key? key, required Widget child, double maxWidth = 1000.0, Color? backgroundColor, double horizontalPadding = 16.0, double? minWidth})
const

Properties

backgroundColor → Color?
final
child → Widget
final
hashCode → int
The hash code for this object.
no setterinherited
horizontalPadding → double
final
key → Key?
Controls how one widget replaces another widget in the tree.
finalinherited
maxWidth → double
final
minWidth → double?
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited

Methods

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
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