Search packages, repositories and app categories

flutter_pannable_rating_bar cover
Package detailsv2.7.2+1

flutter_pannable_rating_bar

A versatile and customizable rating bar for Flutter. This bar stands out from others with its ability to select any fractional values. Drag, tap and hover event are all supported.

AndroidiOSWebmacOSWindowsLinux
30-day downloads
50
Likes
35
Pub points
150

Install package

flutter pub add flutter_pannable_rating_bar

Package Overview

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

A highly customizable rating bar for Flutter that supports selecting any fractional rating values. Unlike traditional rating bars, it enables smooth interaction through drag, tap, and hover events, offering a responsive and intuitive user experience across devices. Ideal for applications requiring precise feedback input, such as reviews or surveys. The package is compatible with all major platforms including Android, iOS, Web, macOS, Windows, and Linux.

Use cases

  • User reviews with fine-grained ratings
  • Interactive survey interfaces
  • Feedback collection in apps
  • Real-time rating adjustments
  • Touch-friendly UI components

Key features

  • Supports fractional ratings
  • Drag, tap, and hover interactions
  • Highly customizable design
  • Cross-platform compatibility
  • Smooth animation transitions
  • Configurable step size

Suitable for

  • Developers building interactive feedback systems
  • Apps needing precise rating inputs
  • Designers wanting touch-optimized UIs
  • Projects targeting multiple platforms
  • Prototypes requiring dynamic rating controls

Considerations

  • May require additional styling for complex themes
  • Performance impact on large lists of rating bars
  • Needs careful handling of gesture conflicts
  • Limited documentation beyond basic usage
  • Not optimized for very high-frequency updates

Original README

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

pub package

PannableRatingBar

Introducing a new and improved rating bar for Flutter, offering versatility and full customization. Unlike other rating bars, this one allows for any value to be selected, not just full or half ratings when interacted. Tap, drag and hover gestures are seamlessly supported, providing a smooth user experience.

Features

  • Offers fractional values for rating
  • High degree of customization for the rating widgets, which can be of different sizes, shapes, and colors.
  • Precise hit testing, as the child widget's render object is utilized to determine the results.
  • Allows for filtering gestures with either tapOnly, dragOnly or tapAndDrag options.
  • Rating reports on cursor hovering supported.
  • Built on Flutter's Wrap widget, offering a variety of supported layouts, including consideration of Wrap properties such as textDirection and verticalDirection when painting the indicators.

Getting started

First import the widget

import 'package:flutter_pannable_rating_bar/flutter_pannable_rating_bar.dart';

Usage

This widget is stateless and highly flexible, allowing you to easily manipulate values and customize the display of the PannableRatingBar. Simply rebuild the widget with the value provided in the onChanged callback or onHover callback and the widget will automatically adjust the rating distribution across each rating widget.

double rating = 0.0;

PannableRatingBar(
  rate: rating,
  items: List.generate(5, (index) =>
    const RatingWidget(
      selectedColor: Colors.yellow,
      unSelectedColor: Colors.grey,
      child: Icon(
        Icons.star,
        size: 48,
      ),
    )),
  onChanged: (value) { // the rating value is updated on tap or drag.
    setState(() {
      rating = value;
    });
  },
)

The widget also supports getting the rate value by hovering with the onHover callback. It works best on devices that support a mouse cursor, including desktop web browsers.

double rating = 0.0;

PannableRatingBar(
  rate: rating,
  items: List.generate(5, (index) =>
    const RatingWidget(
      selectedColor: Colors.yellow,
      unSelectedColor: Colors.grey,
      child: Icon(
        Icons.star,
        size: 48,
      ),
    )),
  onHover: (value) { // the rating value is updated every time the cursor moves over a new item.
    setState(() {
      rating = value;
    });
  },
)

Utilize your own custom widgets as the rating indicators. With complete customization freedom, they don't have to be uniform in size, color, or any other aspect.

double rating = 0.0;

