Build Fluid Sliders in Flutter with Fluid Slider
Fluid Slider for Flutter
Inspired by a dribbble by Virgil Pana.
A fluid design slider that works just like the Slider material widget.
Used to select from a range of values.
Installation
Just add the package to your dependencies in the pubspec.yaml file:
dependencies:
flutter_fluid_slider: ^1.0.2
Basic Usage
Place the FluidSlider in your widget tree.
FluidSlider(
value: _value,
onChanged: (double newValue) {
setState(() {
_value = newValue;
});
},
min: 0.0,
max: 100.0,
),
Properties
value : [Required] The currently selected value for this slider. The slider's thumb is drawn at a position that corresponds to this value.
min : The minimum value the user can select. Defaults to 0.0. Must be less than or equal to max.
max : The maximum value the user can select. Defaults to 1.0. Must be less than or equal to min.
start : The widget to be displayed as the min label. For eg: an Icon can be displayed. If not provided the min value is displayed as text.
end : The widget to be displayed as the max label. For eg: an Icon can be displayed. If not provided the max value is displayed as text.
onChanged : [Required] Called during a drag when the user is selecting a new value for the slider
by dragging.
The slider passes the new value to the callback but does not actually change state until the parent widget rebuilds the slider with the new value.
If null, the slider will be displayed as disabled.
onChangeStart : Called when the user starts selecting a new value for the slider. The value passed will be the last value that the slider had before the change began.
onChangeEnd : Called when the user is done selecting a new value for the slider.
labelsTextStyle : The styling of the min and max text that gets displayed on the slider. If not provided the ancestor Theme's accentTextTheme text style will be applied.
valueTextStyle : The styling of the current value text that gets displayed on the slider. If not provided the ancestor Theme's textTheme.title text style with bold will be applied .
sliderColor : The color of the slider. If not provided the ancestor Theme's primaryColor will be applied.
thumbColor : The color of the thumb. If not provided the Colors.white will be applied.
showDecimalValue : Whether to display the first decimal value of the slider value. Defaults to false.
mapValueToString : called with value for the String to be rendered in the slider's thumb. E.g. display roman integers as follows:
See example. If null the value is converted to String based on [showDecimalValue].
FluidSlider(
value:_val,
min:1.0,
max:5.0,
onChanged:(){},
mapValueToString: (double value){
List<String> romanNumerals=['I', 'II', 'III', 'IV', 'V'];
return _romanNumerals[value.toInt() - 1];
}
)
Credits:
- Ramotion - implementation for ios and android
- Virgil Pana - creating the original concept
Download details:
Author: rvamsikrishna
Source: https://github.com/rvamsikrishna/flutter_fluid_slider
License: MIT license
