feat(settings): configure app bar collapse behavior

Author: realth000

lib/features/settings/repositories/settings_repository.dart

@@ -136,6 +136,7 @@ final class SettingsRepository with LoggerMixin {
       useDetectedProxyWhenStartup: s.extract(_SK.useDetectedProxyWhenStartup),
       enableAutoClearImageCache: s.extract(_SK.enableAutoClearImageCache),
       autoClearImageCacheDuration: s.extract(_SK.autoClearImageCacheDuration),
+      collapseAppBarWhenScroll: s.extract(_SK.collapseAppBarWhenScroll),
     );
   }
 

lib/features/settings/view/settings_page.dart

@@ -396,6 +396,7 @@ class _SettingsPageState extends State<SettingsPage> {
       autoSyncNoticeDuration = Duration(seconds: autoSyncNoticeSeconds);
     }
     final enableBBCodeParser = state.settingsMap.enableEditorBBCodeParser;
+    final collapseAppBarWhenScroll = state.settingsMap.collapseAppBarWhenScroll;
 
     return [
       SectionTitleText(tr.title),
@@ -475,6 +476,14 @@ class _SettingsPageState extends State<SettingsPage> {
         subtitle: Text(context.t.fastReplyTemplate.details),
         onTap: () async => context.pushNamed(ScreenPaths.fastReplyTemplate, pathParameters: {'pick': 'false'}),
       ),
+      SectionSwitchListTile(
+        secondary: const Icon(Symbols.page_header),
+        title: Text(tr.collapseAppBarWhenScroll.title),
+        subtitle: Text(tr.collapseAppBarWhenScroll.detail),
+        value: collapseAppBarWhenScroll,
+        onChanged: (v) async =>
+            context.read<SettingsBloc>().add(SettingsValueChanged(SettingsKeys.collapseAppBarWhenScroll, v)),
+      ),
     ];
   }
 

lib/i18n/en.i18n.json

@@ -198,6 +198,10 @@
           "title": "What is BBCode parser",
           "detail": "BBCode parser converts plain text BBCode into WYSIWYG content when:\n\n1. Editing published thread\n2. Editing reply templates\n3. Insert reply templates\n4. Expand bottom editor in thread and chat page\n\nDisabling BBCode parser will leave plain text to edit, turn if off when you get bugs."
         }
+      },
+      "collapseAppBarWhenScroll": {
+        "title": "Hide app bar when scroll",
+        "detail": "Hide when scroll down in subreddit and thread pages"
       }
     },
     "checkinSection": {

lib/i18n/zh-CN.i18n.json

@@ -198,6 +198,10 @@
           "title": "BBCode parser是什么",
           "detail": "以下场景中BBCode parser会将纯文本的BBCode转换为所见即所得的内容以供编辑:\n\n1. 编辑已发布的帖子\n2. 编辑回复模板\n3. 插入回复模板\n4. 展开帖子和聊天页面底部的编辑框\n\n关闭BBCode parse后在编辑时将使用纯文本，遇到问题时可将其关闭"
         }
+      },
+      "collapseAppBarWhenScroll": {
+        "title": "滑动时收起AppBar",
+        "detail": "分区和帖子页面中收起"
       }
     },
     "checkinSection": {

lib/i18n/zh-TW.i18n.json

@@ -198,6 +198,10 @@
           "title": "BBCode parser是什麼",
           "detail": "以下場景中BBCode parser會將純文字的BBCode轉換為所見即所得的內容以供編輯:\n\n1. 編輯已發布的帖子\n2. 編輯回复模板\n3. 插入回复模板\n4. 展開帖子和聊天頁面底部的編輯框\n\n關閉BBCode parse後在編輯時將使用純文本，遇到問題時可將其關閉"
         }
+      },
+      "collapseAppBarWhenScroll": {
+        "title": "滑動時收起AppBar",
+        "detail": "分割區與貼文頁面中收起"
       }
     },
     "checkinSection": {

lib/shared/models/settings.dart

@@ -192,7 +192,11 @@ enum SettingsKeys<T> implements Comparable<SettingsKeys<T>> {
   /// Images that have a long duration till last used time will be considered as outdated.
   ///
   /// Default is 7 days = 60 * 60 * 24 * 7.
-  autoClearImageCacheDuration<int>(name: 'autoClearImageCacheDuration', type: int, defaultValue: 60 * 60 * 24 * 7);
+  autoClearImageCacheDuration<int>(name: 'autoClearImageCacheDuration', type: int, defaultValue: 60 * 60 * 24 * 7),
+
+  /// Collapse app bar when scroll in pages we want to do it, for example forum page and thread page where app bar
+  /// holds more spaces and user shall have more space to focus on contents in UI.
+  collapseAppBarWhenScroll<bool>(name: 'collapseAppBarWhenScroll', type: bool, defaultValue: true);
 
   const SettingsKeys({required this.name, required this.type, required this.defaultValue});
 

lib/shared/models/settings_map.dart

@@ -50,6 +50,7 @@ class SettingsMap with SettingsMapMappable {
     required this.useDetectedProxyWhenStartup,
     required this.enableAutoClearImageCache,
     required this.autoClearImageCacheDuration,
+    required this.collapseAppBarWhenScroll,
   });
 
   final String netClientAccept;
@@ -94,6 +95,7 @@ class SettingsMap with SettingsMapMappable {
   final bool useDetectedProxyWhenStartup;
   final bool enableAutoClearImageCache;
   final int autoClearImageCacheDuration;
+  final bool collapseAppBarWhenScroll;
 
   SettingsMap copyWithKey<T>(SettingsKeys<T> key, T? value) {
     assert(
@@ -145,6 +147,7 @@ class SettingsMap with SettingsMapMappable {
       SettingsKeys.useDetectedProxyWhenStartup => copyWith(useDetectedProxyWhenStartup: value as bool?),
       SettingsKeys.enableAutoClearImageCache => copyWith(enableAutoClearImageCache: value as bool?),
       SettingsKeys.autoClearImageCacheDuration => copyWith(autoClearImageCacheDuration: value as int?),
+      SettingsKeys.collapseAppBarWhenScroll => copyWith(collapseAppBarWhenScroll: value as bool?),
     };
   }
 }

lib/widgets/list_app_bar.dart

@@ -115,10 +115,13 @@ class ListAppBar extends StatelessWidget implements PreferredSizeWidget {
     //  (though impossible if only one page).
     final reverseOrder = threadBloc?.state.reverseOrder ?? false;
 
+    final collapsableAppBar = context.select<SettingsBloc, bool>((v) => v.state.settingsMap.collapseAppBarWhenScroll);
+
     return SliverAppBar(
       title: title == null ? null : Text(title!),
-      floating: true,
-      snap: true,
+      pinned: !collapsableAppBar,
+      floating: collapsableAppBar,
+      snap: collapsableAppBar,
       bottom: PreferredSize(
         preferredSize: Size.fromHeight((bottom?.preferredSize.height ?? 0) + (isMobile ? 52 : 42)),
         child: Column(