Switch class
A material design switch.
Used to toggle the on/off state of a single setting.
The switch itself does not maintain any state. Instead, when the state of the switch changes, the widget calls the onChanged callback. Most widgets that use a switch will listen for the onChanged callback and rebuild the switch with a new value to update the visual appearance of the switch.
Requires one of its ancestors to be a Material widget.
See also:
- SwitchListTile, which combines this widget with a ListTile so that you can give the switch a label.
- Checkbox, another widget with similar semantics.
- Radio, for selecting among a set of explicit values.
- Slider, for selecting a value in a range.
- material.google.com/components/selection-controls.html#selection-controls-switch
- Inheritance
Constructors
-
Switch({Key key, @required bool value, @required ValueChanged<
bool> onChanged, Color activeColor, Color activeTrackColor, Color inactiveThumbColor, Color inactiveTrackColor, ImageProvider activeThumbImage, ImageProvider inactiveThumbImage, MaterialTapTargetSize materialTapTargetSize }) -
Creates a material design switch. [...]
const
-
Switch.adaptive({Key key, @required bool value, @required ValueChanged<
bool> onChanged, Color activeColor, Color activeTrackColor, Color inactiveThumbColor, Color inactiveTrackColor, ImageProvider activeThumbImage, ImageProvider inactiveThumbImage, MaterialTapTargetSize materialTapTargetSize }) -
Creates a CupertinoSwitch if the target platform is iOS, creates a
material design switch otherwise. [...]
const
Properties
- activeColor → Color
-
The color to use when this switch is on. [...]
final
- activeThumbImage → ImageProvider
-
An image to use on the thumb of this switch when the switch is on. [...]
final
- activeTrackColor → Color
-
The color to use on the track when this switch is on. [...]
final
- inactiveThumbColor → Color
-
The color to use on the thumb when this switch is off. [...]
final
- inactiveThumbImage → ImageProvider
-
An image to use on the thumb of this switch when the switch is off. [...]
final
- inactiveTrackColor → Color
-
The color to use on the track when this switch is off. [...]
final
- materialTapTargetSize → MaterialTapTargetSize
-
Configures the minimum size of the tap target. [...]
final
-
onChanged
→ ValueChanged<
bool> -
Called when the user toggles the switch on or off. [...]
final
- value → bool
-
Whether this switch is on or off. [...]
final
- hashCode → int
-
The hash code for this object. [...]
read-only, inherited
- key → Key
-
Controls how one widget replaces another widget in the tree. [...]
final, inherited
- runtimeType → Type
-
A representation of the runtime type of the object.
read-only, inherited
Methods
-
createState(
) → _SwitchState -
Creates the mutable state for this widget at a given location in the tree. [...]
override
-
debugFillProperties(
DiagnosticPropertiesBuilder properties) → void -
Add additional properties associated with the node. [...]
override
-
createElement(
) → StatefulElement -
Creates a StatefulElement to manage this widget's location in the tree. [...]
inherited
-
debugDescribeChildren(
) → List< DiagnosticsNode> -
Returns a list of DiagnosticsNode objects describing this node's
children. [...]
@protected, inherited
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a non-existent 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 toStringDeep. [...]
inherited
-
toString(
{DiagnosticLevel minLevel: DiagnosticLevel.debug }) → String -
Returns 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 ==(
dynamic other) → bool -
The equality operator. [...]
inherited