docs: 整理 runtime 系列文档,修正 API 端点名称

This commit is contained in:
qzl
2026-03-02 10:55:46 +08:00
parent c3192a2431
commit 2ac56e5084
9 changed files with 350 additions and 172 deletions
@@ -97,9 +97,9 @@ class BottomDock extends StatelessWidget {
width: 44,
height: 44,
decoration: BoxDecoration(
color: AppColors.todoHomeBtnBg,
color: AppColors.todoToggleBg,
borderRadius: BorderRadius.circular(AppRadius.xl),
border: Border.all(color: AppColors.todoHomeBtnBorder),
border: Border.all(color: AppColors.todoToggleBorder),
),
child: const Icon(
LucideIcons.home,
@@ -1,13 +1,46 @@
import 'package:flutter/material.dart';
import 'package:go_router/go_router.dart';
import 'package:lucide_icons/lucide_icons.dart';
import '../../../../core/di/injection.dart';
import '../../../../core/theme/design_tokens.dart';
import '../../../calendar/ui/calendar_state_manager.dart';
import '../../../calendar/ui/widgets/bottom_dock.dart';
class TodoQuadrantsScreen extends StatelessWidget {
class TodoQuadrantsScreen extends StatefulWidget {
const TodoQuadrantsScreen({super.key});
@override
State<TodoQuadrantsScreen> createState() => _TodoQuadrantsScreenState();
}
class _TodoQuadrantsScreenState extends State<TodoQuadrantsScreen> {
late List<_TodoItem> _importantUrgent;
late List<_TodoItem> _urgentNotImportant;
late List<_TodoItem> _importantNotUrgent;
@override
void initState() {
super.initState();
_importantUrgent = [
_TodoItem(title: '18:00 前提交活动方案'),
_TodoItem(title: '回复客户邀约确认'),
];
_urgentNotImportant = [
_TodoItem(title: '确认会场停车信息'),
_TodoItem(title: '代订明早高铁票'),
];
_importantNotUrgent = [
_TodoItem(title: '本周复盘与下周规划'),
_TodoItem(title: '整理个人知识库结构'),
_TodoItem(title: '优化三月目标里程碑'),
];
}
void _removeItem(String id, List<_TodoItem> list) {
setState(() {
list.removeWhere((item) => item.id == id);
});
}
@override
Widget build(BuildContext context) {
return Scaffold(
@@ -17,7 +50,7 @@ class TodoQuadrantsScreen extends StatelessWidget {
children: [
_buildHeader(),
Expanded(child: _buildContent()),
_buildBottomDock(context),
_buildBottomDock(),
],
),
),
@@ -52,29 +85,29 @@ class TodoQuadrantsScreen extends StatelessWidget {
children: [
_buildQuadrant(
title: '重要紧急',
count: 2,
textColor: AppColors.g1Text,
dividerColor: AppColors.g1Divider,
borderColor: AppColors.g1Border,
items: ['18:00 前提交活动方案', '回复客户邀约确认'],
items: _importantUrgent,
onRemove: (id) => _removeItem(id, _importantUrgent),
),
const SizedBox(height: 12),
_buildQuadrant(
title: '紧急不重要',
count: 2,
textColor: AppColors.g2Text,
dividerColor: AppColors.g2Divider,
borderColor: AppColors.g2Border,
items: ['确认会场停车信息', '代订明早高铁票'],
items: _urgentNotImportant,
onRemove: (id) => _removeItem(id, _urgentNotImportant),
),
const SizedBox(height: 12),
_buildQuadrant(
title: '重要不紧急',
count: 3,
textColor: AppColors.g3Text,
dividerColor: AppColors.g3Divider,
borderColor: AppColors.g3Border,
items: ['本周复盘与下周规划', '整理个人知识库结构', '优化三月目标里程碑'],
items: _importantNotUrgent,
onRemove: (id) => _removeItem(id, _importantNotUrgent),
),
],
),
@@ -83,11 +116,11 @@ class TodoQuadrantsScreen extends StatelessWidget {
Widget _buildQuadrant({
required String title,
required int count,
required Color textColor,
required Color dividerColor,
required Color borderColor,
required List<String> items,
required List<_TodoItem> items,
required void Function(String) onRemove,
}) {
return Container(
width: double.infinity,
@@ -113,7 +146,7 @@ class TodoQuadrantsScreen extends StatelessWidget {
),
),
Text(
'$count项',
'${items.length}',
style: TextStyle(
fontFamily: 'Inter',
fontSize: 12,
@@ -126,149 +159,152 @@ class TodoQuadrantsScreen extends StatelessWidget {
const SizedBox(height: 8),
Container(height: 1, color: dividerColor),
const SizedBox(height: 8),
...items.map((item) => _buildTodoItem(item)),
...items.map((item) => _buildTodoItem(item, onRemove)),
],
),
);
}
Widget _buildTodoItem(String title) {
Widget _buildTodoItem(_TodoItem item, void Function(String) onRemove) {
return _TodoItemWidget(
key: ValueKey(item.id),
item: item,
onRemove: onRemove,
);
}
Widget _buildBottomDock() {
return BottomDock(
activeTab: DockTab.todo,
onTodoTap: () {},
onCalendarTap: () {
final manager = sl<CalendarStateManager>();
final viewType = manager.viewType;
final date = manager.selectedDate;
final dateStr =
'${date.year}-${date.month.toString().padLeft(2, '0')}-${date.day.toString().padLeft(2, '0')}';
if (viewType == CalendarViewType.month) {
context.push('/calendar/month');
} else {
context.push('/calendar/dayweek?date=$dateStr');
}
},
onHomeTap: () => context.go('/home'),
);
}
}
class _TodoItem {
final String id;
final String title;
_TodoItem({required this.title})
: id = DateTime.now().microsecondsSinceEpoch.toString();
}
class _TodoItemWidget extends StatefulWidget {
final _TodoItem item;
final void Function(String) onRemove;
const _TodoItemWidget({
super.key,
required this.item,
required this.onRemove,
});
@override
State<_TodoItemWidget> createState() => _TodoItemWidgetState();
}
class _TodoItemWidgetState extends State<_TodoItemWidget>
with SingleTickerProviderStateMixin {
bool _isChecked = false;
late AnimationController _controller;
late Animation<double> _scaleAnimation;
@override
void initState() {
super.initState();
_controller = AnimationController(
duration: const Duration(milliseconds: 200),
vsync: this,
);
_scaleAnimation = Tween<double>(
begin: 0.0,
end: 1.0,
).animate(CurvedAnimation(parent: _controller, curve: Curves.easeOutBack));
}
@override
void dispose() {
_controller.dispose();
super.dispose();
}
void _handleTap() {
if (_isChecked) return;
setState(() {
_isChecked = true;
});
_controller.forward().then((_) {
widget.onRemove(widget.item.id);
});
}
@override
Widget build(BuildContext context) {
return SizedBox(
height: 42,
child: Row(
mainAxisAlignment: MainAxisAlignment.spaceBetween,
crossAxisAlignment: CrossAxisAlignment.center,
children: [
Text(
title,
style: const TextStyle(
fontFamily: 'Inter',
fontSize: 13,
fontWeight: FontWeight.w600,
color: AppColors.slate700,
Expanded(
child: Text(
widget.item.title,
style: const TextStyle(
fontFamily: 'Inter',
fontSize: 13,
fontWeight: FontWeight.w600,
color: AppColors.slate700,
),
),
),
Row(
mainAxisSize: MainAxisSize.min,
children: [
Container(
width: 8,
height: 8,
decoration: BoxDecoration(
color: AppColors.slate300,
shape: BoxShape.circle,
),
),
const SizedBox(width: 8),
Container(
width: 8,
height: 8,
decoration: BoxDecoration(
color: AppColors.slate300,
shape: BoxShape.circle,
),
),
],
GestureDetector(
onTap: _handleTap,
child: AnimatedBuilder(
animation: _controller,
builder: (context, child) {
return Container(
width: 20,
height: 20,
decoration: BoxDecoration(
color: _isChecked ? AppColors.blue600 : Colors.white,
border: Border.all(
color: _isChecked
? AppColors.blue600
: AppColors.slate300,
width: 1.5,
),
borderRadius: BorderRadius.circular(4),
),
child: _isChecked
? Transform.scale(
scale: _scaleAnimation.value,
child: const Icon(
Icons.check,
size: 14,
color: Colors.white,
),
)
: null,
);
},
),
),
],
),
);
}
Widget _buildBottomDock(BuildContext context) {
return SizedBox(
height: 61,
child: Padding(
padding: const EdgeInsets.only(
left: 20,
right: 20,
top: 12,
bottom: 18,
),
child: Row(
mainAxisAlignment: MainAxisAlignment.spaceBetween,
children: [
Container(
width: 102,
height: 52,
padding: const EdgeInsets.symmetric(horizontal: 5),
decoration: BoxDecoration(
color: AppColors.todoToggleBg,
borderRadius: BorderRadius.circular(24),
border: Border.all(color: AppColors.todoToggleBorder, width: 1),
),
child: Row(
children: [
Container(
width: 44,
height: 44,
decoration: BoxDecoration(
color: AppColors.todoToggleActiveBg,
borderRadius: BorderRadius.circular(18),
border: Border.all(
color: AppColors.todoToggleActiveBorder,
width: 1,
),
),
child: const Icon(
LucideIcons.listTodo,
size: 20,
color: AppColors.blue600,
),
),
const SizedBox(width: 4),
GestureDetector(
onTap: () {
final manager = sl<CalendarStateManager>();
final viewType = manager.viewType;
final date = manager.selectedDate;
final dateStr =
'${date.year}-${date.month.toString().padLeft(2, '0')}-${date.day.toString().padLeft(2, '0')}';
if (viewType == CalendarViewType.month) {
context.push('/calendar/month');
} else {
context.push('/calendar/dayweek?date=$dateStr');
}
},
child: Container(
width: 44,
height: 44,
decoration: BoxDecoration(
borderRadius: BorderRadius.circular(18),
),
child: const Icon(
LucideIcons.calendar,
size: 20,
color: AppColors.slate500,
),
),
),
],
),
),
GestureDetector(
onTap: () => Navigator.of(context).pop(),
child: Container(
width: 44,
height: 44,
decoration: BoxDecoration(
color: AppColors.todoHomeBtnBg,
borderRadius: BorderRadius.circular(18),
border: Border.all(
color: AppColors.todoHomeBtnBorder,
width: 1,
),
),
child: const Icon(
LucideIcons.home,
size: 20,
color: Color(0xFF1E3A8A),
),
),
),
],
),
),
);
}
}