ArnaSlider class
An Arna-styled slider.
Used to select from a range of values.
A slider can be used to select from either a continuous or a discrete set of values. The default is use a continuous range of values from min to max. To use discrete values, use a non-null value for divisions, which indicates the number of discrete intervals. For example, if min is 0.0 and max is 50.0 and divisions is 5, then the slider can take on the values discrete values 0.0, 10.0, 20.0, 30.0, 40.0, and 50.0.
The slider will be disabled if onChanged is null or if the range given by min..max is empty (i.e. if min is equal to max).
The slider widget itself does not maintain any state. Instead, when the state of the slider changes, the widget calls the onChanged callback. Most widgets that use a slider will listen for the onChanged callback and rebuild the slider with a new value to update the visual appearance of the slider. To know when the value starts to change, or when it is done changing, set the optional callbacks onChangeStart and/or onChangeEnd.
By default, a slider will be as wide as possible, centered vertically.
Requires one of its ancestors to be a MediaQuery widget. Typically, these are introduced by the ArnaApp or WidgetsApp widget at the top of your application widget tree.
See also:
- ArnaRadio, for selecting among a set of explicit values.
- ArnaCheckbox and ArnaSwitch, for toggling a particular value on or off.
- MediaQuery, from which the text scale factor is obtained.
- Inheritance
-
- Object
- DiagnosticableTree
- Widget
- StatefulWidget
- ArnaSlider
Constructors
-
ArnaSlider({Key? key, required double value, required ValueChanged<
double> ? onChanged, ValueChanged<double> ? onChangeStart, ValueChanged<double> ? onChangeEnd, double min = 0.0, double max = 1.0, int? divisions, bool isFocusable = true, bool autofocus = false, Color? accentColor, MouseCursor cursor = MouseCursor.defer}) -
Creates an Arna-styled slider.
const
Properties
- accentColor → Color?
-
The color of the slider's progress.
final
- autofocus → bool
-
Whether this slider should focus itself if nothing else is already
focused.
final
- cursor → MouseCursor
-
The cursor for a mouse pointer when it enters or is hovering over the
slider.
final
- divisions → int?
-
The number of discrete divisions.
final
- hashCode → int
-
The hash code for this object.
no setterinherited
- isFocusable → bool
-
Whether this slider is focusable or not.
final
- key → Key?
-
Controls how one widget replaces another widget in the tree.
finalinherited
- max → double
-
The maximum value the user can select.
final
- min → double
-
The minimum value the user can select.
final
-
onChanged
→ ValueChanged<
double> ? -
Called during a drag when the user is selecting a new value for the slider by dragging.
final
-
onChangeEnd
→ ValueChanged<
double> ? -
Called when the user is done selecting a new value for the slider.
final
-
onChangeStart
→ ValueChanged<
double> ? -
Called when the user starts selecting a new value for the slider.
final
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- value → double
-
The currently selected value for this slider.
final
Methods
-
createElement(
) → StatefulElement -
Creates a StatefulElement to manage this widget's location in the tree.
inherited
-
createState(
) → State< ArnaSlider> -
Creates the mutable state for this widget at a given location in the tree.
override
-
debugDescribeChildren(
) → List< DiagnosticsNode> -
Returns a list of
DiagnosticsNode
objects describing this node's children.inherited -
debugFillProperties(
DiagnosticPropertiesBuilder properties) → void -
Add additional properties associated with the node.
override
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toDiagnosticsNode(
{String? name, DiagnosticsTreeStyle? style}) → DiagnosticsNode -
Returns a debug representation of the object that is used by debugging
tools and by DiagnosticsNode.toStringDeep.
inherited
-
toString(
{DiagnosticLevel minLevel = DiagnosticLevel.info}) → String -
A string representation of this object.
inherited
-
toStringDeep(
{String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug}) → String -
Returns a string representation of this node and its descendants.
inherited
-
toStringShallow(
{String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) → String -
Returns a one-line detailed description of the object.
inherited
-
toStringShort(
) → String -
A short, textual description of this widget.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited