106 lines
3.2 KiB
Dart
106 lines
3.2 KiB
Dart
import 'package:flutter/cupertino.dart';
|
|
import 'package:flutter/material.dart';
|
|
|
|
import '../../../shell/shell_bar.dart';
|
|
import '../../../ui/adaptive/host.dart';
|
|
import '../../../ui/adaptive/segmented_bar.dart';
|
|
import '../../../ui/navigation/bar_icon_button.dart';
|
|
import '../../../ui/theme/app_theme.dart';
|
|
|
|
const templatesRefreshKey = ValueKey<String>('templates-refresh');
|
|
const templatesBackKey = ValueKey<String>('templates-back');
|
|
const templatesTitle = 'Templates';
|
|
|
|
/// The screen's native chrome.
|
|
///
|
|
/// Standalone use draws the segmented bar: the round Back (back to the
|
|
/// gallery from a template, otherwise the route's own) and Refresh in the
|
|
/// actions pill. A page that already owns a bar passes [embedded]; the
|
|
/// screen then publishes its Back and Refresh to that bar through
|
|
/// [ShellBar]. Only with no bar above at all does Refresh sit atop the body.
|
|
class TemplatesFrame extends StatelessWidget {
|
|
const TemplatesFrame({
|
|
super.key,
|
|
required this.body,
|
|
required this.embedded,
|
|
required this.canGoBack,
|
|
required this.refreshing,
|
|
required this.onBack,
|
|
required this.onRefresh,
|
|
this.title = templatesTitle,
|
|
this.subtitle,
|
|
});
|
|
|
|
/// The bar's title pill: `Templates` on the gallery, the open template's
|
|
/// name (with its description as [subtitle]) on a detail.
|
|
final String title;
|
|
final String? subtitle;
|
|
final Widget body;
|
|
final bool embedded;
|
|
final bool canGoBack;
|
|
final bool refreshing;
|
|
final VoidCallback onBack;
|
|
final VoidCallback onRefresh;
|
|
|
|
@override
|
|
Widget build(BuildContext context) {
|
|
final cupertino = usesCupertinoHost(context);
|
|
if (embedded) {
|
|
if (ShellBar.available(context)) {
|
|
return ShellBar(
|
|
title: title,
|
|
subtitle: subtitle,
|
|
onBack: canGoBack ? onBack : null,
|
|
actions: [_refreshButton()],
|
|
child: body,
|
|
);
|
|
}
|
|
return Column(
|
|
crossAxisAlignment: CrossAxisAlignment.stretch,
|
|
children: [
|
|
Align(
|
|
alignment: AlignmentDirectional.centerEnd,
|
|
child: Padding(
|
|
padding: const EdgeInsets.symmetric(horizontal: 8),
|
|
child: _refreshButton(),
|
|
),
|
|
),
|
|
Expanded(child: body),
|
|
],
|
|
);
|
|
}
|
|
final bar = SegmentedBar(
|
|
cupertino: cupertino,
|
|
leading: canGoBack
|
|
? SegmentedBackButton(
|
|
key: templatesBackKey,
|
|
cupertino: cupertino,
|
|
onPressed: onBack,
|
|
)
|
|
: null,
|
|
title: title,
|
|
subtitle: subtitle,
|
|
actions: [_refreshButton()],
|
|
);
|
|
// The body reaches the top edge and scrolls behind the bar.
|
|
final page = SafeArea(top: false, bottom: false, child: body);
|
|
if (cupertino) {
|
|
return CupertinoPageScaffold(
|
|
// Plain list rows on the page background, like the other lists.
|
|
backgroundColor: AppColors.background,
|
|
navigationBar: bar,
|
|
child: page,
|
|
);
|
|
}
|
|
return Scaffold(extendBodyBehindAppBar: true, appBar: bar, body: page);
|
|
}
|
|
|
|
Widget _refreshButton() => BarIconButton(
|
|
key: templatesRefreshKey,
|
|
icon: Icons.refresh,
|
|
cupertinoIcon: CupertinoIcons.refresh,
|
|
label: 'Refresh',
|
|
onPressed: refreshing ? null : onRefresh,
|
|
);
|
|
}
|