Search packages, repositories and app categories

ducafecatFlutter ecosystem guide
Package detailsv1.0.1

spinner

A simple animated spinner that cycles through a circular list of fixed-size widgets

pub.dev API documentation Source code
30-day downloads
15
Likes
23
Pub points
40

Install package

flutter pub add spinner

Package Overview

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

A lightweight Flutter package that provides a simple animated spinner, cycling through a predefined list of fixed-size widgets in a circular manner. Ideal for indicating loading states or ongoing processes with smooth visual feedback. The spinner is customizable and easy to integrate into any UI, offering a clean and efficient way to enhance user experience during asynchronous operations.

Use cases

  • Loading indicators in forms
  • Displaying ongoing background tasks
  • Enhancing UX during data fetching
  • Visual feedback in navigation transitions
  • Simple animation placeholders

Key features

  • Circular widget cycling
  • Fixed-size widget support
  • Smooth animation transitions
  • Minimal configuration required
  • Lightweight and performant

Suitable for

  • Developers seeking simple loading animations
  • UI designers needing subtle visual cues
  • Apps requiring lightweight progress indicators
  • Projects with tight performance constraints

Considerations

  • Limited to fixed-size widgets
  • No built-in customization for rotation speed
  • Not suitable for complex animations
  • Requires manual handling of widget lifecycle
  • Depends on external source code for updates

Original README

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

Spinner

This flutter package implements a simple Spinner animation that cycles through any number of fixed size child widgets. Useful for selecting a random word from a list and displaying it to a user.

It can animate vertically, up or down:

Or horizontally, left or right:

Usage

To use this plugin, add spinner as a dependency in your pubspec.yaml file.

Example

See the example project in the repo for a quick demo

API

Spinner has several useful parameters. You can see them used in the example file

  • duration: change the duration of the animation

  • animationSpeed: change how fast the animation moves and what index the animation lands on

  • spinDirection: change the direction of animation

  • containerCount: number of containers that should appear on screen

  • containerSize: for vertical scroll, this is the width of each container produced by the builder function. For horizontal, this is the height

  • builder: a function that takes in an integer and returns a widget with height/width of containerSize

  • curve: the curve for the animation to follow. Defaults to easeInOutCubic

  • callback: a function called when the animation completes

  • zoomFactor: optional zoom in by this amount during the animation. It looks something like this, with a zoom factor of 1.5:

Categories

Animation & Transition

Source repository

Projects using this package

No data available yet.