PannableRatingBar(
  rate: rating,
  onChanged: (value) {
    setState(() {
      rating = value;
    });
  },
  items: const [
    RatingWidget(
      selectedColor: Colors.yellow,
      unSelectedColor: Colors.grey,
      child: Icon(
        Icons.star,
        size: 48,
      ),
    ),
    RatingWidget(
      selectedColor: Colors.blue,
      unSelectedColor: Colors.red,
      child: Icon(
        Icons.ac_unit,
        size: 48,
      ),
    ),
    RatingWidget(
      selectedColor: Colors.purple,
      unSelectedColor: Colors.amber,
      child: Icon(
        Icons.access_time_filled,
        size: 48,
      ),
    ),
    RatingWidget(
      selectedColor: Colors.cyanAccent,
      unSelectedColor: Colors.grey,
      child: Icon(
        Icons.abc,
        size: 48,
      ),
    ),
    RatingWidget(
      selectedColor: Colors.tealAccent,
      unSelectedColor: Colors.purple,
      child: Icon(
        Icons.accessibility_new_sharp,
        size: 48,
      ),
    ),
  ],
)
double rating = 0;
PannableRatingBar(
  rate: rating,
  onChanged: (value){
    setState((){
      rating = value;
    });
  },
  spacing: 20,
  items: const [
    RatingWidget(
      selectedColor: Colors.blue,
      child: Text(
        "Pannable",
        style: TextStyle(color: Colors.grey, fontSize: 40),
      ),
    ),
    RatingWidget(
      selectedColor: Colors.red,
      child: Text(
        "Rating",
        style: TextStyle(color: Colors.grey, fontSize: 30),
      ),
    ),
    RatingWidget(
      selectedColor: Colors.amber,
      child: Text(
        "Bar",
        style: TextStyle(color: Colors.grey, fontSize: 50),
      ),
    ),
  ],
),

This widget utilizes the layout capabilities of Flutter's built-in Wrap widget, allowing for a wide range of possible layouts to be achieved. The properties of the Wrap widget, such as textDirection and verticalDirection, are also considered when painting the indicators, giving you even greater control over the final look and feel of the rating bar.

double rating = 0.0;

PannableRatingBar.builder(
  rate: rating,
  alignment: WrapAlignment.center,
  spacing: 20,
  runSpacing: 10,
  itemCount: 20,
  direction: Axis.vertical,
  itemBuilder: (context, index) {
    return const RatingWidget(
      selectedColor: Colors.yellow,
      unSelectedColor: Colors.grey,
      child: Icon(
        Icons.star,
        size: 48,
      ),
    );
  },
  onChanged: (value) {
    setState(() {
      rating = value;
    });
  },
)

Customize the appearance of the rating indicators based on their values.

double rating = 0;

PannableRatingBar(
    rate: rating,
    spacing: 20,
    onChanged: (value){
      setState((){
        rating = value;
      });
    },
    items: [
      RatingWidget(
        selectedColor: rating <= 0.5 ? Colors.red : Colors.green,
        unSelectedColor: Colors.grey,
        child: AnimatedSwitcher(
          duration: const Duration(milliseconds: 300),
          child: rating <= 0.5
              ? const Icon(
                  Icons.sentiment_very_dissatisfied,
                  key: ValueKey("sad"),
                  size: 100,
                )
              : const Icon(
                  Icons.sentiment_satisfied,
                  key: ValueKey("happy"),
                  size: 100,
                ),
        ),
      ),
    ],
),

For ease of transforming / mutating rating values, the library support using functions to do as such, used as a parameter in PannableRatingBar.

Return null from this will cause the current rating value skipped in all callbacks.

typedef RatingValueTransformer = double? Function(double value);

Some of the pre-built RatingValueTransformers available are:

// Rounding to nearest single fractional digit. This is also the default one that 
// `PannableRatingBar` used.
double singleFractionalValueTransformer(double value);
// Rounding to nearest .5.
double halfFractionalValueTransformer(double value);
// Leave the rating as is.
double rawValueTransformer(double value);

Additional information

For more, checkout and play with the example file. If you have any suggestions for improvement, simply create an issue in the repository!

Categories

Source repository

Projects using this package

No data available yet.