Skip to main content

number_spinner 1.0.2 copy "number_spinner: ^1.0.2" to clipboard
number_spinner: ^1.0.2 copied to clipboard

A modern, eye-catching animated number spinner, 3D wheel picker, odometer counter, and ruler slider widget library for Flutter.

number_spinner #

pub package License: MIT Flutter Platform Powered by Humanize AI

A modern, eye-catching animated number spinner, 3D cylindrical wheel picker, rolling-digit odometer counter, multi-digit drum roller, and interactive sliding ruler widget library for Flutter. Zero external dependencies, precision-safe decimal math, and full FormField integration.

🌟 Supported & Powered by Humanize AI

number_spinner interactive animated showcase


🎬 Live Visual Preview #

1. Odometer Number Spinner (odometer) 2. 3D Wheel Picker (wheelVertical & wheelHorizontal)
Odometer Number Spinner Preview 3D Wheel Picker Preview
Per-character rolling digit transition, drag-to-spin, tap-to-edit, and bottom progress bar. 3D cylindrical perspective drum & horizontal carousel with magnification lens and edge fades.
3. Multi-Digit 3D Drum Counter (MultiDigitNumberSpinner) 4. Interactive Sliding Ruler (ruler)
Multi-Digit 3D Drum Counter Preview Interactive Sliding Ruler Preview
Spin each place-value digit column (100s, 10s, 1s, .1s) independently. Snap-to-step tick gauge with glowing center pointer needle and live odometer readout badge.

✨ Features #

  • 🎡 4 Eye-Catching Interactive Layouts (NumberSpinnerLayout):
    • NumberSpinnerLayout.odometer — Rolling-digit odometer capsule with drag-to-spin gestures, tap-to-edit inline input, and stepper buttons.
    • NumberSpinnerLayout.wheelVertical — 3D vertical cylindrical drum wheel picker with magnification lens and gradient edge fades.
    • NumberSpinnerLayout.wheelHorizontal — 3D horizontal carousel wheel picker with center lens highlight.
    • NumberSpinnerLayout.ruler — Interactive sliding tick-mark gauge ruler with center pointer needle and live digital readout header.
  • 🔢 Standalone Odometer & Multi-Digit Drum Widgets:
    • OdometerNumberText — Per-character directional rolling digit text widget for live counters, prices, and dashboards.
    • MultiDigitNumberSpinner — Independent place-value 3D digit drum columns (100s, 10s, 1s, .1s) for hardware counters, frequency tuners, and combination dials.
  • 🎨 5 Modern Theme Presets (NumberSpinnerStyle):
    • NumberSpinnerStyle.modern() — Clean Material 3 surface with soft focus glow.
    • NumberSpinnerStyle.glass() — Translucent frosted glassmorphic surface and luminous border.
    • NumberSpinnerStyle.neon() — High-contrast dark cyber style with glowing neon digits and progress bar.
    • NumberSpinnerStyle.minimal() — Ultra-clean borderless capsule.
    • NumberSpinnerStyle.soft() — Tactile soft-UI contours with dual shadows.
  • 🧮 Precision-Safe Decimal Math (NumberSpinnerMath):
    • Eliminates IEEE 754 floating-point drift (0.1 + 0.2 == 0.3 guaranteed).
    • Supports cyclic wrap-around mode (loop: true) for clocks (00..23, 00..59), angles (0°..359°), and cyclic dials.
  • 💱 Built-in Formatting Presets (NumberSpinnerFormat):
    • standard(), decimal(), padded() (zero-padded e.g. 01, 02), currency(), european(), percentage(), unit(), and custom().
  • ⚡ Rich Desktop, Web & Mobile Ergonomics:
    • Drag-to-spin vertical/horizontal gestures, long-press turbo auto-repeat, mouse scroll wheel support, and keyboard shortcuts (ArrowUp/ArrowDown, PageUp/PageDown, Home/End).
  • 📋 Form Validation Ready:
    • NumberSpinnerFormField integrates directly with Flutter's Form, validator, onSaved, reset(), and AutovalidateMode.

📦 Installation #

Add number_spinner to your pubspec.yaml:

dependencies:
  number_spinner: ^1.0.2

Or install via the Flutter CLI:

flutter pub add number_spinner

🚀 Quick Start #

import 'package:flutter/material.dart';
import 'package:number_spinner/number_spinner.dart';

class QuantitySpinnerDemo extends StatelessWidget {
  const QuantitySpinnerDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return NumberSpinner(
      labelText: 'Quantity',
      initialValue: 5,
      min: 0,
      max: 100,
      step: 1,
      style: NumberSpinnerStyle.modern(showProgressIndicator: true),
      onChanged: (value) {
        debugPrint('Selected value: $value');
      },
    );
  }
}

📖 Usage Examples #

// 1. Odometer Capsule with Glassmorphic Theme
NumberSpinner(
  labelText: 'Odometer Spinner',
  initialValue: 25,
  min: 0,
  max: 100,
  layout: NumberSpinnerLayout.odometer,
  style: NumberSpinnerStyle.glass(showProgressIndicator: true),
)

