This commit is contained in:
LZX committed 2026-09-16 20:43:39 +08:00
1 parent 5efc778165
commit 59125d185c
64 files changed
+7912 -1393

No files matched your search

+351
View File
@@ -0,0 +1,351 @@
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),
),
);
}
}