ranged_ruler_picker 1.0.0

SDKflutter
Platformandroidioswindowslinuxmacosweb

A scrollable ruler widget with a fixed center indicator that allows users to select a value within a defined min-max range

Ranged Ruler Picker

A Flutter widget that provides a scrollable ruler-style picker with a fixed center indicator. Perfect for selecting values within a defined range through intuitive horizontal scrolling, commonly used in financial apps for amount selection or settings apps for value adjustment.

Features

  • 📏 Ruler-Style Interface: Intuitive horizontal scrolling with tick marks
  • 🎯 Fixed Center Indicator: Clear visual feedback for selected value
  • ⚡ Snap Functionality: Automatic alignment to nearest tick when scrolling stops
  • 📱 Haptic Feedback: Tactile response for better user experience
  • 🏷️ Smart Labels: Min/max value labels with boundary-aware visibility
  • 🔧 Flexible Configuration: Show/hide indicators and labels as needed
  • 🖱️ Multi-Device Support: Works with both touch and mouse interactions

Demo

Basic Operation
Fine Tuning
Label Removal
Indicator Removal

Installation

Flutter pub add:

flutter pub add ranged_ruler_picker

or

Add this package to your pubspec.yaml:

dependencies:
  ranged_ruler_picker: ^1.0.0

Then run:

flutter pub get

Usage

Basic Usage

import 'package:ranged_ruler_picker/ranged_ruler_picker.dart';

class MyWidget extends StatefulWidget {
  @override
  _MyWidgetState createState() => _MyWidgetState();
}

class _MyWidgetState extends State<MyWidget> {
  int _selectedValue = 50000;

  @override
  Widget build(BuildContext context) {
    return RangedRulerPicker(
      min: 0,
      max: 100000,
      interval: 1000,
      initialValue: _selectedValue,
      onChanged: (value) {
        setState(() {
          _selectedValue = value;
        });
        print('Selected value: $value');
      },
      labelStyle: TextStyle(
        fontSize: 14,
        color: Colors.grey[600],
      ),
    );
  }
}

Custom Styling

RangedRulerPicker(
  min: 0,
  max: 50000,
  interval: 500,
  initialValue: 25000,
  onChanged: (value) => print('Value: $value'),
  labelStyle: TextStyle(
    fontSize: 16,
    fontWeight: FontWeight.bold,
    color: Colors.blue,
  ),
  indicatorColor: Colors.red,
  rulerColor: Colors.grey[400]!,
  shortTickHeight: 10,
  longTickHeight: 16,
  backgroundColor: Colors.grey[100],
)

Without Labels

RangedRulerPicker(
  min: 0,
  max: 1000,
  interval: 10,
  initialValue: 500,
  onChanged: (value) => print('Value: $value'),
  showLabel: false,
  labelStyle: TextStyle(fontSize: 14),
  indicatorColor: Colors.green,
)

Without Indicator

RangedRulerPicker(
  min: 0,
  max: 100,
  interval: 1,
  initialValue: 50,
  onChanged: (value) => print('Value: $value'),
  showIndicator: false,
  labelStyle: TextStyle(fontSize: 14),
  rulerColor: Colors.blue,
)

Disable Haptic Feedback

RangedRulerPicker(
  min: 0,
  max: 10000,
  interval: 100,
  initialValue: 5000,
  onChanged: (value) => print('Value: $value'),
  hapticFeedback: false,
  labelStyle: TextStyle(fontSize: 14),
)

How It Works

  • Horizontal Scrolling: Users scroll horizontally to select values with smooth scrolling support
  • Snap Animation: When scrolling stops, the picker automatically aligns to the nearest tick with smooth animation (100ms duration with easeOutCubic curve)
  • Center Indicator: A fixed indicator line (4px width, 32px height) shows the currently selected value
  • Smart Labels: Min/max labels are hidden when scrolling near boundaries to prevent overlap with the indicator
  • Haptic Feedback: Provides light impact feedback when values change
  • Performance Optimized: Efficient rendering with minimal rebuilds and border caching
  • Multi-Device Support: Supports both touch and mouse interactions
  • Tick System: Long ticks every 5th position for better value readability

Parameters

ParameterDescriptionTypeRequiredDefault
minMinimum selectable valueint✅-
maxMaximum selectable valueint✅-
intervalTick interval (e.g., 1000 means ticks every 1000 units)int✅-
initialValueInitially selected valueint✅-
onChangedCallback function when value changesvoid Function(int)✅-
labelStyleStyle for label textTextStyle✅-
shortTickHeightHeight of short ticks (pixels)int❌8
longTickHeightHeight of long ticks (pixels, displayed every 5th tick)int❌12
indicatorColorColor of the indicator lineColor❌Colors.blue
rulerColorColor of ruler ticksColor❌Colors.grey
showIndicatorWhether to show the indicator linebool❌true
showLabelWhether to show min/max value labelsbool❌true
hapticFeedbackWhether to provide haptic feedback when value changesbool❌true
backgroundColorBackground color of the widgetColor❌Colors.transparent

Technical Details

  • Item Width: Each tick item has a fixed width of 11 pixels
  • Snap Delay: 100ms delay before snap animation starts after scroll ends
  • Animation Duration: 100ms for snap animation with easeOutCubic curve
  • Label Positioning: Labels are positioned with different padding for long vs short ticks
  • Boundary Detection: Smart label hiding based on scroll position and label width calculation
  • Memory Management: Proper cleanup of timers and scroll controllers

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

If you encounter any issues or have questions, please file an issue on the GitHub repository.