MaterialButton class Null safety
A utility class for building Material buttons that depend on the ambient ButtonTheme and Theme.
This class is obsolete.
FlatButton and RaisedButton have been replaced by
TextButton and ElevatedButton respectively.
ButtonTheme has been replaced by TextButtonTheme and
ElevatedButtonTheme. The appearance of the
new widgets can be customized by specifying a ButtonStyle
or by creating a one-off style using a styleFrom
method like
TextButton.styleFrom. The original button classes
have been deprecated, please migrate code that uses them.
There's a detailed migration guide for the new button and button
theme classes in
flutter.dev/go/material-button-migration-guide.
The button's size will expand to fit the child widget, if necessary.
MaterialButtons whose onPressed and onLongPress callbacks are null will be disabled. To have an enabled button, make sure to pass a non-null value for onPressed or onLongPress.
Rather than using this class directly, consider using FlatButton or RaisedButton, which configure this class with appropriate defaults that match the material design specification.
To create a button directly, without inheriting theme defaults, use RawMaterialButton.
If you want an ink-splash effect for taps, but don't want to use a button, consider using InkWell directly.
See also:
- IconButton, to create buttons that contain icons rather than text.
- Inheritance
- Object
- DiagnosticableTree
- Widget
- StatelessWidget
- MaterialButton
- Implementers
Constructors
-
MaterialButton({Key? key, required VoidCallback? onPressed, VoidCallback? onLongPress, ValueChanged<
bool> ? onHighlightChanged, MouseCursor? mouseCursor, ButtonTextTheme? textTheme, Color? textColor, Color? disabledTextColor, Color? color, Color? disabledColor, Color? focusColor, Color? hoverColor, Color? highlightColor, Color? splashColor, Brightness? colorBrightness, double? elevation, double? focusElevation, double? hoverElevation, double? highlightElevation, double? disabledElevation, EdgeInsetsGeometry? padding, VisualDensity? visualDensity, ShapeBorder? shape, Clip clipBehavior = Clip.none, FocusNode? focusNode, bool autofocus = false, MaterialTapTargetSize? materialTapTargetSize, Duration? animationDuration, double? minWidth, double? height, bool enableFeedback = true, Widget? child}) -
Creates a material button. [...]
const
Properties
- animationDuration → Duration?
-
Defines the duration of animated changes for shape and elevation. [...]
final
- autofocus → bool
-
True if this widget will be selected as the initial focus when no other
node in its scope is currently focused. [...]
final
- child → Widget?
-
The button's label. [...]
final
- clipBehavior → Clip
-
The content will be clipped (or not) according to this option. [...]
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 relative to its parent 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 relative to its parent. [...]
final
- enabled → bool
-
Whether the button is enabled or disabled. [...]
read-only
- enableFeedback → bool
-
Whether detected gestures should provide acoustic and/or haptic feedback. [...]
final
- focusColor → Color?
-
The fill color of the button's Material when it has the input focus. [...]
final
- focusElevation → double?
-
The elevation for the button's Material when the button
is enabled and has the input focus. [...]
final
- focusNode → FocusNode?
-
An optional focus node to use as the focus node for this widget. [...]
final
- hashCode → int
-
The hash code for this object. [...]
@nonVirtual, read-only, inherited
- height → double?
-
The vertical extent of the button. [...]
final
- highlightColor → Color?
-
The highlight color of the button's InkWell. [...]
final
- highlightElevation → double?
-
The elevation for the button's Material relative to its parent when the
button is enabled and pressed. [...]
final
- hoverColor → Color?
-
The fill color of the button's Material when a pointer is hovering over
it. [...]
final
- hoverElevation → double?
-
The elevation for the button's Material when the button
is enabled and a pointer is hovering over it. [...]
final
- key → Key?
-
Controls how one widget replaces another widget in the tree. [...]
final, inherited
- materialTapTargetSize → MaterialTapTargetSize?
-
Configures the minimum size of the tap target. [...]
final
- minWidth → double?
-
The smallest horizontal extent that the button will occupy. [...]
final
- mouseCursor → MouseCursor?
-
The cursor for a mouse pointer when it enters or is hovering over the
button. [...]
final
-
onHighlightChanged
→ ValueChanged<
bool> ? -
Called by the underlying InkWell widget's InkWell.onHighlightChanged
callback. [...]
final
- onLongPress → VoidCallback?
-
The callback that is called when the button is long-pressed. [...]
final
- onPressed → VoidCallback?
-
The callback that is called when the button is tapped or otherwise activated. [...]
final
- padding → EdgeInsetsGeometry?
-
The internal padding for the button's child. [...]
final
- runtimeType → Type
-
A representation of the runtime type of the object.
read-only, inherited
- 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
- visualDensity → VisualDensity?
-
Defines how compact the button's layout will be. [...]
final
Methods
-
build(
BuildContext context) → Widget -
Describes the part of the user interface represented by this widget. [...]
override
-
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 -
debugFillProperties(
DiagnosticPropertiesBuilder properties) → void -
Add additional properties associated with the node. [...]
override
-
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 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. [...]
@nonVirtual, inherited