extended_nested_scroll_view

Language: English | 中文简体

NestedScrollView: extended nested scroll view to fix following issues.

1.pinned sliver header issue

2.inner scrollables in tabview sync issue

3.do without ScrollController in NestedScrollView's body

Web demo for ExtendedNestedScrollView

• extended_nested_scroll_view
• Example for issue 1
• Example for issue 2
  • ExtendedVisibilityDetector
• Do without ScrollController in NestedScrollView's body

Example for issue 1

give total height of pinned sliver headers in pinnedHeaderSliverHeightBuilder callback

 var tabBarHeight = primaryTabBar.preferredSize.height;
                      var pinnedHeaderHeight =
                          //statusBar height
                          statusBarHeight +
                              //pinned SliverAppBar height in header
                              kToolbarHeight;
                
                    ExtendedNestedScrollView(
                        pinnedHeaderSliverHeightBuilder: () {
                          return pinnedHeaderHeight;
                        }
                       )   ,
                       
                

Example for issue 2

We usually keep list scroll position with following:

scene	onlyOneScrollInBody	description
AutomaticKeepAliveClientMixin	true	ScrollPosition will not be disposed, set onlyOneScrollInBody to true so that we can know which list is isActived.
PageStorageKey	false	ScrollPosition will be disposed, PageStorageKey just record the position info,the scroll positions in ExtendedNestedScrollView will always single one.

    ExtendedNestedScrollView(
                       onlyOneScrollInBody: true,
                    )
                

ExtendedVisibilityDetector

Provide ExtendedVisibilityDetector to point out which list is visible

   ExtendedVisibilityDetector(
                      uniqueKey: const Key('Tab1'),
                      child: ListView(),
                   )
                

Do without ScrollController in NestedScrollView's body

• due to we can't set ScrollController for list in NestedScrollView's body(it will breaking behaviours of InnerScrollController in NestedScrollView),provide Demos

• pull to refresh

• load more

• scroll to top

  show how to do it without ScrollController

• pinned header height

  show how to change pinned header height dynamically.

6.2.1

• Remove unnecessary assert(fix #149)

6.2.0

• Merge code from https://github.com/flutter/flutter/pull/123109 (fix #148)

6.1.2

• public innerPositions which are influenced by [onlyOneScrollInBody]

6.1.1

• upgrade visibility_detector

6.1.0

• Migrate to Flutter 3.10.0

6.0.0

• Migrate to 3.7.0. close #120,#115

5.1.3

• Upgrade visibility_detector to 0.33 by default.(please use dependency_overrides: visibility_detector: 0.2.2 if your Flutter sdk is under 3.0.0)

5.1.2

• Add keyboardDismissBehavior property #97

5.1.1

• Provide ExtendedVisibilityDetector to point out which list is visible

5.1.0

• Migrate to 3.0.0

5.0.0

• Migrate to 2.5
• Merge code from https://github.com/flutter/flutter/pull/87801
• Fix exception that findRenderObject throw exception even mounted is true

4.0.0

• Breaking change:
  1. refactor [ExtendedNestedScrollView].
  2. add [ExtendedNestedScrollView.onlyOneScrollInBody] to solve scroll sync issues(https://github.com/flutter/flutter/issues/21868).
  3. remove [ExtendedNestedScrollView.innerScrollPositionKeyBuilder] and [NestedScrollViewInnerScrollPositionKeyWidget].

3.0.1

• Check scrollable state if mounted on finding key of ScrollPosition. #78
• Igore inner position when inner delta is minimal value. #74

3.0.0

• Support null-safety
• Breaking change: Remove [NestedScrollViewRefreshIndicator], use [PullToRefreshNotification] instead of.
• Add [NestedScrollView.keyboardDismissBehavior]

2.0.1

• Fix issue that list sync issue is not fixed #40

2.0.0

• Breaking change: add clipBehavior and restorationId
• Merge flutter/issues/29264(SliverAppBar's flexibleSpace glitch on iOS when NestedScrollView's body is a ScrollView)

1.0.1

• Merge flutter/flutter#59187(Support floating the header slivers of a NestedScrollView)

1.0.0

• Merge code from 1.17.0
• Fix analysis_options

0.4.1

• add demo to show how to change pinned header height dynamically.

0.4.0

• web support

0.3.8

• add NestedScrollViewState key to get currentInnerPosition/innerScrollPositions instead of ScrollController
• due to we can't set ScrollController for list in NestedScrollView's body(it will breaking behaviours of InnerScrollController in NestedScrollView), provide demos('PullToRefresh','LoadMore' and 'ScrollToTop') to show how to do it without ScrollController

0.3.6

• fix api error base on Flutter SDK v1.7.8+hotfix.2

0.3.5

• New ExtendedNestedScrollView still has some issues in special layout, make it as obsolete for now till find a better solution

0.3.3

• fix issue that Caught error: type 'Future' is not a subtype of type 'Future' for old extended_nested_scroll_view

0.2.9

• fix issue 0.2.5 for old extended_nested_scroll_view

0.2.7

• fix issue for quick change page
• handle unavailable page change(no actived nested positions in it)

0.2.5

• fix issue that ut postion is not overscroll actually,it get minimal value and will scroll inner positions igore minimal value here(value like following data) /// I/flutter (14963): 5.684341886080802e-14 /// I/flutter (14963): -5.684341886080802e-14 if (innerDelta != 0.0 && innerDelta.abs() > 0.0001) { for (_NestedScrollPosition position in _activedInnerPositions) { position.applyFullDragUpdate(innerDelta); } }

0.2.0

• update new extended_nested_scroll_view demo

0.1.9

• set keepOnlyOneInnerNestedScrollPositionActive default value: false

0.1.8

• update new ExtendedNestedScrollView readme

0.1.7

• add assert for keepOnlyOneInnerNestedScrollPositionActive ///when ExtendedNestedScrollView body has TabBarView/PageView and children have ///AutomaticKeepAliveClientMixin or PageStorageKey, ///_innerController.nestedPositions will have more one, ///when you scroll, it will scroll all of nestedPositions ///set keepOnlyOneInnerNestedScrollPositionActive true to avoid it. ///notice: only for Axis.horizontal TabBarView/PageView and ///scrollDirection must be Axis.vertical. assert(!(widget.keepOnlyOneInnerNestedScrollPositionActive && widget.scrollDirection == Axis.horizontal));

0.1.6

• fix issue: Actived _NestedScrollPosition is not right for multiple

0.1.5

• add new ExtendedNestedScrollView to slove issue more smartly.

0.1.4

• Update readme.

0.1.3

• Update demo.

0.1.2

• Remove unused method.

0.1.1

• Update demo.

0.1.0

• Upgrade Some Commments.

0.0.1

• Initial Open Source release.