Button constructor

const Button({
  1. Key? key,
  2. WidgetStatesController? statesController,
  3. Widget? leading,
  4. Widget? trailing,
  5. required Widget child,
  6. VoidCallback? onPressed,
  7. FocusNode? focusNode,
  8. AlignmentGeometry? alignment,
  9. required AbstractButtonStyle style,
  10. bool? enabled,
  11. bool disableTransition = false,
  12. ValueChanged<bool>? onFocus,
  13. ValueChanged<bool>? onHover,
  14. bool disableHoverEffect = false,
  15. bool? enableFeedback,
  16. GestureTapDownCallback? onTapDown,
  17. GestureTapUpCallback? onTapUp,
  18. GestureTapCancelCallback? onTapCancel,
  19. GestureTapDownCallback? onSecondaryTapDown,
  20. GestureTapUpCallback? onSecondaryTapUp,
  21. GestureTapCancelCallback? onSecondaryTapCancel,
  22. GestureTapDownCallback? onTertiaryTapDown,
  23. GestureTapUpCallback? onTertiaryTapUp,
  24. GestureTapCancelCallback? onTertiaryTapCancel,
  25. GestureLongPressStartCallback? onLongPressStart,
  26. GestureLongPressUpCallback? onLongPressUp,
  27. GestureLongPressMoveUpdateCallback? onLongPressMoveUpdate,
  28. GestureLongPressEndCallback? onLongPressEnd,
  29. GestureLongPressUpCallback? onSecondaryLongPress,
  30. GestureLongPressUpCallback? onTertiaryLongPress,
  31. AlignmentGeometry? marginAlignment,
  32. bool disableFocusOutline = false,
})

Creates a Button with custom styling.

This is the base constructor that allows complete customization of the button's appearance and behavior through the style parameter. For common use cases, consider using the named constructors like Button.primary or Button.secondary.

Parameters:

  • statesController (WidgetStatesController?, optional): External state management.
  • leading (Widget?, optional): Widget displayed before the main content.
  • trailing (Widget?, optional): Widget displayed after the main content.
  • child (Widget, required): Main content of the button.
  • onPressed (VoidCallback?, optional): Primary action callback.
  • focusNode (FocusNode?, optional): Focus management node.
  • alignment (AlignmentGeometry?, optional): Content alignment within button.
  • style (AbstractButtonStyle, required): Visual styling configuration.
  • enabled (bool?, optional): Whether button responds to interactions.
  • disableTransition (bool, default: false): Whether to disable state animations.
  • onFocus (ValueChanged
  • onHover (ValueChanged
  • disableHoverEffect (bool, default: false): Whether to disable hover visuals.
  • enableFeedback (bool?, optional): Whether to provide haptic feedback.
  • marginAlignment (AlignmentGeometry?, optional): Margin positioning.
  • disableFocusOutline (bool, default: false): Whether to hide focus outline.

Example:

Button(
  style: ButtonStyle.primary(),
  leading: Icon(Icons.save),
  onPressed: () => saveDocument(),
  child: Text('Save Document'),
);

Implementation

const Button({
  super.key,
  this.statesController,
  this.leading,
  this.trailing,
  required this.child,
  this.onPressed,
  this.focusNode,
  this.alignment,
  required this.style,
  this.enabled,
  this.disableTransition = false,
  this.onFocus,
  this.onHover,
  this.disableHoverEffect = false,
  this.enableFeedback,
  this.onTapDown,
  this.onTapUp,
  this.onTapCancel,
  this.onSecondaryTapDown,
  this.onSecondaryTapUp,
  this.onSecondaryTapCancel,
  this.onTertiaryTapDown,
  this.onTertiaryTapUp,
  this.onTertiaryTapCancel,
  this.onLongPressStart,
  this.onLongPressUp,
  this.onLongPressMoveUpdate,
  this.onLongPressEnd,
  this.onSecondaryLongPress,
  this.onTertiaryLongPress,
  this.marginAlignment,
  this.disableFocusOutline = false,
});