Hash Cached Image #

hash_cached_image is a powerful Flutter package designed to streamline image loading, caching, and error handling within your Flutter applications. With support for blur hash placeholders, customizable widgets, and smooth animations, this package simplifies the process of displaying images from network URLs while maintaining a high-quality user experience.

Features #

Efficient Image Loading: Utilize CachedNetworkImageProvider for efficient image caching and loading.
Blur Hash Placeholders: Display blurred placeholders while images are loading for a seamless user experience.
Customizable Widgets: Customize placeholder and error widgets globally or per instance to match your app's design.
Smooth Animations: Add fade-in and fade-out animations to enhance image transitions.
High-Quality Filters: Choose from various image filter quality options to optimize visual appearance.

Installation #

To integrate hash_cached_image into your Flutter project, follow these steps:

Add the following line to your pubspec.yaml file:
```
dependencies:
  hash_cached_image: ^1.0.0
```
Run flutter pub get in your terminal to install the package.

Usage #

Basic Usage #

To use hash_cached_image in your Flutter project, follow these steps:

Add the package to your pubspec.yaml file:

dependencies:
  hash_cached_image: ^1.0.0

Import the package in your Dart code:

import 'package:hash_cached_image/hash_cached_image.dart';

Use the HashCachedImage widget to display images with cached network loading and optional blur hash placeholders and error handling. Here's a basic example:
```
HashCachedImage(
  imageUrl: 'https://example.com/image.jpg',
  hash: 'LEHV6nWB2yk8pyo0adR*.7kCMdnj',
  height: 200,
  width: 200,
  placeholder: (context) => const CircularProgressIndicator(),
  errorWidget: (context, error, stackTrace) => const Icon(Icons.error),
  fit: BoxFit.cover,
)
```
In this example, replace 'https://example.com/image.jpg' with the URL of the image you want to display. The hash parameter is optional and can be used for blur hash placeholders. You can customize the placeholder and error widgets, as well as other properties like height, width, and fit to suit your UI requirements.

Global Configuration #

You can set global placeholder and error widgets for your entire application:

import 'package:hash_cached_image/hash_cached_image.dart';

void main() {
  HashCachedImageGlobalParameter().setGlobalParameter(
    globalPlaceholderWidget: (context) => const CircularProgressIndicator(),
    globalErrorWidget: (context, error, stackTrace) => const Icon(Icons.error),
  );
  runApp(const MyApp());
}

API Reference #