// 2. 3D Vertical Drum Wheel with Looping (e.g. Hours 00..23)
NumberSpinner(
  labelText: 'Alarm Hour',
  initialValue: 8,
  min: 0,
  max: 23,
  loop: true,
  layout: NumberSpinnerLayout.wheelVertical,
  buttonPosition: NumberSpinnerButtonPosition.topBottom,
  format: const NumberSpinnerFormat.padded(width: 2),
)

// 3. 3D Horizontal Carousel Wheel
NumberSpinner(
  labelText: 'Level Multiplier',
  initialValue: 3,
  min: 1,
  max: 10,
  layout: NumberSpinnerLayout.wheelHorizontal,
  format: const NumberSpinnerFormat(suffix: 'x'),
)

// 4. Interactive Sliding Ruler Gauge
NumberSpinner(
  labelText: 'Target Weight',
  initialValue: 70.5,
  min: 40,
  max: 150,
  step: 0.5,
  precision: 1,
  layout: NumberSpinnerLayout.ruler,
  format: const NumberSpinnerFormat.unit(unit: 'kg', padDecimals: true),
  style: NumberSpinnerStyle.modern(showProgressIndicator: true),
)

2. Neon Cyber & Soft Theme Presets #

// Glowing Neon Cyber Spinner
NumberSpinner(
  initialValue: 1250,
  min: 0,
  max: 5000,
  step: 50,
  format: const NumberSpinnerFormat.currency(symbol: r'$', padDecimals: false),
  style: NumberSpinnerStyle.neon(
    accentColor: const Color(0xFF00F5D4),
  ),
)

// Tactile Soft-UI Spinner
NumberSpinner(
  initialValue: 65,
  min: 0,
  max: 100,
  step: 5,
  format: const NumberSpinnerFormat.percentage(),
  style: NumberSpinnerStyle.soft(),
)

3. Multi-Digit 3D Drum Spinner (MultiDigitNumberSpinner) #

Spin each place-value digit column (100s, 10s, 1s, .1s) independently:

MultiDigitNumberSpinner(
  labelText: 'Frequency Tuner (MHz)',
  initialValue: 104.5,
  min: 88.0,
  max: 108.0,
  integerDigits: 3,
  decimalDigits: 1,
  suffixText: 'MHz',
  style: NumberSpinnerStyle.neon(
    accentColor: const Color(0xFF38BDF8),
  ),
  onChanged: (frequency) {
    debugPrint('Tuned to: $frequency MHz');
  },
)

4. Standalone Rolling Odometer Text (OdometerNumberText) #

OdometerNumberText(
  value: 14920.75,
  precision: 2,
  format: const NumberSpinnerFormat.currency(symbol: r'$'),
  style: const TextStyle(fontSize: 28, fontWeight: FontWeight.w800),
)

5. Programmatic Control (NumberSpinnerController) #

final controller = NumberSpinnerController(
  value: 10,
  min: 0,
  max: 100,
  step: 5,
);

NumberSpinner(controller: controller);

// Programmatic operations
controller.increment();          // 15
controller.decrement(2);         // 5
controller.setValue(75);         // 75
controller.reset();              // 10
debugPrint('${controller.progress}'); // 0.1

6. Form Validation (NumberSpinnerFormField) #

NumberSpinnerFormField(
  labelText: 'Team Seats',
  initialValue: 5,
  min: 1,
  max: 50,
  step: 1,
  autovalidateMode: AutovalidateMode.onUserInteraction,
  validator: (value) {
    if (value == null || value < 3) {
      return 'Minimum team size is 3 seats';
    }
    return null;
  },
  onSaved: (value) {
    debugPrint('Saved team seats: $value');
  },
)

⌨️ Gestures, Keyboard & Mouse Controls #

Interaction Action
Tap + / - Increments or decrements by step
Long-press + / - Continuous auto-repeat with progressive turbo acceleration
Drag Up / Right Spins value upward continuously (odometer layout)
Drag Down / Left Spins value downward continuously (odometer layout)
Tap Value Opens inline direct numeric text editor (odometer layout)
Tap Wheel / Ruler Item Smoothly animates wheel or ruler to the tapped step
ArrowUp / ArrowRight Increments by step when focused
ArrowDown / ArrowLeft Decrements by step when focused
PageUp / PageDown Steps by largeStepCount (10 steps by default)
Home / End Jumps directly to min or max
Mouse Scroll Wheel Steps up or down when hovered/focused

💖 Support & Sponsor #

This open-source library is proudly supported and powered by Humanize AI — an advanced AI platform for natural and human-like content generation.


📄 License #

Released under the MIT License.

1
likes
0
points
--
downloads

Documentation

Documentation

Publisher

verified publisherhumanize.id

Weekly Downloads

A modern, eye-catching animated number spinner, 3D wheel picker, odometer counter, and ruler slider widget library for Flutter.

Homepage
Repository (GitHub)
View/report issues

Topics

#spinner #number #picker #odometer #widget

Funding

Consider supporting this project:

humanize.id

License

unknown (license)

Dependencies

flutter

More

Packages that depend on number_spinner