Promptless AI is here soon - Production-ready contextual code. Don't just take our word for it. Know more
Know More

The Next Generation of Flutter Buttons: Understanding TextButton, ElevatedButton and OutlinedButton

No items found.

Nidhi Sorathiya

August 9, 2023

Nidhi Sorathiya

August 9, 2023

In the world of cross-platform application development, Flutter serves as a powerful tool. One of the fundamental elements contributing to an engaging user interface in Flutter is the use of buttons. Flutter buttons are essential interactive components that trigger an action when users tap or click on them. Decoding the Flutter buttons ecosystem gives us a distinctive perspective on the diverse types of buttons integrated into the Flutter SDK.

What Are Flutter Buttons?

In the visual language of a digital interface, buttons act as catalysts of functionality. They carry out specific tasks when users interact with them. For instance, a button could navigate users to the next screen, submit a form, or simply change the colour of a piece of text.

In Flutter, these buttons are brought to life via the button's widget classification. Creating any type of button in Flutter demands a clear understanding of buttons. Think of Flutter buttons as interactive widgets that respond to a series of user events, such as void main being tapped, held (long-pressed), or hovered over.

Types of Buttons in Flutter

Flutter buttons have evolved to offer a wealth of options. Initially, Flutter app developers primarily used three types of buttons: FlatButton, RaisedButton, and OutlineButton, and the other supported types like Floating Button, Drop Down Button, Icon Button, Inkwell Button, PopupMenu Button. Each Flutter button served different needs, had different styles, and enhanced various application use cases.

However, to align Flutter more closely with the Material Design specifications and ensure a more flexible, easy-to-configure button experience, Flutter has introduced enhanced versions of these buttons. These advanced versions, namely TextButton (formerly FlatButton), ElevatedButton (formerly RaisedButton), and OutlinedButton (formerly OutlineButton), not only bring an augmented user experience but also offer an easier approach to setting properties and defaults.

The Evolution of Flutter Buttons

The advent of new button widgets in Flutter is not a sudden change but a result of thoughtful progress complementing the dynamic world of UI/UX design. To understand these advancements, let's journey through the evolution of Flutter buttons, from how they were in the beginning, to what they have transformed into now.

The Next Generation of Flutter Buttons: Understanding TextButton, ElevatedButton and OutlinedButton

FlatButton in Flutter

The FlatButton, characterized by its lack of background and elevation, was an excellent choice for minimalistic design needs. It was often employed in dialogs, inline with other content, or as a part of a larger component. FlatButton drew special attention as it did not distract from non-interactive yet vital components on the screen.

Here’s an example of using the FlatButton widget.

RaisedButton in Flutter

The RaisedButton, unlike FlatButton, came with a Material Design elevation effect representing a piece of material paper hovering over the interface. The RaisedButton would raise or elevate when pressed, giving the application a subtle depth and dimension, a pleasant aesthetic experience for users.

An example of RaisedButton is as shown below:

OutlineButton in Flutter

The OutlineButton, as its name suggests, was primarily a button outlined by a thin border. This button was a considerable choice when UI required to make less-frequent or less-important actions noticeable but not prevalent.

An example of OutlineButton is as shown below:

Exploring the Button Properties

The FlatButton, RaisedButton, and OutlineButton in Flutter offered a similar set of properties that helped customize their appearance and behaviour. These properties included colors, shape, padding, and dimensions; however, the process could become slightly complex due to the large set of parameters to handle.

Recent Changes in Flutter Button Classes

Recently, the Flutter team introduced a raft of exciting changes to the Flutter Button API. A primary goal behind these modifications is to align the Flutter framework more closely with Material Design specifications, promoting an intuitive, flexible, and configuration-friendly button setup.

The Next Generation of Flutter Buttons: Understanding TextButton, ElevatedButton and OutlinedButton

The Rationale for Change

Flutter's relentless pursuit of offering a more streamlined, practical and adaptive ecosystem laid down the roadmap for these recent changes in button classes. Evolving needs for elevated customizability and adaptability were strong influences behind this development. The changes address the hurdles developers faced with the material buttons in terms of themes and constructor parameters, offering a more straightforward approach to properties' assignment, besides opening the door to enhanced UI possibilities.

Deprecation of Certain Flutter Button Classes

With the advent of modern, more adaptable button widgets, the original FlatButton, RaisedButton, and OutlineButton widgets of Flutter have been deprecated. Although these classes will continue to function for the time being, they will eventually be phased out. Developers are now encouraged to utilize the updated button classes.

For example, the FlatButton has transformed into the more versatile and stylish TextButton.

In the new TextButton widget, developers will enjoy higher flexibility in controlling the button's characteristics. The new button classes ensure an enjoyable developer experience, which is a priority when creating a user-friendly ecosystem in Flutter.

