SafeLocalImage class

A widget for displaying images from the local file system.

Handles:

  • Normal rendering of local image files via Image.file
  • File permission errors (e.g. "Permission denied") with a user-friendly fallback
  • Missing file errors with a customizable placeholder
Inheritance

Constructors

SafeLocalImage({Key? key, required String path, double? height, double? width, BoxFit fit = BoxFit.cover, BorderRadius borderRadius = const BorderRadius.all(Radius.circular(0)), bool showSettingsButton = true, String? placeholderText, TextStyle? textStyle, Icon? icon, bool verticalLayout = false})
Creates a SafeLocalImage widget that attempts to load a local image and handles missing files or permission issues.
const

Properties

borderRadius BorderRadius
Border radius for rounding the image or placeholder container.
final
fit BoxFit
Defines how the image should be inscribed into the space allocated.
final
hashCode int
The hash code for this object.
no setterinherited
height double?
Optional fixed height for the image or placeholder.
final
icon Icon?
Optional icon to display next to the placeholder message.
final
key Key?
Controls how one widget replaces another widget in the tree.
finalinherited
path String
Full file path to the image on local storage.
final
placeholderText String?
Optional placeholder message when the file is not found.
final
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
showSettingsButton bool
Whether to show a "Go to Settings" button when permissions are denied.
final
textStyle TextStyle?
Custom text style for placeholder messages.
final
verticalLayout bool
Whether to display the placeholder layout vertically (column) or horizontally (row).
final
width double?
Optional fixed width for the image or placeholder.
final

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