app_bar_auto_hide 是一个 Flutter 插件，它可以帮助你在滚动内容时自动隐藏或显示 AppBar。这在创建具有沉浸式体验的应用程序时非常有用，特别是在处理长列表或可滚动内容时。

安装插件

首先，你需要在 pubspec.yaml 文件中添加 app_bar_auto_hide 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  app_bar_auto_hide: ^1.0.0  # 请检查最新的版本号

然后运行 flutter pub get 来安装插件。

使用 app_bar_auto_hide

app_bar_auto_hide 提供了一个 AutoHideAppBar 小部件，你可以将它放在 Scaffold 的 appBar 属性中。以下是一个简单的示例：

import 'package:flutter/material.dart';
import 'package:app_bar_auto_hide/app_bar_auto_hide.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Auto Hide AppBar Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: AutoHideAppBarExample(),
    );
  }
}

class AutoHideAppBarExample extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AutoHideAppBar(
        title: Text('Auto Hide AppBar'),
      ),
      body: ListView.builder(
        itemCount: 50,
        itemBuilder: (context, index) {
          return ListTile(
            title: Text('Item $index'),
          );
        },
      ),
    );
  }
}

参数说明

AutoHideAppBar 提供了多个参数来自定义行为：

• title: AppBar 的标题，通常是一个 Text 小部件。
• leading: AppBar 左侧的按钮，通常是返回按钮。
• actions: AppBar 右侧的操作按钮列表。
• elevation: AppBar 的阴影高度。
• backgroundColor: AppBar 的背景颜色。
• iconTheme: AppBar 中图标的主题。
• textTheme: AppBar 中文本的主题。
• centerTitle: 是否将标题居中。
• hideOnScroll: 是否在滚动时隐藏 AppBar，默认为 true。
• showOnScrollUp: 是否在向上滚动时显示 AppBar，默认为 true。
• scrollController: 可以传入一个自定义的 ScrollController，以便控制滚动行为。

自定义滚动行为

如果你想要更精细地控制 AppBar 的显示和隐藏行为，可以通过 scrollController 参数传入一个自定义的 ScrollController，并在其监听器中实现自定义逻辑。

class AutoHideAppBarExample extends StatefulWidget {
  [@override](/user/override)
  _AutoHideAppBarExampleState createState() => _AutoHideAppBarExampleState();
}

class _AutoHideAppBarExampleState extends State<AutoHideAppBarExample> {
  final ScrollController _scrollController = ScrollController();

  [@override](/user/override)
  void initState() {
    super.initState();
    _scrollController.addListener(() {
      // 自定义逻辑
    });
  }

  [@override](/user/override)
  void dispose() {
    _scrollController.dispose();
    super.dispose();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AutoHideAppBar(
        title: Text('Auto Hide AppBar'),
        scrollController: _scrollController,
      ),
      body: ListView.builder(
        controller: _scrollController,
        itemCount: 50,
        itemBuilder: (context, index) {
          return ListTile(
            title: Text('Item $index'),
          );
        },
      ),
    );
  }
}