MookNote/Wiki/Pages-and-Navigation.md

页面与路由

页面结构

主页框架

HomePage
├── CustomDrawer (侧边菜单)
├── PageView
│   ├── MainContentPage (主内容)
│   │   ├── MovieTabPage  (观影列表, mainTabIndex=0)
│   │   ├── BookTabPage   (阅读列表, mainTabIndex=1)
│   │   └── NoteTabPage   (笔记列表, mainTabIndex=2)
│   └── ProfilePage (我的, bottomNavIndex=2)
└── BottomNavBar (底部导航)

底部导航切换 bottomNavIndex：

• 0 → 主内容页（MainContentPage）
• 1 → 新增页（根据当前 mainTabIndex 跳转对应表单）
• 2 → 个人页（ProfilePage）

影视模块页面

页面	文件	说明
MovieTabPage	pages/movies/movie_tab_page.dart	影视列表（支持影视墙模式）
MovieFormPage	pages/movies/movie_form_page.dart	新增/编辑影视
MovieDetailPage	pages/movies/movie_detail_page.dart	影视详情
MovieReviewsPage	pages/movies/movie_reviews_page.dart	影评列表（右下角浮动添加按钮）
MovieReviewFormPage	pages/movies/movie_review_form_page.dart	新增/编辑影评
MovieReviewDetailPage	pages/movies/movie_review_detail_page.dart	影评详情
MoviePostersPage	pages/movies/movie_posters_page.dart	海报墙（右下角浮动添加按钮）
PosterGalleryPage	pages/movies/poster_gallery_page.dart	海报画廊浏览
MovieSharePage	pages/movies/movie_share_page.dart	影视分享
DoubanWebViewPage	pages/movies/douban_webview_page.dart	豆瓣 WebView

书籍模块页面

页面	文件	说明
BookTabPage	pages/book/book_tab_page.dart	书籍列表（支持书架模式）
BookFormPage	pages/book/book_form_page.dart	新增/编辑书籍
BookDetailPage	pages/book/book_detail_page.dart	书籍详情
BookReviewsPage	pages/book/book_reviews_page.dart	书评列表（右下角浮动添加按钮）
BookReviewFormPage	pages/book/book_review_form_page.dart	新增/编辑书评
BookReviewDetailPage	pages/book/book_review_detail_page.dart	书评详情
BookExcerptsPage	pages/book/book_excerpts_page.dart	摘抄列表（右下角浮动添加按钮）
BookExcerptFormPage	pages/book/book_excerpt_form_page.dart	新增/编辑摘抄
BookSharePage	pages/book/book_share_page.dart	书籍分享

笔记模块页面

页面	文件	说明
NoteTabPage	pages/note/note_tab_page.dart	笔记列表
NoteFormPage	pages/note/note_form_page.dart	新增/编辑笔记
NoteDetailPage	pages/note/note_detail_page.dart	笔记详情
NoteSharePage	pages/note/note_share_page.dart	笔记分享

其他页面

页面	文件	说明
HomePage	pages/home_page.dart	主页框架
MainContentPage	pages/main_content_page.dart	主内容区域
ProfilePage	pages/profile_page.dart	个人页
SearchPage	pages/search_page.dart	全局搜索
StatisticsPage	pages/statistics_page.dart	统计分析
StrollPage	pages/stroll_page.dart	浏览/发现
RecycleBinPage	pages/recycle_bin_page.dart	回收站
TagManagementPage	pages/tag_management_page.dart	标签管理
AppIconPickerPage	pages/app_icon_picker_page.dart	应用图标选择
BackupPage	pages/sync/backup_page.dart	本地备份
CloudSyncPage	pages/sync/cloud_sync_page.dart	云同步
ServerSyncPage	pages/sync/server_sync_page.dart	服务端同步配置
WebDAVSyncPage	pages/sync/webdav_sync_page.dart	WebDAV 同步
MdReaderTabPage	pages/markdown_reader/md_reader_tab_page.dart	Markdown 阅读器目录
MdViewerPage	pages/markdown_reader/md_viewer_page.dart	Markdown 查看器
EpubReaderPage	pages/epub_reader/epub_reader_page.dart	EPUB 阅读器
EpubDetailPage	pages/epub_reader/epub_detail_page.dart	EPUB 详情（书摘、高亮）

路由

AppRouter（lib/utils/app_router.dart）使用 onGenerateRoute 生成路由：

路由名	参数	目标页面
/movie-form	Movie? 或 {initialStatus}	MovieFormPage
/book-form	Book? 或 {initialStatus}	BookFormPage
/note-form	Note?	NoteFormPage
/movie-detail	Movie	MovieDetailPage
/book-detail	Book	BookDetailPage
/note-detail	Note	NoteDetailPage
/douban-webview	String (URL)	DoubanWebViewPage

过渡动画

所有路由使用 SlideUpPageRoute（lib/utils/slide_up_page_route.dart），实现从底部滑入的过渡效果。

添加按钮统一规范

为保证界面一致性，以下页面使用 FloatingActionButton.extended 作为右下角添加按钮：

页面	添加按钮文案	图标
BookExcerptsPage	添加摘抄	Icons.add
BookReviewsPage	添加书评	Icons.add
MovieReviewsPage	添加影评	Icons.add
MoviePostersPage	添加海报	Icons.add_photo_alternate

返回首页