A material design "flat button".

A flat button is a section printed on a Material widget that reacts to touches by filling with color.

Use flat buttons on toolbars, in dialogs, or inline with other content but offset from that content with padding so that the button's presence is obvious. Flat buttons intentionally do not have visible borders and must therefore rely on their position relative to other content for context. In dialogs and cards, they should be grouped together in one of the bottom corners. Avoid using flat buttons where they would blend in with other content, for example in the middle of lists.

Material design flat buttons have an all-caps label, some internal padding, and some defined dimensions. To have a part of your application be interactive, with ink splashes, without also committing to these stylistic choices, consider using InkWell instead.

If the onPressed callback is null, then the button will be disabled, will not react to touch, and will be colored as specified by the disabledColor property instead of the color property. 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.

Requires one of its ancestors to be a Material widget.

Flat buttons will expand to fit the child widget, if necessary.

See also:



FlatButton({Key key, @required VoidCallback onPressed, Color textColor, Color disabledTextColor, Color color, Color highlightColor, Color splashColor, Color disabledColor, ButtonTextTheme textTheme, Brightness colorBrightness, @required Widget child })
Creates a flat button. [...]


child Widget
The widget below this widget in the tree. [...]
color Color
The primary color of the button, as printed on the Material, while it is in its default (unpressed, enabled) state. [...]
colorBrightness Brightness
The theme brightness to use for this button. [...]
disabledColor Color
The color of the button when the button is disabled. [...]
disabledTextColor Color
The color to use for this button's text when the button cannot be pressed. [...]
enabled bool
Whether the button is enabled or disabled. [...]
highlightColor Color
The secondary color of the button when the button is in the down (pressed) state. [...]
onPressed VoidCallback
The callback that is called when the button is tapped or otherwise activated. [...]
splashColor Color
The primary color of the button when the button is in the down (pressed) state. [...]
textColor Color
The color to use for this button's text. [...]
textTheme ButtonTextTheme
The color scheme to use for this button's text. [...]
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


build(BuildContext context) Widget
Describes the part of the user interface represented by this widget. [...]
debugFillProperties(DiagnosticPropertiesBuilder description) → void
createElement() StatelessElement
Creates a StatelessElement to manage this widget's location in the tree. [...]
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. [...]
toDiagnosticsNode({String name, DiagnosticsTreeStyle style }) DiagnosticsNode
Returns a debug representation of the object that is used by debugging tools and by toStringDeep. [...]
toString({DiagnosticLevel minLevel: DiagnosticLevel.debug }) String
Returns a string representation of this object.
toStringDeep({String prefixLineOne: '', String prefixOtherLines, DiagnosticLevel minLevel: DiagnosticLevel.debug }) String
Returns a string representation of this node and its descendants. [...]
toStringShallow({String joiner: ', ', DiagnosticLevel minLevel: DiagnosticLevel.debug }) String
Returns a one-line detailed description of the object. [...]
toStringShort() String
A short, textual description of this widget.


operator ==(other) bool
The equality operator. [...]