Files
2026-09-16 20:43:39 +08:00

352 lines
11 KiB
Dart
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import 'package:flutter/material.dart';
import '../l10n/app_localizations.dart';
import '../models/notice_item.dart';
import '../providers/notice_center.dart';
import '../utils/notice_text_resolver.dart';
/// 通用「通知堆叠宿主」控件。
///
/// 把 [NoticeCenter] 里的可见通知渲染成一列卡片:
/// * 每条卡片**带动画插入**(尺寸 + 淡入 + 从右侧滑入);
/// * 支持同时插入多条(受 [NoticeCenter.visibleLimit] 限制,超出进入队列并显示折叠提示);
/// * 任一卡片关闭时播放退场动画,动画结束后队列首条**自动弹出补位**,
/// 并且下方卡片因外层 [SizeTransition] 而平滑上移。
///
/// 控件本身不关心业务:文案由 [resolveNoticeDisplay] 依据 l10n 解析,禁止硬编码。
class NoticeHost extends StatelessWidget {
final NoticeCenter center;
/// 停靠位置(默认编辑区右上角)
final AlignmentGeometry alignment;
final EdgeInsets margin;
/// 单张卡片最大宽度(窄屏自适应)
final double maxWidth;
final Duration insertDuration;
final Duration removeDuration;
/// 破坏性通知([NoticeItem.confirmBeforeDismiss])关闭前的二次确认;
/// 返回 false 表示用户放弃关闭(卡片保留,附带动作不执行)。
final Future<bool> Function(BuildContext context)? confirmDismissBuilder;
const NoticeHost({
super.key,
required this.center,
this.alignment = Alignment.topRight,
this.margin = const EdgeInsets.only(top: 12, right: 12),
this.maxWidth = 300,
this.insertDuration = const Duration(milliseconds: 220),
this.removeDuration = const Duration(milliseconds: 180),
this.confirmDismissBuilder,
});
@override
Widget build(BuildContext context) {
return AnimatedBuilder(
animation: center,
builder: (context, _) {
final visible = center.visible;
final queuedCount = center.queued.length;
if (visible.isEmpty && queuedCount == 0) {
return const SizedBox.shrink();
}
final l10n = AppLocalizations.of(context);
return Align(
alignment: alignment,
child: Padding(
padding: margin,
child: Column(
mainAxisSize: MainAxisSize.min,
crossAxisAlignment: CrossAxisAlignment.end,
children: [
for (final item in visible)
_NoticeEntry(
key: ValueKey<String>(item.id),
item: item,
removing: center.removingIds.contains(item.id),
maxWidth: maxWidth,
insertDuration: insertDuration,
removeDuration: removeDuration,
onDismiss: () async {
// 破坏性操作:先二次确认;用户放弃则卡片保留、附加动作不执行
if (item.confirmBeforeDismiss && confirmDismissBuilder != null) {
final confirmed = await confirmDismissBuilder!(context);
if (!confirmed) return;
}
// 用户点 × :先执行附加动作(如取消正在进行的探测),再移除卡片
item.onUserDismiss?.call();
center.dismiss(item.id);
},
onRemoved: () => center.finalizeDismiss(item.id),
),
if (queuedCount > 0)
Padding(
padding: const EdgeInsets.only(top: 6),
child: _QueueBadge(
label: l10n?.noticeQueueMore(queuedCount) ?? '+$queuedCount',
),
),
],
),
),
);
},
);
}
}
/// 单条通知:负责自身的插入/退场动画
class _NoticeEntry extends StatefulWidget {
final NoticeItem item;
final bool removing;
final double maxWidth;
final Duration insertDuration;
final Duration removeDuration;
final VoidCallback onDismiss;
final VoidCallback onRemoved;
const _NoticeEntry({
super.key,
required this.item,
required this.removing,
required this.maxWidth,
required this.insertDuration,
required this.removeDuration,
required this.onDismiss,
required this.onRemoved,
});
@override
State<_NoticeEntry> createState() => _NoticeEntryState();
}
class _NoticeEntryState extends State<_NoticeEntry> with SingleTickerProviderStateMixin {
late final AnimationController _controller = AnimationController(
vsync: this,
duration: widget.insertDuration,
reverseDuration: widget.removeDuration,
);
bool _removalNotified = false;
@override
void initState() {
super.initState();
_controller.forward();
if (widget.removing) {
_playRemoval();
}
}
@override
void didUpdateWidget(_NoticeEntry oldWidget) {
super.didUpdateWidget(oldWidget);
if (widget.removing && !oldWidget.removing) {
_playRemoval();
}
}
void _playRemoval() {
if (_removalNotified) return;
_controller.reverse().whenComplete(() {
if (!mounted || _removalNotified) return;
_removalNotified = true;
widget.onRemoved();
});
}
@override
void dispose() {
_controller.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
final curved = CurvedAnimation(
parent: _controller,
curve: Curves.easeOutCubic,
reverseCurve: Curves.easeInCubic,
);
return SizeTransition(
sizeFactor: curved,
alignment: Alignment.topRight,
child: FadeTransition(
opacity: curved,
child: SlideTransition(
position: Tween<Offset>(
begin: const Offset(0.18, 0),
end: Offset.zero,
).animate(curved),
child: Padding(
padding: const EdgeInsets.only(bottom: 8),
child: _NoticeCard(
item: widget.item,
maxWidth: widget.maxWidth,
onDismiss: widget.onDismiss,
),
),
),
),
);
}
}
/// 单张通知卡片外观(与编辑器内"缩放字号胶囊"同一视觉语言)
class _NoticeCard extends StatelessWidget {
final NoticeItem item;
final double maxWidth;
final VoidCallback onDismiss;
const _NoticeCard({
required this.item,
required this.maxWidth,
required this.onDismiss,
});
@override
Widget build(BuildContext context) {
final theme = Theme.of(context);
final l10n = AppLocalizations.of(context);
final display = l10n != null
? resolveNoticeDisplay(l10n, item.text)
: NoticeDisplay(title: item.text.runtimeType.toString());
final isSuccess = item.kind == NoticeKind.success;
final isFailure = item.kind == NoticeKind.failure;
final (Color accent, Widget leading) = switch (item.kind) {
NoticeKind.progress => (
theme.colorScheme.primary,
SizedBox(
width: 16,
height: 16,
child: CircularProgressIndicator(
strokeWidth: 2,
value: item.progress,
color: theme.colorScheme.primary,
),
),
),
NoticeKind.success => (
Colors.white,
const Icon(Icons.check_circle_outline, size: 18, color: Colors.white),
),
NoticeKind.failure => (
theme.colorScheme.error,
Icon(Icons.error_outline, size: 18, color: theme.colorScheme.error),
),
NoticeKind.info => (
theme.colorScheme.primary,
Icon(Icons.info_outline, size: 18, color: theme.colorScheme.primary),
),
};
final cardBgColor = isSuccess
? (theme.brightness == Brightness.dark
? const Color(0xFF1E5E2F)
: const Color(0xFF2E7D32))
: theme.colorScheme.surfaceContainerHighest;
final cardBorder = isFailure
? const BorderSide(color: Color(0xFFE53935), width: 1.5)
: isSuccess
? BorderSide(color: Colors.green.shade400.withValues(alpha: 0.6), width: 1)
: BorderSide(color: theme.colorScheme.outlineVariant.withValues(alpha: 0.45), width: 1);
final titleColor = isSuccess ? Colors.white : theme.colorScheme.onSurface;
final subtitleColor = isSuccess ? Colors.white70 : theme.colorScheme.onSurfaceVariant;
final closeIconColor = isSuccess ? Colors.white70 : theme.colorScheme.onSurfaceVariant;
return ConstrainedBox(
constraints: BoxConstraints(maxWidth: maxWidth),
child: Material(
elevation: 6,
shadowColor: Colors.black38,
color: cardBgColor,
shape: RoundedRectangleBorder(
borderRadius: BorderRadius.circular(10),
side: cardBorder,
),
clipBehavior: Clip.antiAlias,
child: Padding(
padding: const EdgeInsets.fromLTRB(12, 8, 4, 8),
child: Row(
crossAxisAlignment: CrossAxisAlignment.center,
mainAxisSize: MainAxisSize.min,
children: [
leading,
const SizedBox(width: 10),
Flexible(
child: Column(
mainAxisSize: MainAxisSize.min,
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
display.title,
style: TextStyle(
fontSize: 13,
fontWeight: FontWeight.w600,
color: titleColor,
),
),
if (display.subtitle != null && display.subtitle!.isNotEmpty) ...[
const SizedBox(height: 2),
Text(
display.subtitle!,
maxLines: 3,
overflow: TextOverflow.ellipsis,
style: TextStyle(
fontSize: 11.5,
color: subtitleColor,
),
),
],
],
),
),
IconButton(
onPressed: onDismiss,
tooltip: l10n?.probeBannerClose,
icon: const Icon(Icons.close, size: 16),
visualDensity: VisualDensity.compact,
padding: const EdgeInsets.all(4),
constraints: const BoxConstraints(minWidth: 28, minHeight: 28),
color: closeIconColor,
),
],
),
),
),
);
}
}
/// 队列折叠提示(还能看到"还有 N 项进行中")
class _QueueBadge extends StatelessWidget {
final String label;
const _QueueBadge({required this.label});
@override
Widget build(BuildContext context) {
final theme = Theme.of(context);
return Container(
padding: const EdgeInsets.symmetric(horizontal: 10, vertical: 4),
decoration: BoxDecoration(
color: theme.colorScheme.surfaceContainerHighest.withValues(alpha: 0.9),
borderRadius: BorderRadius.circular(12),
),
child: Text(
label,
style: TextStyle(fontSize: 11, color: theme.colorScheme.onSurfaceVariant),
),
);
}
}