Upgraded Button Widgets in Flutter

The upgrading of Flutter's primary button widgets - FlatButton, RaisedButton, and OutlineButton, to TextButton, ElevatedButton, and OutlinedButton, respectively, marks an essential transition towards better design, enhanced usability, and improved functionality.

TextButton: The Next Generation FlatButton

The TextButton is the updated version of the FlatButton widget in Flutter. The principal characteristics that set it apart include a minimal design that doesn't distract from the overall UI and easy-to-modify visual parameters like color and padding.

In this example, we are creating a simple TextButton and printing 'TextButton pressed!' in the console after users press the button.

ElevatedButton: The Advanced RaisedButton

An ElevatedButton is the upgraded version of RaisedButton. It brings along all the excellencies of the RaisedButton, namely an elevation increase on the press, and adds a host of much-needed widgets and properties around styling and theming.

The ElevatedButton in the example above will print 'ElevatedButton pressed!' in the console when pressed.

OutlinedButton: The Updated OutlineButton

OutlinedButton refines the OutlineButton's recipe, introducing more flexible styling in terms of color, shape, and size. This button, outlined by default, grants a clear and less-dominating presence on the interface.

In the aforementioned snippet, an 'OutlinedButton pressed!' message will reflect in the console as the OutlinedButton is pressed.

A Deep Dive into The Advanced Buttons

The introduction of the newer generation of button widgets in Flutter marks a significant upgrade from the previous generation. Designed to be more versatile, adaptable, and user-friendly, these buttons come with several improvements. Let's take a more in-depth look at each of these.

The Next Generation of Flutter Buttons: Understanding TextButton, ElevatedButton and OutlinedButton

Going In-depth with the TextButton

The TextButton, inheriting the simplicity of FlatButton, is more agile and flexible. This button widget fits perfectly into scenarios that demand minimal user attention, being seamlessly integrated with other components.

The appearance of a TextButton can be customized using ButtonStyle. For example, to modify the foreground (text/icon) color of a TextButton:

In this example, the TextButton's content will be depicted in blue, overriding the default color.

Comprehensive Guide on the ElevatedButton

ElevatedButton, an advanced version of RaisedButton, contributes to a complete user experience by adding a material design elevation to the button. This widget adjusts the elevation dynamically based on the state of the button to deliver a profound feedback response to user interactions.

Customizing the ElevatedButton can be done via ButtonStyle, similar to TextButton. Here is an example:

The above example demonstrates an ElevatedButton with a green background color.

Making Sense of the OutlinedButton

OutlinedButton embodies the spirit of OutlineButton while extending more styling potentials to developers. OutlinedButton features a thin line (outline) around textual content making itself visually less imposing than other styles. This attribute makes it a preferred choice where less emphasis is desired.

OutlinedButton is also styled with the ButtonStyle object. Hence, let’s delve into an example where we modify the border color of an OutlinedButton:

In the code snippet above, we've created an OutlinedButton that showcases a bright red border when rendered on the screen.

The advanced button widgets carry the legacy of the original trio, infused with more flexibilities and configurations.

Understanding ButtonStyle Configuration

With the advanced button system in Flutter, the way we style buttons has been revamped as well. Hierarchical, cascading style sheets were regular in the old scheme of things, but now, theming is about configurations and override capabilities. The key player in this new paradigm is the ButtonStyle class.

The Role of ButtonStyle

ButtonStyle, as the name signifies, is a class that holds the descriptions for all visual properties of a button. ButtonStyle does not define the button's properties - it rather provides overrides of the default visual properties for a button. This object is often compared to TextStyle, which follows a very similar principle for text widgets.

Let's take a simple example, where we want to change the foreground color of a TextButton across all states.

In this code snippet, the ButtonStyle is used to set the button's foreground color to blue across all states.

ButtonStyle Properties

ButtonStyle holds an array of customizable properties to tweak a button's appearance. A few of these properties include backgroundColor, foregroundColor, overlayColor, shadowColor, elevation, padding, minimumSize, and shape to name a few.

To determine the value of these properties, Flutter uses the MaterialStateProperty class that can resolve the property value, based on a button's set of interactive states. These states include pressed, hovered, focused, and disabled. Thus, with ButtonStyle and MaterialStateProperty, styling buttons becomes efficient and intuitive.

How to Use MaterialStateProperty?

MaterialStateProperty is an interface that is designed to resolve a value of a certain type based on the interactive state of a component. To explain how MaterialStateProperty works, let's customize the overlay color of a TextButton.

In this code snippet, we've customized the overlayColor property of a TextButton using MaterialStateProperty. Based on the button's state, it returns a different value for the overlay color.

Theme Customization for Advanced Buttons

