GlassTheme class

Provides glass theme configuration to descendant widgets.

This InheritedWidget allows glass widgets to access centralized theme settings without passing them explicitly through the widget tree.

Usage

Wrap your app (or a section of it) with GlassTheme:

MaterialApp(
  builder: (context, child) => GlassTheme(
    data: GlassThemeData(
      light: GlassThemeVariant(
        settings: LiquidGlassSettings(thickness: 30),
        quality: GlassQuality.standard,
      ),
      dark: GlassThemeVariant(
        settings: LiquidGlassSettings(thickness: 40),
        quality: GlassQuality.standard,
      ),
    ),
    child: child!,
  ),
)

Access theme in widgets:

final theme = GlassThemeData.of(context);
final settings = theme.settingsFor(context); // Auto light/dark

Theme Inheritance

Widgets automatically inherit theme settings from the nearest GlassTheme ancestor. Individual widgets can override theme values by explicitly passing settings, quality, or glowColor parameters.

Light/Dark Mode

The theme automatically switches between light and dark variants using a four-level priority cascade (highest first):

  1. GlassThemeData.brightness — explicit override on this theme.
  2. Cupertino theme brightness — explicit pin in CupertinoThemeData.
  3. Material ThemeMode — honours ThemeMode.light / ThemeMode.dark.
  4. MediaQuery.platformBrightnessOf — device/OS system setting.

Use GlassTheme.brightnessOf to resolve brightness inside glass widgets. Never read MediaQuery.platformBrightnessOf or CupertinoTheme.brightnessOf directly in glass widget code — those bypass the cascade.

Inheritance
Available extensions

Constructors

GlassTheme({required GlassThemeData data, required Widget child, Key? key})
Creates a glass theme.
const

Properties

child → Widget
The widget below this widget in the tree.
finalinherited
data → GlassThemeData
The theme data containing light and dark configurations.
final
hashCode → int
The hash code for this object.
no setterinherited
key → Key?
Controls how one widget replaces another widget in the tree.
finalinherited
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited

Methods

createElement() → InheritedElement
Inflates this configuration to a concrete instance.
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.
override
glassContextMenu({Key? key, required List<Widget> actions, WidgetBuilder? previewBuilder, bool enabled = true, bool enableHaptics = true, double borderRadius = 32.0, double? previewBorderRadius, double rowBorderRadius = 16.0, BorderRadius? rowCorners, Color? originSlotColor, Color? backgroundColor, LiquidGlassSettings? settings, GlassQuality? quality, double backdropBlur = 0.0, Color? barrierColor, double menuWidth = 250.0, VoidCallback? onOpened, VoidCallback? onDismissed, Duration longPressDuration = const Duration(milliseconds: 700)}) → Widget

Available on Widget, provided by the GlassContextMenuExtension extension

Wraps this widget in a GlassContextMenu displaying actions on long-press or right-click.
glassFullScreenCover({required bool isPresented, VoidCallback? onDismiss, required WidgetBuilder content, bool enableSwipeToDismiss = true, double dismissThreshold = 140.0, LiquidGlassSettings? settings, GlassQuality? quality}) → Widget

Available on Widget, provided by the GlassFullScreenCoverExtension extension

Presents a full-viewport modal cover whenever isPresented is true.

Available on Widget, provided by the GlassNavigationTitleExtension extension

Annotates this widget with a navigation title that drives enclosing or descendant GlassAppBar / GlassAppBar.pinned bars (when their explicit title is null) as well as header accessibility semantics.
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
updateShouldNotify(covariant GlassTheme oldWidget) → bool
Whether the framework should notify widgets that inherit from this widget.
override

Operators

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

Static Methods

brightnessOf(BuildContext context) → Brightness
Resolves the effective brightness for all glass widgets in this context.
maybeOf(BuildContext context) → GlassTheme?
Retrieves the GlassTheme from the widget tree.
of(BuildContext context) → GlassTheme
Retrieves the GlassTheme from the widget tree.