RaisedButton class

A material design "raised button".

A raised button is based on a Material widget whose Material.elevation increases when the button is pressed.

Use raised buttons to add dimension to otherwise mostly flat layouts, e.g. in long busy lists of content, or in wide spaces. Avoid using raised buttons on already-raised content such as dialogs or cards.

If the onPressed callback is null, then the button will be disabled and by default will resemble a flat button in the disabledColor. If you are trying to change the button's color and it is not having any effect, check that you are passing a non-null onPressed handler.

If you want an ink-splash effect for taps, but don't want to use a button, consider using InkWell directly.

Raised buttons have a minimum size of 88.0 by 36.0 which can be overidden with ButtonTheme.

See also:

Inheritance

Constructors

RaisedButton({Key key, @required VoidCallback onPressed, ValueChanged<bool> onHighlightChanged, ButtonTextTheme textTheme, Color textColor, Color disabledTextColor, Color color, Color disabledColor, Color highlightColor, Color splashColor, Brightness colorBrightness, double elevation: 2.0, double highlightElevation: 8.0, double disabledElevation: 0.0, EdgeInsetsGeometry padding, ShapeBorder shape, Duration animationDuration: kThemeChangeDuration, Widget child })
Create a filled button. [...]
const
RaisedButton.icon({Key key, @required VoidCallback onPressed, ValueChanged<bool> onHighlightChanged, ButtonTextTheme textTheme, Color textColor, Color disabledTextColor, Color color, Color disabledColor, Color highlightColor, Color splashColor, Brightness colorBrightness, double elevation: 2.0, double highlightElevation: 8.0, double disabledElevation: 0.0, ShapeBorder shape, Duration animationDuration: kThemeChangeDuration, @required Widget icon, @required Widget label })
Create a filled button from a pair of widgets that serve as the button's icon and label. [...]

Properties

animationDuration Duration
Defines the duration of animated changes for shape and elevation. [...]
final
child Widget
The button's label. [...]
final
color Color
The button's fill color, displayed by its Material, while it is in its default (unpressed, enabled) state. [...]
final
colorBrightness Brightness
The theme brightness to use for this button. [...]
final
disabledColor Color
The fill color of the button when the button is disabled. [...]
final
disabledElevation double
The elevation for the button's Material when the button is not enabled. [...]
final
disabledTextColor Color
The color to use for this button's text when the button is disabled. [...]
final
elevation double
The z-coordinate at which to place this button. This controls the size of the shadow below the raised button. [...]
final
enabled bool
Whether the button is enabled or disabled. [...]
read-only
highlightColor Color
The highlight color of the button's InkWell. [...]
final
highlightElevation double
The elevation for the button's Material when the button is enabled but not pressed. [...]
final
onHighlightChanged ValueChanged<bool>
Called by the underlying InkWell widget's InkWell.onHighlightChanged callback.
final
onPressed VoidCallback
Called when the button is tapped or otherwise activated. [...]
final
padding EdgeInsetsGeometry
The internal padding for the button's child. [...]
final
shape ShapeBorder
The shape of the button's Material. [...]
final
splashColor Color
The splash color of the button's InkWell. [...]
final
textColor Color
The color to use for this button's text. [...]
final
textTheme ButtonTextTheme
Defines the button's base colors, and the defaults for the button's minimum size, internal padding, and shape. [...]
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

build(BuildContext context) Widget
Describes the part of the user interface represented by this widget. [...]
debugFillProperties(DiagnosticPropertiesBuilder properties) → void
createElement() StatelessElement
Creates a StatelessElement 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