ShadEmpty class

An empty-state placeholder.

Mirrors shadcn/ui's Empty: an icon, a title, a description and optional actions, centred in the space where content would otherwise be.

ShadEmpty(
  icon: const Icon(LucideIcons.inbox),
  title: const Text('No messages'),
  description: const Text('Messages you receive will show up here.'),
  actions: [ShadButton(onPressed: refresh, child: const Text('Refresh'))],
)

title falls back to a localized "No results" so the widget is never silently blank.

Inheritance
Available extensions

Constructors

ShadEmpty({Key? key, Widget? icon, Widget? title, Widget? description, List<Widget> actions = const [], EdgeInsetsGeometry? padding, double? gap, double? iconSize, Color? iconColor, TextStyle? titleStyle, TextStyle? descriptionStyle, CrossAxisAlignment? crossAxisAlignment, MainAxisAlignment? mainAxisAlignment, MainAxisSize mainAxisSize = MainAxisSize.min})
An empty-state placeholder.
const

Properties

actions → List<Widget>
Actions offered to the user, laid out in a row below the description.
final
crossAxisAlignment → CrossAxisAlignment?
The horizontal alignment of the content.
final
description → Widget?
A sentence explaining the empty state, or how to leave it.
final
descriptionStyle → TextStyle?
The style of description.
final
gap → double?
The vertical gap between the icon, title, description and actions.
final
hashCode → int
The hash code for this object.
no setterinherited
icon → Widget?
An illustration shown above the title, usually an Icon.
final
iconColor → Color?
The color applied to icon.
final
iconSize → double?
The size of icon.
final
key → Key?
Controls how one widget replaces another widget in the tree.
finalinherited
mainAxisAlignment → MainAxisAlignment?
The vertical alignment of the content.
final
mainAxisSize → MainAxisSize
final
padding → EdgeInsetsGeometry?
The padding around the content.
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
title → Widget?
The headline. Defaults to a localized "No results".
final
titleStyle → TextStyle?
The style of title.
final

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).
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
positionedWith(ShadPosition position) → Widget

Available on Widget, provided by the PositionedExt 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
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