mirror of
https://github.com/block/buzz.git
synced 2026-08-18 06:50:31 +02:00
## Summary
- add poster-first, tap-to-toggle animated avatars on profile surfaces
while preserving transparent/static behavior elsewhere
- align mobile DM headers, membership actions, and invisible agent
recipient addressing with established desktop semantics
- polish titled sheets and status editing, preserve native iOS sheet
corners, and batch relay reads to improve review-build responsiveness
## Snapshots
<table>
<tr>
<th>Profile avatar</th>
<th>Agent DM header and composer</th>
</tr>
<tr>
<td><img
src="https://raw.githubusercontent.com/block/buzz/e8de7495451dbe1a393ab43c5e204ca7425f2ba5/pr-5401--profile-avatar.png"
width="360" alt="Mobile profile settings with animated avatar
surface"></td>
<td><img
src="https://raw.githubusercontent.com/block/buzz/e8de7495451dbe1a393ab43c5e204ca7425f2ba5/pr-5401--agent-dm.png"
width="360" alt="Agent direct message with masked presence and normal
composer"></td>
</tr>
<tr>
<th>Members sheet</th>
<th>Status editor</th>
</tr>
<tr>
<td><img
src="https://raw.githubusercontent.com/block/buzz/e8de7495451dbe1a393ab43c5e204ca7425f2ba5/pr-5401--members-sheet.png"
width="360" alt="Members bottom sheet with centered title and padded
content"></td>
<td><img
src="https://raw.githubusercontent.com/block/buzz/e8de7495451dbe1a393ab43c5e204ca7425f2ba5/pr-5401--status-sheet.png"
width="360" alt="Status editor bottom sheet with duration and quick
statuses"></td>
</tr>
<tr>
<th colspan="2">Switch Community</th>
</tr>
<tr>
<td colspan="2" align="center"><img
src="https://raw.githubusercontent.com/block/buzz/e8de7495451dbe1a393ab43c5e204ca7425f2ba5/pr-5401--switch-community.png"
width="720" alt="Switch Community bottom sheet with centered title and
aligned Edit action"></td>
</tr>
</table>
## Validation
- `just mobile-check`
- `just mobile-test` (1,283 tests)
- installed and reviewed isolated debug builds on iPhone and Pixel
---------
Signed-off-by: kenny lopez <klopez4212@gmail.com>
Signed-off-by: Princess Donut <b238ea756dee4d98afa5883fc7f1de61eeabe65bf700e3a5a5a80db5e42e2c2b@buzz.block.builderlab.xyz>
Signed-off-by: Kenny Lopez <klopez4212@gmail.com>
Signed-off-by: Wes <wesbillman@users.noreply.github.com>
Co-authored-by: Princess Donut <b238ea756dee4d98afa5883fc7f1de61eeabe65bf700e3a5a5a80db5e42e2c2b@buzz.block.builderlab.xyz>
Co-authored-by: Wes <wesbillman@users.noreply.github.com>
Co-authored-by: Carl <c7ebe626f000404285d3686e1dc74cc07cc60a9754a150041ba132e14bd3e2ec@buzz.block.builderlab.xyz>
202 lines
6.1 KiB
Dart
202 lines
6.1 KiB
Dart
import 'package:flutter/foundation.dart';
|
|
import 'package:flutter/material.dart';
|
|
|
|
import '../theme/theme.dart';
|
|
import 'buzz_sheet_header.dart';
|
|
import 'buzz_titled_sheet_layout.dart';
|
|
import 'concentric_sheet_surface.dart';
|
|
|
|
/// Shared motion for occasional modal UI.
|
|
///
|
|
/// The strong ease-out makes entrances respond immediately, while the shorter
|
|
/// exit keeps dismissals from feeling sluggish.
|
|
const buzzModalAnimationStyle = AnimationStyle(
|
|
curve: Cubic(0.23, 1, 0.32, 1),
|
|
duration: Duration(milliseconds: 280),
|
|
reverseCurve: Cubic(0.77, 0, 0.175, 1),
|
|
reverseDuration: Duration(milliseconds: 220),
|
|
);
|
|
|
|
/// Shows a bottom sheet with Buzz's shared motion and sheet chrome.
|
|
///
|
|
/// Sheets include the shared close control by default. On iOS, the surface
|
|
/// uses native concentric corners when available and paints a requested drag
|
|
/// handle inside the shared header so its spacing is consistent on every
|
|
/// platform.
|
|
Future<T?> showBuzzModalBottomSheet<T>({
|
|
required BuildContext context,
|
|
required WidgetBuilder builder,
|
|
String? title,
|
|
Color? backgroundColor,
|
|
String? barrierLabel,
|
|
double? elevation,
|
|
ShapeBorder? shape,
|
|
Clip? clipBehavior,
|
|
BoxConstraints? constraints,
|
|
Color? barrierColor,
|
|
bool isScrollControlled = false,
|
|
double scrollControlDisabledMaxHeightRatio = 9.0 / 16.0,
|
|
bool useRootNavigator = false,
|
|
bool isDismissible = true,
|
|
bool enableDrag = true,
|
|
bool? showDragHandle,
|
|
bool showCloseButton = true,
|
|
bool useSafeArea = false,
|
|
RouteSettings? routeSettings,
|
|
AnimationController? transitionAnimationController,
|
|
Offset? anchorPoint,
|
|
AnimationStyle? sheetAnimationStyle,
|
|
bool? requestFocus,
|
|
}) {
|
|
final isIos = defaultTargetPlatform == TargetPlatform.iOS;
|
|
final theme = Theme.of(context);
|
|
final surfaceColor =
|
|
backgroundColor ??
|
|
theme.bottomSheetTheme.modalBackgroundColor ??
|
|
theme.bottomSheetTheme.backgroundColor ??
|
|
context.colors.surface;
|
|
final reduceMotion = MediaQuery.disableAnimationsOf(context);
|
|
|
|
return showModalBottomSheet<T>(
|
|
context: context,
|
|
builder: (sheetContext) => ConcentricSheetSurface(
|
|
enabled: isIos,
|
|
color: surfaceColor,
|
|
child: _SheetContent(
|
|
title: title,
|
|
showCloseButton: showCloseButton,
|
|
showDragHandle: showDragHandle == true,
|
|
surfaceColor: surfaceColor,
|
|
child: builder(sheetContext),
|
|
),
|
|
),
|
|
backgroundColor: isIos || title != null
|
|
? Colors.transparent
|
|
: backgroundColor,
|
|
barrierLabel: barrierLabel,
|
|
elevation: elevation,
|
|
shape: shape,
|
|
clipBehavior: clipBehavior,
|
|
constraints: constraints,
|
|
barrierColor: barrierColor,
|
|
isScrollControlled: isScrollControlled,
|
|
scrollControlDisabledMaxHeightRatio: scrollControlDisabledMaxHeightRatio,
|
|
useRootNavigator: useRootNavigator,
|
|
isDismissible: isDismissible,
|
|
enableDrag: enableDrag,
|
|
// The shared header owns the handle so Android does not reserve a second
|
|
// handle band above the title row and iOS keeps it inside its native inset.
|
|
showDragHandle: false,
|
|
useSafeArea: useSafeArea,
|
|
routeSettings: routeSettings,
|
|
transitionAnimationController: transitionAnimationController,
|
|
anchorPoint: anchorPoint,
|
|
sheetAnimationStyle: reduceMotion
|
|
? AnimationStyle.noAnimation
|
|
: (sheetAnimationStyle ?? buzzModalAnimationStyle),
|
|
requestFocus: requestFocus,
|
|
);
|
|
}
|
|
|
|
class _SheetContent extends StatelessWidget {
|
|
const _SheetContent({
|
|
required this.child,
|
|
required this.title,
|
|
required this.showCloseButton,
|
|
required this.showDragHandle,
|
|
required this.surfaceColor,
|
|
});
|
|
|
|
final Widget child;
|
|
final String? title;
|
|
final bool showCloseButton;
|
|
final bool showDragHandle;
|
|
final Color surfaceColor;
|
|
|
|
@override
|
|
Widget build(BuildContext context) {
|
|
if (title == null || !showCloseButton) {
|
|
return Column(
|
|
mainAxisSize: MainAxisSize.min,
|
|
children: [
|
|
if (showCloseButton)
|
|
BuzzSheetHeader(title: title, showDragHandle: showDragHandle)
|
|
else if (showDragHandle)
|
|
const Padding(
|
|
padding: EdgeInsets.only(top: Grid.xxs, bottom: Grid.xs),
|
|
child: _StandaloneSheetDragHandle(),
|
|
),
|
|
Flexible(child: child),
|
|
],
|
|
);
|
|
}
|
|
|
|
return BuzzTitledSheetLayout(
|
|
title: title!,
|
|
showDragHandle: showDragHandle,
|
|
surfaceColor: surfaceColor,
|
|
child: child,
|
|
);
|
|
}
|
|
}
|
|
|
|
class _StandaloneSheetDragHandle extends StatelessWidget {
|
|
const _StandaloneSheetDragHandle();
|
|
|
|
@override
|
|
Widget build(BuildContext context) {
|
|
return Semantics(
|
|
label: MaterialLocalizations.of(context).modalBarrierDismissLabel,
|
|
container: true,
|
|
button: true,
|
|
onTap: () => Navigator.of(context).pop(),
|
|
child: Container(
|
|
key: const ValueKey('buzz-sheet-drag-handle'),
|
|
width: 32,
|
|
height: 4,
|
|
decoration: BoxDecoration(
|
|
color: context.colors.onSurfaceVariant.withValues(alpha: 0.4),
|
|
borderRadius: BorderRadius.circular(Radii.full),
|
|
),
|
|
),
|
|
);
|
|
}
|
|
}
|
|
|
|
/// Shows a dialog with Buzz's shared motion, respecting reduced-motion settings.
|
|
Future<T?> showBuzzDialog<T>({
|
|
required BuildContext context,
|
|
required WidgetBuilder builder,
|
|
bool barrierDismissible = true,
|
|
Color? barrierColor,
|
|
String? barrierLabel,
|
|
bool useSafeArea = true,
|
|
bool useRootNavigator = true,
|
|
RouteSettings? routeSettings,
|
|
Offset? anchorPoint,
|
|
TraversalEdgeBehavior? traversalEdgeBehavior,
|
|
bool fullscreenDialog = false,
|
|
bool? requestFocus,
|
|
AnimationStyle? animationStyle,
|
|
}) {
|
|
final reduceMotion = MediaQuery.disableAnimationsOf(context);
|
|
|
|
return showDialog<T>(
|
|
context: context,
|
|
builder: builder,
|
|
barrierDismissible: barrierDismissible,
|
|
barrierColor: barrierColor,
|
|
barrierLabel: barrierLabel,
|
|
useSafeArea: useSafeArea,
|
|
useRootNavigator: useRootNavigator,
|
|
routeSettings: routeSettings,
|
|
anchorPoint: anchorPoint,
|
|
traversalEdgeBehavior: traversalEdgeBehavior,
|
|
fullscreenDialog: fullscreenDialog,
|
|
requestFocus: requestFocus,
|
|
animationStyle: reduceMotion
|
|
? AnimationStyle.noAnimation
|
|
: (animationStyle ?? buzzModalAnimationStyle),
|
|
);
|
|
}
|