XButton class

A customizable button widget that supports icons, loading state, custom text widget, rounded style, and various appearance configurations.

The XButton is designed to simplify button creation with flexible styling using XButtonStyle. It supports prefix, center, and suffix icons, loading indicator, disabled state, and forced tap functionality.

This widget is suitable for most general button use-cases in Flutter apps.

Example:

XButton(
  label: "Submit",
  onPressed: () {},
  style: XButtonStyle(background: Colors.blue),
);

Inheritance

• Object
• DiagnosticableTree
• Widget
• StatelessWidget
• XButton

Constructors

XButton({Key? key, required Function onPressed, String? label, double radius = 5, XButtonStyle? style, TextStyle? textStyle, bool isLoading = false, bool isEnable = true, bool? isForceTap = false, Widget? child, double? width, double? height, bool widthInfinity = false})

const

Properties

child → Widget?

Custom widget to replace the label text, useful for advanced text layouts.

final

hashCode → int

The hash code for this object.

no setter, inherited

height → double?

Custom height of the button. Defaults to 48.

final

isEnable → bool

Controls whether the button is enabled.

final

isForceTap → bool?

Force the onPressed function to run even when isEnable is false.

final

isLoading → bool

Whether to show a loading indicator instead of the button.

final

key → Key?

Controls how one widget replaces another widget in the tree.

final, inherited

label → String?

Text label displayed on the button.

final

onPressed → Function

Called when the button is tapped.

final

radius → double

Border radius for the button shape.

final

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

style → XButtonStyle?

Custom style configuration for the button.

final

textStyle → TextStyle?

final

width → double?

final

widthInfinity → bool

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.

inherited

debugFillProperties(DiagnosticPropertiesBuilder properties) → void

Add additional properties associated with the node.

inherited

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent 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, int wrapWidth = 65}) → 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.

inherited