Android Flutter实现视频上滑翻页效果的示例代码

目录

• 前言
• PageView 组件介绍
• 使用示例
• PageController 应用

前言

我们在短视频应用中经常会看到不停上滑浏览下一条视频的沉浸式交互效果，这种交互能够让用户不停地翻页，直到找到喜欢的视频内容，从而营造一种不断“搜寻目标”的感觉，让用户欲罢不能。这种交互形式在 Flutter 中可以轻松使用 PageView 组件实现。

PageView 组件介绍

PageView 组件专门设计用来实现翻页效果，类定义如下：

PageView({
    Key? key,
    this.scrollDirection = Axis.horizontal,
    this.reverse = false,
    PageController? controller,
    this.physics,
    this.pageSnapping = true,
    this.onPageChanged,
    List<Widget> children = const <Widget>[],
    this.dragStartBehavior = DragStartBehavior.start,
    this.allowImplicitScrolling = false,
    this.restorationId,
    this.clipBehavior = Clip.hardEdge,
    this.scrollBehavior,
    this.padEnds = true,
  }) 

其中常用的属性说明如下：

• scrollDirection：滑动方向，可以支持纵向翻页或横向翻页，默认是横向翻页。
• controller：翻页控制器，可以通过控制器来制定初始页，以及跳转到具体的页面。
• onPageChanged：翻页后的回调函数，会告知翻页后的页码。
• reverse：是否反向翻页，默认是 false。如果横向滑动翻页的话，如果开启反向翻页，则是从右到左翻页。如果是纵向翻页的话，就是从顶部到底部翻页。
• children：在翻页中的组件列表，每一页都以自定义组件内容，因此这个组件也可以用于做引导页，或是类似滑动查看详情的效果。

使用示例

PageView 使用起来非常简单，我们先定义一个PageView 翻页的内容组件，简单地将接收的图片文件满屏显示。代码如下，实际应用的时候可以根据需要换成其他自定义组件。

 class ImagePageView extends StatelessWidget {
  final String imageName;
  const ImagePageView({Key? key, required this.imageName}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Image.asset(
        imageName,
        fit: BoxFit.fitHeight,
        width: MediaQuery.of(context).size.width,
        height: MediaQuery.of(context).size.height,
      ),
    );
  }
}

之后是定义一个 PageViewDemo 来应用 PageView 翻页应用示例，代码如下：

class PageViewDemo extends StatefulWidget {
  const PageViewDemo({Key? key}) : super(key: key);

  @override
  State<PageViewDemo> createState() => _PageViewDemoState();
}

class _PageViewDemoState extends State<PageViewDemo> {
  late PageController _pageController;
  int _pageIndex = 1;

  @override
  void initState() {
    _pageController = PageController(
      initialPage: _pageIndex,
      viewportFraction: 1.0,
    );
    super.initState();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      backgroundColor: Colors.black,
      body: PageView(
        scrollDirection: Axis.vertical,
        onPageChanged: (index) {
          _pageIndex = index;
        },
        controller: _pageController,
        allowImplicitScrolling: false,
        padEnds: true,
        reverse: false,
        children: const [
          ImagePageView(imageName: 'images/earth.jpeg'),
          ImagePageView(imageName: 'images/island-coder.png'),
          ImagePageView(imageName: 'images/mb.jpeg'),
        ],
      ),
    );
  }
}

这个示例里，我们的 pageController 只是演示了设置初始页码。我们看到的 viewportFraction 可以理解为一页内容占据屏幕的比例，比如我们可以设置该数值为1/3，支持一个屏幕分段显示3个页面内容。

PageController 应用

PageController 可以控制滑动到指定位置，比如我们可以调用 animateToPage方法实现一个快速滑动到顶部的悬浮按钮。

floatingActionButton: FloatingActionButton(
    onPressed: () {
      _pageController.animateToPage(
        0,
        duration: const Duration(
          milliseconds: 1000,
        ),
        curve: Curves.easeOut,
      );
    },
    backgroundColor: Colors.black.withAlpha(180),
    child: const Icon(
      Icons.arrow_upward,
      color: Colors.white,
    ),
  ),

实现效果如下。

PageController 还有如下控制翻页的方法：

• jumpToPage：跳转到指定页面，但是没有动画。注意这里不会校验页码是否会超出范围。
• nextPage：滑动到下一页，实际上调用的是 animateToPage 方法。
• previousPage：滑动到上一页，实际上调用的是 animateToPage 方法。