With the newer set of buttons, theming becomes way more intuitive and flexible. Flutter introduces dedicated Theme classes for each button, namely TextButtonTheme, ElevatedButtonTheme, and OutlinedButtonTheme. These allow you to specify a ButtonStyle for a set of buttons and create uniformity.

Customizing the Theme for TextButton

TextButtonTheme is a widget that specifies the ButtonStyle for TextButton widgets within it.

You can specify the default ButtonStyle within the widget tree using TextButtonTheme. Here is an example:

The above snippet applies a global theme for TextButtons using TextButtonThemeData.

Personalizing the Theme for ElevatedButton

ElevatedButtonTheme works in a similar way for ElevatedButtons. It specifies a ButtonStyle which is used for all ElevatedButton widgets inside it.

For example, to apply a custom theme to all ElevatedButtons within an app:

The example above specifies a universal theme for ElevatedButtons using ElevatedButtonThemeData.

Adjusting the Theme for OutlinedButton

In the same manner, OutlinedButtonTheme allows you to specify a ButtonStyle for Outlined Buttons. Here's an example of how to adjust a theme for all OutlinedButtons present in the app:

In this code snippet, we are assigning a blue border with a width of 2 to all OutlinedButtons using OutlinedButtonThemeData.

Essentials of Theme Customizations

The new themes follow the "normalized" pattern that Flutter adopted for Material widgets. Theme properties and widget constructor parameters are null by default, then non-null theme properties and widget parameters specify an override of the component's default value. Implementing and documenting default values is the responsibility of the button component widgets.

The theme customization available with the latest set of buttons makes it effortless to create a consistent look and feel across all buttons in your app. Remember, the button's style parameter overrides non-null properties specified by the corresponding button theme.

Hands-on Guide: Implementing Advanced Flutter Buttons

Now that we've familiarized ourselves with Flutter's advanced button widgets and their associated themes, it's time to put theory into practice. Let's look at how we can customize and implement these improved buttons.

The Next Generation of Flutter Buttons: Understanding TextButton, ElevatedButton and OutlinedButton

Crafting Custom Buttons with Enhanced Functionality

Each of the newer button widgets has a unique character in terms of visual appeal and use cases. Understanding how these differences and similarities play out in a coding context will provide better insights into their use.

Customizing TextButton

With TextButton, it's straightforward to accommodate various styles, colors, and layouts. We can fully personalize it according to design requirements. In the example below, we create a TextButton with custom style:

This TextButton appears with a purple text color on a yellow background.

Customizing ElevatedButton

Similarly, in ElevatedButton, developers can bring in their own touch to the widget. Combining it with Material Design elevations can make the interface dynamic and enjoyable. Here's an example of a customized ElevatedButton:

The given example shows an ElevatedButton with a blue background and an elevation of 3.

Customizing OutlinedButton

OutlinedButton provides a unique opportunity to create a distinct aesthetic appeal with outlined text content. The customizability allows for a flexible implementation in various UI scenarios. Here's a basic example:

This OutlinedButton is designed with a thick red border around the button.

Crafting custom buttons with Flutter presents an avenue to explore your creativity. While offering various options for personalization, it ensures that the app's final look aligns with your vision.

API Changes: Migrating from Original to Advanced Button Widgets in Flutter

With the recent changes in widgets and classes in Flutter, developers may need to update their existing codebase to adapt to these new advancements. Migrating may seem like a daunting task, but Flutter has approached this transition in a way that minimizes the friction.

Here, we'll go through some essential concepts when transitioning from the original buttons to the advanced buttons in Flutter.

Retaining the Aesthetics of Original Buttons

For most applications, simply swapping the widget names (FlatButton to TextButton, RaisedButton to ElevatedButton, and OutlineButton to OutlinedButton) should suffice. However, some visual changes might occur due to the updated Material Design specifications. If retaining the look of the original buttons is desired, we can define button styles that match the original visual configurations.

Take this example where we create a TextButton that closely resembles a default FlatButton:

Migrating Buttons with Custom Foreground and Background Colors

While moving from original buttons to advanced buttons, one frequently encountered case is customizing foreground and background colors. This might involve a minor adjustment to property assignments, but the logic remains the same.

Consider an example where RaisedButton is replaced by ElevatedButton:

In this code snippet, we create an ElevatedButton with a red background and white foreground color.

Migrating Buttons with Custom Overlay Colors

Some buttons may have been customized with different focus, hover, or splash colors. Instead of defining individual colors for each state, Flutter now encourages the use of a MaterialStateProperty<Color> to handle all these states.

Here's how you can migrate this feature:

In the above example, we customize the TextButton's overlay color to change as it focuses, hovers or pressed interactively.

Migrating Buttons with Custom Disabled Colors

