NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #1104 most downloaded on pub.dev
A widget for observing data related to the child widgets being displayed in a ScrollView.
Latest stable
1.27.3
Last release 2 months ago
14 Sep 2026
Release timing varies
gaps range from 8 days to 5 months
Nearly every release is documented
notes for 59 of 59 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
59 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
refactor: import widgets.dart instead of material.dart by @LinXunFeng in https://github.com/fluttercandies/flutter_scrollview_observer/pull/161
Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.27.2...1.27.3
package:flutter/widgets.dart instead of package:flutter/material.dart so the package no longer depends on the Material library, compatible with apps migrated to material_ui in Flutter 3.47 by @LinXunFeng in #156.fix(ListViewObserver): support SliverPrototypeExtentList by @LinXunFeng in https://github.com/fluttercandies/flutter_scrollview_observer/pull/159
Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.27.1...1.27.2
Your coding agent can read these notes before it upgrades. Set up the MCP server →
SliverPrototypeExtentList (prototypeItem of ListView and ReorderableListView) by @LinXunFeng in #158.fix(ObserverController): correct the scrolling clamped by an outdated scrollExtent by @LinXunFeng in https://github.com/fluttercandies/flutter_scrollv
Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.27.0...1.27.1
Record sliverContext and support conditional shrink wrap observation in standby by @LinXunFeng.
sliverContext and support conditional shrink wrap observation in standby by @LinXunFeng.cancelOnceObserveNotificationBubbling to control notification bubbling by @LinXunFeng.Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.26.3...1.27.0
sliverContext and support conditional shrink wrap observation in standby by @LinXunFeng.cancelOnceObserveNotificationBubbling to control notification bubbling by @LinXunFeng.Fix incorrect tag comparison in _checkTagChange by @LinXunFeng in #143.
_checkTagChange by @LinXunFeng in #143.Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.26.2...1.26.3
Refine the logic of calcAnchorTabIndex method by @LinXunFeng.
calcAnchorTabIndex method by @LinXunFeng.Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.26.1...1.26.2
Refine the logic of standby by @LinXunFeng.
standby by @LinXunFeng.Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.26.0...1.26.1
Add await support for animateTo and jumpTo methods by @LinXunFeng.
animateTo and jumpTo methods by @LinXunFeng.Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.25.2...1.26.0
Fix "ObserverWidgetState was used after being disposed" by @LinXunFeng in #120 and #123.
Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.25.1...1.25.2
Fix observation result inaccurate by @LinXunFeng in #113.
Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.25.0...1.25.1
> Above features are implemented by @LinXunFeng.
customAdjustPosition.Above features are implemented by @LinXunFeng.
Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.24.0...1.25.0
> Above features are implemented by @LinXunFeng.
displayingChildModelMap.customAdjustPositionDelta.Above features are implemented by @LinXunFeng.
Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.23.0...1.24.0
displayingChildModelMap.customAdjustPositionDelta.Make ObserverWidget listenable by @LinXunFeng.
ObserverWidget listenable by @LinXunFeng.Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.22.0...1.23.0
CI: Action - Code Analysis by @AmosHuKe in https://github.com/fluttercandies/flutter_scrollview_observer/pull/93
scrollNotificationPredicate by @LinXunFengFull Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.21.2...1.22.0
Fix web support by @Ahmadre in #91.
Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.21.1...1.21.2
Improve the logic of handleListObserve and handleGridObserve.
handleListObserve and handleGridObserve.Above features are implemented by @LinXunFeng.
Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.21.0...1.21.1
Add onPrepareScrollToIndex for jumpTo and animateTo.
onPrepareScrollToIndex for jumpTo and animateTo.jumpTo and animateTo methods.Above features are implemented by @LinXunFeng.
Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.20.0...1.21.0
Add observeIntervalForScrolling to set the minimum amount of time to wait for firing observe callback during scrolling.
observeIntervalForScrolling to set the minimum amount of time to wait for firing observe callback during scrolling.isDisplayingSliverInViewport method.observeViewportResultModel.ChatScrollObserverRefIndexType.refIndexType to specify the role of refItemIndex and refItemIndexAfterUpdate.SliverObserveContext.visibleFraction and visibleMainAxisSize.Above features are implemented by @LinXunFeng.
Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.19.1...1.20.0
Support SliverVariedExtentList in 74.
SliverVariedExtentList in 74.constraints of RenderSliver.CustomScrollView specifies center.Above features are implemented by @LinXunFeng.
Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.19.0...1.19.1
SliverVariedExtentList in 74.constraints of RenderSliver.CustomScrollView specifies center.To better support NestedScrollView.
customOverlap property.NestedScrollView.Above features are implemented by @LinXunFeng.
Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.18.2...1.19.0
Fix keeping position not working by @LinXunFeng in #64
Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.18.1...1.18.2
Add a check to determine whether the BuildContext is mounted by @LinXunFeng in #62.
Add a check to determine whether the BuildContext is mounted by @LinXunFeng in #62.
Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.18.0...1.18.1
Add some scrolling task notifications extending from ObserverScrollNotification.
ObserverScrollNotification.jumpTo method and animateTo method supports await.isForbidObserveCallback property.isForbidObserveViewportCallback property.Above features are implemented by @LinXunFeng.
Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.17.0...1.18.0
ObserverScrollNotification.jumpTo method and animateTo method support await.isForbidObserveCallback property.isForbidObserveViewportCallback property.The parameter isFixedHeight in the jumpTo method and animateTo method supports GridView and supports ScrollView built by third-party package by @perci
isFixedHeight in the jumpTo method and animateTo method supports GridView and supports ScrollView built by third-party package by @percival888 in https://github.com/fluttercandies/flutter_scrollview_observer/pull/52Full Changelog: https://github.com/fluttercandies/flutter_scrollview_observer/compare/1.16.5...1.17.0
Improve the processing logic of scroll notification when scrolling with the mouse wheel is not smooth by @qiangjindong in #48.
isShrinkWrap once during initialization by @LinXunFeng. #47Full Changelog: https://github.com/LinXunFeng/flutter_scrollview_observer/compare/1.16.4...1.16.5
Supplement missing type conversion adjustments by @LinXunFeng .
Full Changelog: https://github.com/LinXunFeng/flutter_scrollview_observer/compare/1.16.3...1.16.4
Add viewport property to observation model by @LinXunFeng.
Full Changelog: https://github.com/LinXunFeng/flutter_scrollview_observer/compare/1.16.2...1.16.3
Adjust the conversion type of viewport.offset to ScrollPosition by @LiuDongCai in #41.
viewport.offset to ScrollPosition by @LiuDongCai in #41.displayPercentage to scenes with SliverPersistentHeader by @percival888 in #43.calculateDisplayPercentage method by @LinXunFeng.Full Changelog: https://github.com/LinXunFeng/flutter_scrollview_observer/compare/1.16.1...1.16.2
> Above content are implemented by @LinXunFeng.
3.13.0Above content are implemented by @LinXunFeng.
Full Changelog: https://github.com/LinXunFeng/flutter_scrollview_observer/compare/1.16.0...1.16.1
dispatchOnceObserve method supports directly getting observation result.
dispatchOnceObserve method supports directly getting observation result.Above content are implemented by @LinXunFeng.
Full Changelog: https://github.com/LinXunFeng/flutter_scrollview_observer/compare/1.15.0...1.16.0
Add SliverObserveContextToBoxAdapter.
SliverObserveContextToBoxAdapter.Above content are implemented by @LinXunFeng.
Full Changelog: https://github.com/LinXunFeng/flutter_scrollview_observer/compare/1.14.2...1.15.0
> Above content are implemented by @LinXunFeng.
Above content are implemented by @LinXunFeng.
Full Changelog: https://github.com/LinXunFeng/flutter_scrollview_observer/compare/1.14.1...1.14.2
Improve the logic of the conversion type.
Above content are implemented by @LinXunFeng.
Full Changelog: https://github.com/LinXunFeng/flutter_scrollview_observer/compare/1.14.0...1.14.1
Support for keeping position of generative messages (eg: ChatGPT)
Above content are implemented by @LinXunFeng.
Full Changelog: https://github.com/LinXunFeng/flutter_scrollview_observer/compare/1.13.2...1.14.0
🛠 Getting bad observation result on web was fixed by @LinXunFeng in #31. Thanks to @rmasarovic for the test.
Full Changelog: https://github.com/LinXunFeng/flutter_scrollview_observer/compare/1.13.1...1.13.2
🛠 Fix no getting all child widgets those are displayed when there are separators in ListView. #31
ListView. #31findRenderObject method.Above content are implemented by @LinXunFeng.
Full Changelog: https://github.com/LinXunFeng/flutter_scrollview_observer/compare/1.13.0...1.13.1
💪 The calcAnchorTabIndex method supports GridView.
calcAnchorTabIndex method supports GridView.handleListObserve method and handleGridObserve method.Above features are implemented by @LinXunFeng.
Full Changelog: https://github.com/LinXunFeng/flutter_scrollview_observer/compare/1.12.0...1.13.0
⚙ Support custom observation object and observation logic.
Above features are implemented by @LinXunFeng.
Full Changelog: https://github.com/LinXunFeng/flutter_scrollview_observer/compare/1.11.0...1.12.0
Support for maintaining position when inserting multiple messages at once.
GridViewObserver is compatible with waterfall flow.SliverViewObserver supports observation of viewport.Above features are implemented by @LinXunFeng.
Full Changelog: https://github.com/LinXunFeng/flutter_scrollview_observer/compare/1.10.1...1.11.0
GridViewObserver is compatible with waterfall flow.SliverViewObserver supports observation of viewport.fix: targetOffset calculate may be negative by @zeqinjie in #21.
ObserverController
Improve [_calculateTargetLayoutOffset] logic by @LinXunFeng @percival888
ObserverController
[_calculateTargetLayoutOffset] logic by @LinXunFeng @percival888jumpTo method and animateTo method both add a parameter [padding].ObserverIndexPositionModel
[padding].[_calculateTargetLayoutOffset] logic.jumpTo method and animateTo method both add a parameter [padding].[padding].Catch the exception thrown by getting size.
ObserverWidget
Modify offset calculation logic in method [_calculateTargetLayoutOffset].
ObserverController
[_calculateTargetLayoutOffset]. (#17)Add property [autoTriggerObserveTypes] and property [triggerOnObserveType].
ObserverWidget
[autoTriggerObserveTypes] and property [triggerOnObserveType].ObserverController
[dispatchOnceObserve] adds parameter [isForce].Deprecated [clearIndexOffsetCache], please use [clearScrollIndexCache] instead.
[clearIndexOffsetCache], please use [clearScrollIndexCache] instead.Deprecated [ChatObserverClampinScrollPhysics], please use [ChatObserverClampingScrollPhysics] instead.
[fixedPositionOffset].[ChatObserverClampinScrollPhysics], please use [ChatObserverClampingScrollPhysics] instead.[fixedPositionOffset].[ChatObserverClampinScrollPhysics], please use [ChatObserverClampingScrollPhysics] instead.Fix lib not working when itemExtent is set in ListView.
itemExtent is set in ListView. (#12)Fix lib not working when shrinkWrap is true in scrollView.
shrinkWrap is true in scrollView. (#11)- Chat Observer - Add onHandlePositionCallback.
onHandlePositionCallback.Fix scrollView being stuck when child widget get [size].
[size]. (#10)Quickly implement the chat session page effect.
[cacheJumpIndexOffset].Scrolling to the specified index location
alignment paramter in the jumpTo and animateTo methods.offset paramter.alignment parameter in the jumpTo and animateTo methods.offset parameter.Scrolling to the specified index location supports the SliverPersistentHeader.
SliverPersistentHeader. (#9)ObserverUtils
calcPersistentHeaderExtent: Calculate current extent of RenderSliverPersistentHeader. (#9)calcAnchorTabIndex: Calculate the anchor tab index.SliverPersistentHeader.ObserverUtils
calcPersistentHeaderExtent: Calculate current extent of RenderSliverPersistentHeader.calcAnchorTabIndex: Calculate the anchor tab index.The jumpTo and animateTo methods add an isFixedHeight parameter to optimize performance when the child widget is of fixed height
jumpTo and animateTo methods add an isFixedHeight parameter to optimize performance when the child widget is of fixed height[leadingMarginToViewport] and [trailingMarginToViewport]SliverList and SliverGridSupports scrolling to the specified index location
- Delete useless code
Implements a way to use without sliver [BuildContext]
[BuildContext][onObserve] to [onObserveAll], and add a new [onObserve] callback to listen for changes in the child widget display of the first sliver[ObserverController]- Support GridView - Support the horizontal
- Initial release
One column per quarter.