Search packages, repositories and app categories

numeric_selector cover
Package detailsv0.0.4

numeric_selector

A customizable numeric selector widget for Flutter that supports both vertical and horizontal scrolling.

AndroidiOS
30-day downloads
83
Likes
11
Pub points
160

Install package

flutter pub add numeric_selector

Package Overview

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

A customizable numeric selector widget for Flutter that enables users to select numbers via vertical or horizontal scrolling. It offers smooth, interactive scrolling with configurable step sizes, range limits, and visual styling. Ideal for settings requiring precise numeric input without traditional text fields. The widget is lightweight and integrates seamlessly into forms or configuration screens.

Use cases

  • Form inputs requiring precise number selection
  • Settings panels with adjustable values
  • Custom number pickers in dashboards
  • Mobile UIs needing touch-friendly numeric entry
  • Time or quantity configuration interfaces

Key features

  • Supports vertical and horizontal scrolling
  • Configurable step size and value range
  • Customizable appearance and styling
  • Smooth scroll animation
  • Built-in value validation
  • Extensible for custom behaviors

Suitable for

  • Developers building form-based apps
  • Designers needing intuitive numeric input
  • Apps requiring touch-optimized number selection
  • Projects with minimal dependencies
  • Flutter apps targeting Android and iOS

Considerations

  • Limited to numeric input only
  • No built-in keyboard integration
  • Requires manual handling of large value ranges
  • Not suitable for non-integer values without customization
  • May need additional styling for high-contrast accessibility

Original README

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

Numeric Selector

A customizable Numeric Selector package for Flutter, providing both Horizontal and Vertical Numeric Selector with smooth scrolling and optional vibration feedback.

Features

✅ Horizontal and Vertical pickers
✅ Customizable styles and colors
✅ Vibration feedback support
✅ Supports minimum, maximum, and step values
✅ Optional labels and arrow indicators

Installation

Add the following dependency to your pubspec.yaml file:

dependencies:
  numeric_selector: latest_version

Then, run:

flutter pub get

Demo

Horizontal Numeric Selector Vertical Numeric Selector
Horizontal Numeric Selector Vertical Numeric Selector

Usage

Horizontal Numeric Selector
HorizontalNumericSelector(
  minValue: 0,
  maxValue: 100,
  step: 1,
  initialValue: 50,
  onValueChanged: (value) {
    print("Selected Value: $value");
  },
  viewPort: 0.3,
  selectedTextStyle: TextStyle(fontSize: 32, fontWeight: FontWeight.bold),
  unselectedTextStyle: TextStyle(fontSize: 24, color: Colors.grey),
  backgroundColor: Colors.white,
  showLabel: true,
  label: "Quantity",
  showArrows: true,
  enableVibration: true,
)
Vertical Numeric Selector
VerticalNumericSelector(
  minValue: 1,
  maxValue: 10,
  step: 1,
  initialValue: 5,
  onValueChanged: (value) {
    print("Selected Value: $value");
  },
  viewPort: 0.3,
  selectedTextStyle: TextStyle(fontSize: 32, fontWeight: FontWeight.bold),
  unselectedTextStyle: TextStyle(fontSize: 24, color: Colors.grey),
  backgroundColor: Colors.white,
  borderRadius: BorderRadius.circular(10),
  showLabel: true,
  label: "Speed",
  showArrows: true,
  enableVibration: true,
)

Parameters

Parameter Type Description
minValue int Minimum selectable value
maxValue int Maximum selectable value
step int Step between values
initialValue int Default selected value
onValueChanged ValueChanged<int> Callback when value changes
viewPort double Fraction of viewport occupied by picker
selectedTextStyle TextStyle? Style for selected value
unselectedTextStyle TextStyle? Style for unselected values
backgroundColor Color? Background color
borderRadius BorderRadius? Corner radius for picker background
showLabel bool Show label text below selected value
label String? Custom label text
showArrows bool Show navigation arrows
arrowIcon IconData? Custom arrow icon
enableVibration bool Enable vibration feedback

Contributing

Contributions are welcome! Feel free to submit a PR or open an issue.

Contact

👤 Amirmahdi Nourkazemi
LinkedIn

License

This project is licensed under the MIT License.

Categories

Dependencies

Dependency list 1 items

Source repository

Projects using this package