Flutter列表滑动曝光埋点，支持SliverList、SliverGrid

flutter_sliver_tracker

GitHub链接

滑动曝光埋点框架，支持SliverList、SliverGrid

什么是滑动曝光埋点

滑动曝光埋点用于滑动列表组件中的模块曝光，例如Flutter中的SliverList、SliverGrid。 当SliverList中的某一个行（或列）移动到ViewPort中，而且显示比例超过必定阈值时，咱们把这个事件记为一次滑动曝光事件。

固然咱们对滑动曝光有一些额外的要求：

• 须要滑出必定比例的时候才出发曝光（已实现）
• 滑动速度快时不触发曝光事件（须要throttle）
• 滑出视野的模块，再次滑入视野时须要再次上报（已实现）
• 模块在视野中上下反复移动只触发一次曝光（还未实现）

运行Demo

• 克隆代码到本地: git clone git@github.com:SBDavid/flutter_sliver_tracker.git
• 切换工做路径: cd flutter_sliver_tracker/example/
• 启动模拟器
• 运行: flutter run

内部原理

滑动曝光的核心难点是计算组件的露出比例。也是说咱们须要知道ListView中的组件的总高度、当前显示高度。 这两个高度作除法就能够得出比例。

组件总高度

组件的总高度能够在renderObject中获取。咱们能够获取renderObject下的size属性，其中包含了组件的长宽。

当前显示高度

显示高度能够从SliverGeometry.paintExtent中获取。

使用文档

1. 安装

dependencies:
 flutter_sliver_tracker: ^1.0.0
复制代码

2. 引用插件

import 'package:xm_sliver_listener/flutter_sliver_tracker.dart';
复制代码

3. 发送滑动埋点事件

3.1 经过ScrollViewListener捕获滚动事件，ScrollViewListener必须包裹在CustomScrollView之上。

class _MyHomePageState extends State<MyHomePage> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      // 经过ScrollViewListener捕获滚动事件
      body: ScrollViewListener(
        child: CustomScrollView(
          slivers: <Widget>[
          ],
        ),
      ),
    );
  }
}
复制代码

3.2 在SliverToBoxAdapter中监听滚动中止事件，并计算显示比例

class _MyHomePageState extends State<MyHomePage> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      // 经过ScrollViewListener捕获滚动事件
      body: ScrollViewListener(
        child: CustomScrollView(
          slivers: <Widget>[
            SliverToBoxAdapter(
              // 监听中止事件，若是在页面上展现比例，能够自行setState
              child: SliverEndScrollListener(
                onScrollInit: (SliverConstraints constraints, SliverGeometry geometry) {
                  // 显示高度 / sliver高度
                  Fluttertoast.showToast(msg: "展现比例：${geometry.paintExtent / geometry.scrollExtent}");
                },
                onScrollEnd: (ScrollEndNotification notification,
                    SliverConstraints constraints,
                    SliverGeometry geometry) {
                  Fluttertoast.showToast(msg: "展现比例：${geometry.paintExtent / geometry.scrollExtent}");
                },
                child: Container(
                  height: 300,
                  color: Colors.amber,
                 
                  ),
                ),
            ),
          ],
        ),
      ),
    );
  }
}
复制代码

3.3 在SliverList和SliverGrid中监听滚动中止事件，并计算显示比例

• itemLength：列表项布局高度
• displayedLength：列表项展现高度
• 若是须要在widget中显示高度，能够自行setState

class _MyHomePageState extends State<MyHomePage> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      // 经过ScrollViewListener捕获滚动事件
      body: ScrollViewListener(
        child: CustomScrollView(
          slivers: <Widget>[
            SliverList(
              delegate: SliverChildBuilderDelegate(
                (BuildContext context, int index) {
                  // 监听滚动中止
                  return SliverMultiBoxScrollEndListener(
                    debounce: 1000,
                    child: Container(
                      height: 300,
                      color: Colors.redAccent,
                      child: Center(
                        child: Text("SliverList Item", style: TextStyle(fontSize: 30, color: Colors.white))
                      ),
                    ),
                    onScrollInit: (double itemLength, double displayedLength) {
                      Fluttertoast.showToast(msg: "显示高度：${displayedLength}");
                    },
                    onScrollEnd: (double itemLength, double displayedLength) {
                      Fluttertoast.showToast(msg: "显示高度：${displayedLength}");
                    },
                  );
                },
                childCount: 1
              ),
            ),
          ],
        ),
      ),
    );
  }
}
复制代码

3.4 在SliverList和SliverGrid中监听滚动更新事件，并计算显示比例

class _MyHomePageState extends State<MyHomePage> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      // 经过ScrollViewListener捕获滚动事件
      body: ScrollViewListener(
        child: CustomScrollView(
          slivers: <Widget>[
            SliverList(
              delegate: SliverChildBuilderDelegate(
                      (BuildContext context, int index) {
                // 监听滚动更新事件
                return SliverMultiBoxScrollUpdateListener(
                  onScrollInit: (double percent) {
                    // percent 列表项显示比例
                  },
                  onScrollUpdate: (double percent) {
                    // percent 列表项显示比例
                  },
                  debounce: 1000,
                  // percent 列表项显示比例
                  builder: (BuildContext context, double percent) {
                    return Container(
                      height: 200,
                      color: Colors.amber.withAlpha((percent * 255).toInt()),
                      child: Center(
                          child: Text("SliverList Item Percent ${percent.toStringAsFixed(2)}", style: TextStyle(fontSize: 30, color: Colors.white))
                      ),
                    );
                  },
                );
              },
              childCount: 6
              ),
            ),
          ],
        ),
      ),
    );
  }
}
复制代码