feat(mobile): UI-01 theme system, shared components and navigation

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-21 14:55:29 +08:00
parent 8f4ad11bd5
commit c94b9e5e58
27 changed files with 2067 additions and 555 deletions
@@ -0,0 +1,63 @@
+/// 错误态（UI-01）：错误图标 + 说明 + 重试按钮（主强调）。
+///
+/// 用于加载失败等需要用户处理的场景。与 EmptyState 的区别：错误态有
+/// 明确的重试动作（主按钮 + 刷新图标），文案为错误色语义；空态无重试。
+/// 重试文案来自语言资源（[AppLocalizations.retry]）。
+library;
+
+import 'package:flutter/material.dart';
+
+import '../../l10n/app_localizations.dart';
+import '../tokens.dart';
+
+/// 错误态视图。
+class ErrorState extends StatelessWidget {
+  const ErrorState({
+    required this.message,
+    required this.onRetry,
+    this.icon,
+    super.key,
+  });
+
+  /// 错误说明（调用方本地化，如错误码映射文案）。
+  final String message;
+
+  /// 重试回调。
+  final VoidCallback onRetry;
+
+  /// 覆盖主题图标（默认 [Icons.cloud_off]，加载失败语义）。
+  final IconData? icon;
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    final errorColor = theme.brightness == Brightness.light
+        ? kColorError
+        : kColorErrorDark;
+    return Center(
+      child: Padding(
+        padding: const EdgeInsets.all(kSpace24),
+        child: Column(
+          mainAxisSize: MainAxisSize.min,
+          children: [
+            Icon(icon ?? Icons.cloud_off, size: 48, color: errorColor),
+            const SizedBox(height: kSpace12),
+            Text(
+              message,
+              textAlign: TextAlign.center,
+              style: theme.textTheme.bodyLarge?.copyWith(
+                color: theme.colorScheme.onSurfaceVariant,
+              ),
+            ),
+            const SizedBox(height: kSpace16),
+            FilledButton.icon(
+              onPressed: onRetry,
+              icon: const Icon(Icons.refresh),
+              label: Text(AppLocalizations.of(context).retry),
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}