搜索插件、代码仓与 APP 分类

scroll_pos 封面
插件详情v0.5.0

scroll_pos

为 ScrollController 提供一些额外功能,以定义项目相对于屏幕的位置。

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
19.7万
喜欢数
75
Pub 分数
160

安装插件

flutter pub add scroll_pos

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

scroll_pos 包通过添加实用函数来增强 Flutter 的 ScrollController,以确定列表项相对于屏幕的位置。它简化了检测项目是否完全可见、部分可见或靠近视口顶部/底部的任务。非常适合构建交互式列表、无限滚动或根据滚动状态响应的动态 UI。该包支持所有主要平台,并可与现有的 ScrollController 实现无缝集成。

适合场景

  • 检测可见列表项
  • 实现无限滚动逻辑
  • 创建滚动触发的动画
  • 构建动态列表布局
  • 跟踪滚动过程中的项目可见性

主要特点

  • 轻松检测项目位置
  • 扩展 ScrollController 功能
  • 跨平台支持
  • 最小化样板代码
  • 精确的屏幕相对定位

适合对象

  • 开发复杂可滚动界面的开发者
  • 需要实时滚动反馈的应用
  • 无限滚动或懒加载功能
  • 基于列表的交互式 UI

使用建议

  • 需要与 ScrollController 集成
  • 限于可滚动上下文
  • 无内置动画处理
  • 可能需要额外的状态管理
  • 不适用于非可滚动控件

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

Scroll Position

Provides some additional functions to ScrollController to define item position relative to the screen.

A live version is available here.

scrollpos_demo

Note: this works on condition that all items have the same height !

Usage

// Create a ScrollPosController (don't forget to set and update itemCount !)
final controller = ScrollPosController(itemCount: itemCount);

// Assign the controller to a scrollable item (like an ListView)
ListView(
  controller: controller,
  children: [
    ...
  ];
);

// Control the controller
TextButton(
  child: Text('To item'),
  onPressed: () {
    setState(() {
      controller.scrollToItem(index);
    });
  },
);

Main methods

  • void scrollTop({bool? animate}) : Go to the first item
  • void scrollBottom({bool? animate}) : Go to the last item
  • void scrollToItem(int index, {bool? animate, bool center = false}) : Makes the item visible on the screen

所属分类

源码仓库

使用此插件的项目