app_image

Description:

app image

App Image #
app_image is a versatile Flutter package designed to simplify image handling within your applications. It provides a highly customizable AppImage widget that supports various image sources, including network URLs, asset paths, file paths, and memory images. This package features fade-in animations, custom placeholder and error widgets, full-screen image viewing, SVG support, and pre-caching capabilities.

Features #

Fade-in Animations: Apply smooth fade-in effects with customizable durations and curves to enhance the visual experience.
Placeholder and Error Widgets: Display custom placeholder and error widgets while the image loads or if an error occurs.
Full-Screen Image Viewer: Enable full-screen viewing of images with a simple tap gesture.
SVG Support: Seamlessly handle SVG images from network, asset, and file sources.
Pre-caching: Pre-cache images to improve loading performance and provide a smoother user experience.
Automatic Image Provider Selection: Automatically determine the appropriate image provider based on the image source, with the option to define the ImgProvider explicitly if needed.

Installation #
Add the following to your pubspec.yaml file:
dependencies:
app_image: ^1.0.8
copied to clipboard
Then run flutter pub get to install the package.
Usage #
Basic Usage #
import 'package:app_image/app_image.dart';
import 'package:flutter/material.dart';

class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
return MaterialApp(
home: Scaffold(
body: Center(
child: AppImage(
image: 'https://example.com/image.jpg',
placeHolderWidget: CircularProgressIndicator(),
errorWidget: Icon(Icons.error),
fadeInDuration: Duration(milliseconds: 300),
fadeInCurve: Curves.easeIn,
enableFullScreenView: true,
),
),
),
);
}
}
copied to clipboard
Full-Screen Viewer #
To enable full-screen viewing of images:
AppImage(
image: 'https://example.com/image.jpg',
enableFullScreenView: true,
allImages: [
'https://example.com/image1.jpg',
'https://example.com/image2.jpg',
'https://example.com/image3.jpg',
],
);
copied to clipboard
Custom Placeholder and Error Widgets #
You can customize the placeholder and error widgets:
AppImage(
image: 'https://example.com/image.jpg',
placeHolderWidget: CircularProgressIndicator(),
errorWidget: Icon(Icons.broken_image),
);
copied to clipboard
SVG Support #
To display SVG images:
AppImage(
image: 'assets/image.svg',
);
copied to clipboard
Example #
Check out the example directory for a complete sample app demonstrating the use of the app_image package.
License #
This project is licensed under the MIT License - see the LICENSE file for details.
Support #