Customizing a button’s disabled state colors is a relatively rare case, but there might be scenarios where you've defined custom colors for disabled foreground or background in FlatButton, RaisedButton, or OutlineButton.

To migrate this customization, you can use the styleFrom method for straightforward color adjustments:

This example shows an ElevatedButton whose disabled colors are overridden with the color red.

For complete control over the disabled colors, we must define the style explicitly, in terms of MaterialStateProperties. For instance:

In the above code, we've customized an ElevatedButton that turns the background color to red and the foreground color to blue when disabled.

Migrating Buttons with Custom Shapes and Borders

Buttons often have custom shapes and borders to align with the application's overall aesthetics. With the new button classes, there have been changes in how borders and shapes are defined.

Earlier, a button's shape and the appearance of its outline were defined using the same parameter. However, with the recent changes, these properties are specified separately with OutlinedBorder shape and BorderSide side parameters.

Let's look at an example where an OutlinedButton is styled to resemble an OutlineButton with a custom border:

As you see in the code snippet above, the OutlinedButton is styled to have a red border when pressed, mimicking the look of an OutlineButton.

Final Thoughts: Riding the Wave of Progress with Flutter Buttons

The journey of adapting to new technologies can sometimes be challenging, but it's also exciting and rewarding. The evolution of Flutter buttons is no exception. Shifting from FlatButton, RaisedButton, and OutlineButton to TextButton, ElevatedButton, and OutlinedButton, Flutter has made strides towards an improved developer experience and a customizable button ecosystem.

Ensuring Smooth Transition by Preserving Backward Compatibility

Despite the significant changes that come with the advanced buttons, Flutter has meticulously designed the transition to be as smooth as possible. Existing applications can confidently continue to function with the deprecated buttons until developers decide to move to the newly improved versions.

Harness the Power of WiseGPT for Optimal App Development

Abiding by the philosophy of continuous improvement, Flutter unceasingly evolves to adapt to changing developer needs and industry trends. By staying on top of these changes and utilizing the latest features, developers can harness the full capabilities of Flutter.

Every application developed with Flutter hones the essentiality of widgets in creating beautiful, intuitive, and interactive UIs. Joining this convenience bandwagon is WiseGPT, a handy Flutter IDE plugin that's on a mission to render your Flutter development faster, more efficient. By crafting code for your chosen Button widgets directly into your Flutter apps UI files, also aligning with your coding style in the process, WiseGPT eliminates any need for manual development in the entire app development lifecycle.

The Next Generation of Flutter Buttons: Understanding TextButton, ElevatedButton and OutlinedButton


  • Prioritizes your learning while reducing room for error.
  • An intelligent code generation solution safeguards against any common pitfalls that might appear while dealing with complex constructs like widget trees or handling complex API endpoints in Flutter.

But, as the saying goes, practice makes perfect. Go ahead, design an app, create intricate Buttons for your apps, and play around with the concepts you've learned today. Make Flutter and WiseGPT your allies, harness the power of widgets and watch as your vision transforms into a tangible, interactive, beautiful Flutter app.

Remember, migrating to the new button widgets is not an urgent requirement but a recommended future step. Embrace the change, play with the new buttons, explore their capabilities, understand their application, and when you feel ready, let them make your app shine.

This brings us to the end of this journey of exploring advanced Flutter buttons. It was an exciting ride, going through the evolution, understanding the changes, and bearing witness to what future Flutter development holds.

Keep exploring, keep coding, and keep creating fantastic apps with Flutter! 💙

Frequently asked questions

Q: What replaced the FlatButton in Flutter?

Flutter has replaced the FlatButton widget with the TextButton widget. This newer iteration of the button widget offers advanced customizations, enhanced usability, and aligns better with the Material Design specifications.

Q: What is the text only button in Flutter?

In Flutter, the TextButton is the text-only button. It is the successor to the FlatButton. Despite its seeming simplicity, it has excellent adaptability and flexibility, offering extensive customizability regarding coloring, theming, and sizing.

Q: What is the difference between FlatButton and TextButton in Flutter?

The main difference between FlatButton and TextButton in Flutter lies in configurability and Material Design alignment. Even though they have similar functions, the TextButton widget offers a more comprehensive set of customization options and is designed to better align with the Material Design guidelines. Flutter's recommendation is to use TextButton in place of FlatButton for future development.

Q: What is the difference between FlatButton and RaisedButton in Flutter?

The primary difference between FlatButton and RaisedButton lies in their aesthetics. While a FlatButton has no shadow and could seem embedded in the parent widget (like inline text links or dialog buttons), RaisedButton has material design elevations and shadows, providing depth to the layout and making it stand out. However, both FlatButton and RaisedButton have now been replaced with TextButton and ElevatedButton, respectively, for their enhanced capabilities.

Frequently asked questions

No items found.