Files
plezy/lib/widgets/settings_section.dart
T

134 lines
4.5 KiB
Dart
Raw Normal View History

2026-04-02 00:33:25 +02:00
import 'package:flutter/material.dart';
import '../theme/mono_tokens.dart';
import '../utils/platform_detector.dart';
2026-04-02 00:33:25 +02:00
import 'app_icon.dart';
import 'expressive_button_group.dart';
2026-04-02 00:33:25 +02:00
/// Standard settings-option title style, for group children that are not a
/// [ListTile] (segmented controls, sliders) and so don't inherit its
/// typography.
///
/// The app renders every row compactly — [ThemeData.listTileTheme] sets
/// `dense: true` and the `Focusable*ListTile`s default to it — and Flutter
/// draws a dense [ListTile] title at 13. Match that so a settings page reads
/// as one family instead of one size per row type.
TextStyle? settingsOptionTitleStyle(BuildContext context) =>
Theme.of(context).textTheme.bodyLarge?.copyWith(fontSize: 13);
2026-04-02 00:33:25 +02:00
class SettingsSectionHeader extends StatelessWidget {
final String title;
const SettingsSectionHeader(this.title, {super.key});
@override
Widget build(BuildContext context) {
return Padding(
padding: const EdgeInsets.fromLTRB(16, 24, 16, 8),
child: Text(
title,
2026-06-01 11:06:03 +02:00
style: Theme.of(context).textTheme.labelLarge?.copyWith(color: tokens(context).textMuted, fontWeight: .w600),
2026-04-02 00:33:25 +02:00
),
);
}
}
/// M3E grouped list section: each child gets its own rounded surface card —
/// large radii on the section's outer corners, small radii between adjacent
/// items, hairline gaps — with an optional [SettingsSectionHeader] above.
///
/// Corner shapes are computed from the child list index, so conditional tiles
/// MUST be excluded with `if (...)` at list-build time. A child that renders
/// `SizedBox.shrink()` still occupies a corner slot and corrupts the group's
/// shape; hoist its condition (or wrap the whole group in a SettingsBuilder).
///
/// Each item is a shaped [Material] so the tiles' native ink focus/hover
/// highlight paints clipped inside the card — that is the d-pad focus visual
/// (background focus). The group adds no [Focus] nodes of its own; traversal
/// order and externally-owned tile focus nodes are untouched.
///
/// Children inherit the compact row geometry the `Focusable*ListTile`s default
/// to, so a plain [ListTile] used as a non-interactive info row lines up with
/// its interactive siblings instead of standing 11px taller.
class SettingsGroup extends StatelessWidget {
final String? title;
final List<Widget> children;
final EdgeInsetsGeometry margin;
const SettingsGroup({
super.key,
this.title,
required this.children,
this.margin = const EdgeInsets.symmetric(horizontal: 16),
});
@override
Widget build(BuildContext context) {
final t = tokens(context);
return Column(
crossAxisAlignment: .start,
children: [
if (title != null) SettingsSectionHeader(title!),
Padding(
padding: margin,
child: ListTileTheme.merge(
visualDensity: PlatformDetector.isAutomotive() ? VisualDensity.standard : const VisualDensity(vertical: -3),
child: Column(
children: [
for (var i = 0; i < children.length; i++) ...[
if (i > 0) SizedBox(height: t.groupGap),
Material(
color: t.surface,
clipBehavior: Clip.antiAlias,
shape: RoundedRectangleBorder(borderRadius: groupItemRadii(context, i, children.length)),
child: children[i],
),
],
],
),
),
),
],
);
}
}
/// A setting with a label + icon row and a full-width button group below.
/// Used for settings with 2-3 short options.
2026-04-02 00:33:25 +02:00
class SegmentedSetting<T> extends StatelessWidget {
final IconData icon;
final String title;
final List<ButtonSegment<T>> segments;
final T selected;
final ValueChanged<T> onChanged;
const SegmentedSetting({
super.key,
required this.icon,
required this.title,
required this.segments,
required this.selected,
required this.onChanged,
});
@override
Widget build(BuildContext context) {
return Padding(
padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 12),
2026-04-02 00:33:25 +02:00
child: Column(
2026-06-01 11:06:03 +02:00
crossAxisAlignment: .start,
2026-04-02 00:33:25 +02:00
children: [
Row(
children: [
AppIcon(icon, fill: 1),
const SizedBox(width: 16),
Text(title, style: settingsOptionTitleStyle(context)),
2026-04-02 00:33:25 +02:00
],
),
const SizedBox(height: 12),
ExpressiveButtonGroup<T>(segments: segments, selected: selected, onChanged: onChanged),
2026-04-02 00:33:25 +02:00
],
),
);
}
}