simple_ruler_picker 0.1.1
SDKflutter
Platformandroidioswindowslinuxmacosweb
A simple and customizable ruler picker widget for Flutter that enables users to pick values by scrolling through a ruler-like interface.
Simple Ruler Picker
SimpleRulerPicker is a customizable ruler-style number picker for Flutter, allowing users to scroll through and select a number between a minimum and maximum value.
Features
- Scrollable Number Picker: Allows users to scroll through a range of numbers, from
minValuetomaxValue. - Customizable Scale: You can adjust the size of scale labels, the width between scale items, and the heights of the ruler lines.
Preview
| Portrait | Landscape |
|---|---|
![]() | ![]() |
Getting started
Installation
Add simple_ruler_picker to your project's pubspec.yaml file:
dependencies:
simple_ruler_picker: ^0.1.0
Or
flutter pub add simple_ruler_picker
Usage
SimpleRulerPicker(
minValue: 0,
maxValue: 100,
initialValue: 50,
onValueChanged: (value) {
print("Selected value: $value");
},
scaleLabelSize: 16,
scaleBottomPadding: 8,
scaleItemWidth: 12,
longLineHeight: 30,
shortLineHeight: 15,
lineColor: Colors.black,
selectedColor: Colors.blue,
labelColor: Colors.black,
lineStroke: 3,
height: 120,
)
Properties
| Property | Type | Default | Description | Example |
|---|---|---|---|---|
minValue | int | 0 | The minimum value that can be selected. | minValue: 0 |
maxValue | int | 200 | The maximum value that can be selected. | maxValue: 100 |
initialValue | int | 100 | The initial value displayed when the picker is first shown. Must be between minValue and maxValue. | initialValue: 50 |
scaleLabelSize | double | 14 | The size of the text for the scale labels. | scaleLabelSize: 16 |
scaleLabelWidth | double | 40 | The width of the text for the scale labels when axis is vertical. | scaleLabelWidth: 40 |
scaleBottomPadding | double | 6 | Padding below the scale labels, creating space between the labels and the bottom of the picker. | scaleBottomPadding: 8 |
scaleItemWidth | int | 10 | The width of each scale item (i.e., the distance between the lines on the ruler). | scaleItemWidth: 15 |
onValueChanged | ValueChanged<int> | null | Callback triggered whenever the selected value changes. | onValueChanged: (value) => print(value) |
longLineHeight | double | 24 | Height of the long lines in the ruler (typically for major units). | longLineHeight: 30 |
shortLineHeight | double | 12 | Height of the short lines in the ruler (typically for minor units). | shortLineHeight: 15 |
lineColor | Color | Colors.grey | Color of the ruler's lines (both long and short). | lineColor: Colors.black |
selectedColor | Color | Colors.orange | Color of the selected item on the ruler. | selectedColor: Colors.blue |
labelColor | Color | Colors.grey | Color of the scale labels. | labelColor: Colors.black |
lineStroke | double | 2 | The thickness (stroke width) of the ruler's lines. | lineStroke: 3 |
height | double | 100 | The overall height of the ruler picker. | height: 120 |
Additional information
Contributing
We welcome contributions! If you want to improve the SimpleRulerPicker or add more features, feel free to fork the repository and submit a pull request.
Filing Issues
Found a bug or need an enhancement? Open an issue on our GitHub repository here.

