carousel_slider

chore: bump version to 5.1.2

• [Fix] Fix memory leak by properly disposing PageController (#493)
• [Fix] Prevent crash when calling animateToPage/jumpToPage before PageController is ready (#491)

• [Fix] Fix lint issue

• [Feat] Support Apple Pencil
• [Fix] Fix RangeError (length): Invalid value: Valid value range is empty: 0

• [FIX] Rename CarouselController to CarouselSliderController

• [FIX] temporary remove PointerDeviceKind.trackpad
• [FIX] fix 'double?' type

• [Add] enlargeFactor option

• [Add] CenterPageEnlargeStrategy.zoom option

• [Add] animateToClosest option

• [FIX] clear timer if widget was unmounted

• [FIX] scroll carousel using touchpad

• Fix code formatting

Add

• Exposed clipBehavior in CarouselOptions
• Exposed padEnds in CarouselOptions
• Add copyWith method to CarouselOptions

Fix

• [FIX] Can't swipe on web with Flutter 2.5

• Support null safety (Null safety isn't a breaking change and is Backward compatible meaning you can use it with non-null safe code too)
• Update example code to null safety and add Dark theme support and controller support to indicators in on of the examples and also fix overflow errors.

Add

• Add third argument in itemBuilder, allow Hero and infinite scroll to coexist

Breaking change

• itemBuilder needs to accept three arguments, instead of two.

Fix

• Rollback PR #222, due to it will break the existing project.

• Fix code formatting

Fix

• Double pointer down and up will cause a exception
• Fix CarouselPageChangedReason

Add

• Allow Hero and infinite scroll to coexist

• Fix code formatting

Fix

• Fixed unresponsiveness to state changes

Add

• Added start/stop autoplay functionality
• Pause auto play if not current route
• Add pageSnapping option for disable page snapping for the carousel

Fix

• Fixed carousel_options.dart and carousel_controller not being exported by default.

Add

• disableCenter option

This option controls whether the carousel slider item should be wrapped in a Center widget or not.

• enlargeStrategy option

This option allow user to set which enlarge strategy to enlarge the center slide. Use CenterPageEnlargeStrategy.height if you want to improve the performance.

Fix

• Fixed CarousePageChangedReason.manual never being emitted

Add

• pauseAutoPlayOnTouch option

This option controls whether the carousel slider should pause the auto play function when user is touching the slider

• pauseAutoPlayOnManualNavigate option

This option controls whether the carousel slider should pause the auto play function when user is calling controller's method.

• pauseAutoPlayInFiniteScroll option

This option decide the carousel should go to the first item when it reach the last item or not.

• pageViewKey option

This option is useful when you want to keep the pageview's position when it was recreated.

Fix

• Fix CarouselPageChangedReason bug

Other updates

• Use Transform.scale instead of SizedBox to wrap the slider item

Breaking change

Instead of passing all the options to the CarouselSlider, now you'll need to pass these option to CarouselOptions:

CarouselSlider(
  CarouselOptions(height: 400.0),
  items: [1,2,3,4,5].map((i) {
    return Builder(
      builder: (BuildContext context) {
        return Container(
          width: MediaQuery.of(context).size.width,
          margin: EdgeInsets.symmetric(horizontal: 5.0),
          decoration: BoxDecoration(
            color: Colors.amber
          ),
          child: Text('text $i', style: TextStyle(fontSize: 16.0),)
        );
      },
    );
  }).toList(),
)

Add

• CarouselController

Since v2.0.0, carousel_slider plugin provides a way to pass your own CaourselController, and you can use CaouselController instance to manually control the carousel's position. For a more detailed example please refer to example project.

• CarouselPageChangedReason

Now you can receive a CarouselPageChangedReason in onPageChanged callback.

Remove

• pauseAutoPlayOnTouch

pauseAutoPlayOnTouch option is removed, because it doesn't fix the problem we have. Currently, when we enable the autoPlay feature, we can not stop sliding when the user interact with the carousel. This is a flutter's issue.

Fix

• Fix animateTo()/jumpTo() with non-zero initialPage

Add

• Add on-demand item feature

Fix

• Fix setState() called after dispose() bug

Add

• Scroll physics option

Fix

• onPage indexing bug

Deprecation

• Remove the deprecated param: interval, autoPlayDuration, distortion, updateCallback. Please use the new param.

Fix

• Fix enlargeCenterPage option is not working in vertical carousel slider.

Add

• Vertical scroll support
• Enable/disable infinite scroll

Add

• Added pauseAutoPlayOnTouch option
• Add documentation

Add

• Update doc

Add

• Added distortion option

Fix

• Fix hard coded number

Fix

• Fix initialPage bug, fix crash when widget is disposed.

Remove useless dependencies, add changelog.

Initial version.