wonders/lib/ui/common/controls/buttons.dart

183 lines
5.6 KiB
Dart
Raw Permalink Normal View History

2022-08-29 20:38:28 -06:00
import 'package:wonders/common_libs.dart';
import 'package:wonders/ui/common/app_icons.dart';
2022-08-29 20:38:28 -06:00
/// Shared methods across button types
Widget _buildIcon(BuildContext context, AppIcons icon, {required bool isSecondary, required double? size}) =>
AppIcon(icon, color: isSecondary ? $styles.colors.black : $styles.colors.offWhite, size: size ?? 18);
2022-08-29 20:38:28 -06:00
/// The core button that drives all other buttons.
class AppBtn extends StatelessWidget {
// ignore: prefer_const_constructors_in_immutables
AppBtn({
Key? key,
required this.onPressed,
required this.semanticLabel,
this.enableFeedback = true,
this.pressEffect = true,
this.child,
this.padding,
this.expand = false,
this.isSecondary = false,
this.circular = false,
this.minimumSize,
this.bgColor,
this.border,
}) : _builder = null,
super(key: key);
AppBtn.from({
Key? key,
required this.onPressed,
this.enableFeedback = true,
this.pressEffect = true,
this.padding,
this.expand = false,
this.isSecondary = false,
this.minimumSize,
this.bgColor,
this.border,
String? semanticLabel,
String? text,
AppIcons? icon,
2022-08-29 20:38:28 -06:00
double? iconSize,
}) : child = null,
circular = false,
super(key: key) {
if (semanticLabel == null && text == null) throw ('AppBtn.from must include either text or semanticLabel');
this.semanticLabel = semanticLabel ?? text ?? '';
_builder = (context) {
if (text == null && icon == null) return SizedBox.shrink();
Text? txt = text == null
? null
: Text(text.toUpperCase(),
style: $styles.text.btn, textHeightBehavior: TextHeightBehavior(applyHeightToFirstAscent: false));
Widget? icn = icon == null ? null : _buildIcon(context, icon, isSecondary: isSecondary, size: iconSize);
if (txt != null && icn != null) {
return Row(
mainAxisAlignment: MainAxisAlignment.center,
mainAxisSize: MainAxisSize.min,
children: [txt, Gap($styles.insets.xs), icn],
);
} else {
return (txt ?? icn)!;
}
};
}
// ignore: prefer_const_constructors_in_immutables
AppBtn.basic({
Key? key,
required this.onPressed,
required this.semanticLabel,
this.enableFeedback = true,
this.pressEffect = true,
this.child,
this.padding = EdgeInsets.zero,
this.isSecondary = false,
this.circular = false,
this.minimumSize,
}) : expand = false,
bgColor = Colors.transparent,
border = null,
_builder = null,
super(key: key);
// interaction:
2023-01-03 10:35:53 -07:00
final VoidCallback? onPressed;
2022-08-29 20:38:28 -06:00
late final String semanticLabel;
final bool enableFeedback;
// content:
late final Widget? child;
late final WidgetBuilder? _builder;
// layout:
final EdgeInsets? padding;
final bool expand;
final bool circular;
final Size? minimumSize;
// style:
final bool isSecondary;
final BorderSide? border;
final Color? bgColor;
final bool pressEffect;
@override
Widget build(BuildContext context) {
Color defaultColor = isSecondary ? $styles.colors.white : $styles.colors.greyStrong;
Color textColor = isSecondary ? $styles.colors.black : $styles.colors.white;
BorderSide side = border ?? BorderSide.none;
Widget content = _builder?.call(context) ?? child ?? SizedBox.shrink();
if (expand) content = Center(child: content);
OutlinedBorder shape = circular
? CircleBorder(side: side)
: RoundedRectangleBorder(side: side, borderRadius: BorderRadius.circular($styles.corners.md));
ButtonStyle style = ButtonStyle(
minimumSize: ButtonStyleButton.allOrNull<Size>(minimumSize ?? Size.zero),
tapTargetSize: MaterialTapTargetSize.shrinkWrap,
splashFactory: NoSplash.splashFactory,
backgroundColor: ButtonStyleButton.allOrNull<Color>(bgColor ?? defaultColor),
overlayColor: ButtonStyleButton.allOrNull<Color>(Colors.transparent), // disable default press effect
shape: ButtonStyleButton.allOrNull<OutlinedBorder>(shape),
padding: ButtonStyleButton.allOrNull<EdgeInsetsGeometry>(padding ?? EdgeInsets.all($styles.insets.md)),
enableFeedback: enableFeedback,
);
Widget button = TextButton(
2023-01-03 10:35:53 -07:00
onPressed: onPressed,
2022-08-29 20:38:28 -06:00
style: style,
child: DefaultTextStyle(
style: DefaultTextStyle.of(context).style.copyWith(color: textColor),
child: content,
),
);
// add press effect:
if (pressEffect) button = _ButtonPressEffect(button);
// add semantics?
if (semanticLabel.isEmpty) return button;
return Semantics(
label: semanticLabel,
button: true,
container: true,
child: ExcludeSemantics(child: button),
);
2022-08-29 20:38:28 -06:00
}
}
/// //////////////////////////////////////////////////
/// _ButtonDecorator
/// Add a transparency-based press effect to buttons.
/// //////////////////////////////////////////////////
class _ButtonPressEffect extends StatefulWidget {
const _ButtonPressEffect(this.child, {Key? key}) : super(key: key);
final Widget child;
@override
State<_ButtonPressEffect> createState() => _ButtonPressEffectState();
}
class _ButtonPressEffectState extends State<_ButtonPressEffect> {
bool _isDown = false;
@override
Widget build(BuildContext context) {
return GestureDetector(
excludeFromSemantics: true,
onTapDown: (_) => setState(() => _isDown = true),
onTapUp: (_) => setState(() => _isDown = false), // not called, TextButton swallows this.
onTapCancel: () => setState(() => _isDown = false),
behavior: HitTestBehavior.translucent,
child: Opacity(
opacity: _isDown ? 0.7 : 1,
child: ExcludeSemantics(child: widget.child),
),
);
}
}