Files
pipelines/app/lib/features/templates/ui/templates_frame.dart
T

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,
);
}