Search packages, repositories and app categories

animated_image_list cover
Package detailsv1.0.0

animated_image_list

Flutter Animated image list with parallax effect and image lightbox .

AndroidiOSWebmacOSWindowsLinux
30-day downloads
128
Likes
94
Pub points
140

Install package

flutter pub add animated_image_list

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

A Flutter package that provides an animated image list with a parallax effect and a lightbox feature for viewing images in full screen. It enhances user experience by offering smooth, interactive scrolling with depth perception through parallax, ideal for showcasing image galleries or portfolios. The lightbox functionality allows users to tap on images for a detailed view, supporting seamless navigation between images. Designed for cross-platform use, it works across Android, iOS, Web, macOS, Windows, and Linux.

Use cases

  • Image galleries
  • Portfolio displays
  • Product showcases
  • Interactive storytelling
  • Social media feeds

Key features

  • Parallax scrolling effect
  • Image lightbox viewer
  • Cross-platform compatibility
  • Smooth animations
  • Customizable transitions
  • Responsive design

Suitable for

  • Developers building visual-heavy apps
  • Designers seeking engaging UI components
  • Apps requiring immersive image browsing
  • E-commerce platforms with product images
  • Creative digital portfolios

Considerations

  • May impact performance with large image sets
  • Requires careful optimization for low-end devices
  • Limited customization options for animation timing
  • Best suited for moderate image counts
  • Not ideal for text-heavy interfaces
  • Depends on external dependencies for full functionality

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Animated Image List for Flutter

Pub

Flutter Animated image list with parallax effect and image lightbox .

gif

Getting Started

Add the package to your pubspec.yaml:

animated_image_list: ^0.5.0

In your dart file, import the library:

import 'package:animated_image_list/AnimatedImageList.dart';

Instead of using a ListView create a AnimatedImageList Widget:

 AnimatedImageList(
               images: arr.map((e) => e.urls.small).toList(),
               builder: (context, index, progress) {
                 return Positioned.directional(
                     textDirection: TextDirection.ltr,
                     bottom: 15,
                     start: 25,
                     child: Opacity(
                       opacity: progress > 1 ? (2 - progress) : progress,
                       child: Text(
                         arr[index].user.username ?? 'Anonymous',
                         style: TextStyle(
                             color: Colors.white,
                             fontSize: 25,
                             fontWeight: FontWeight.w500),
                       ),
                     ));
               },
               scrollDirection: Axis.vertical,
               itemExtent: 100,
               maxExtent: 400,
             ),
Parameters:
Name Description Required Default value
images A list of images url to display in the list by default it accepts urls if custom image needed use provider paramter required -
provider Function which maps an url or image string to an image provider - -
itemExtent not selected item size required to calculate animations required 150
maxExtent selected item size required to calculate animations required 400
scrollDirection List scroll direction horizontal or vertical - Axis.vertical
builder Builder function that returns a widget to display over the image / progress from 0...1 item selection progress from 1...2 item leaving view could be usefull if you want to animate something like text opacity above / index current item index - -
placeHolder Optional function which returns default placeholder for lightbox and error widget if image fails to load - kTransparentImage

Categories

Dependencies

Dependency list 1 items

Source repository

Projects using this package

No data available yet.