parallax_animation 0.0.3 copy "parallax_animation: ^0.0.3" to clipboard
parallax_animation: ^0.0.3 copied to clipboard

This plugin enable a parallax effect in any Scrollable, simply wrap your Scrollable in a ParallaxArea and use a ParallaxWidget inside it.

A Parallax behavior for any Flutter Scrollable

This plugin enable a parallax effect in any Scrollable, simply wrap your Scrollable in a ParallaxArea and use a ParallaxWidget inside it. Interactive web sample Here

PageView Vertical PageView Horizontal
An animated image of the parallax animation inside a PageView with vertical scroll An animated image of the parallax animation inside a PageView with horizontal scroll
ListView Vertical ListView Horizontal
An animated image of the parallax animation inside a ListView with vertical scroll An animated image of the parallax animation inside a Listview with horizontal scroll

Features #

  • Overlap foreground and background parallax
  • Customizable magnitude of the Parallax
  • Works with any Scrollable
  • Parallax vertically, horizontally or both
  • Inverted parallax

Usage #

This plugin relies on RenderBox calculation and Scrollable notification to move the content accordling Simply wrap any Scrollable with a ParallaxArea and use a ParallaxWidget inside your scrollable to Enable the effect

Sample #

The following sample show how to add a parallax background to a PageView:

ParallaxArea(
  child: PageView.builder(
    scrollDirection: Axis.vertical,
    itemBuilder: (context, index) {
      return ParallaxWidget(
        child: Center(
          child: Text(
            "PAGE ${index + 1}",
            style: TextStyle(
              color: Colors.white,
              fontSize: 40,
              fontWeight: FontWeight.w900,
            ),
          ),
       ),
      overflowWidthFactor: 1,
      background: Image.asset(
        "assets/background_${index % 3}.jpg",
          fit: BoxFit.cover,
      ),
    );
  }),
),

Parallax properties #

Widget child #

Main child to be displayed, the size of the background will be matched to this child.

Widget? background #

The widget to be placed in the background, it will be contained in a OverflowBox and sized according to overflowWidthFactor and overflowHeightFactor.

double overflowWidthFactor #

The width multiplier factor, the background will be as larger as the child multiplied by the overflowWidthFactor, increasing this value will increase the parallax effect during horizontal scroll.

Min value 1, default value 2.

double overflowHeightFactor #

The height multiplier factor, the background will be as taller as the child multiplied by the overflowHeightFactor, increasing this value will increase the parallax effect during vertical scroll.

Min value 1, default value 2.

bool fixedHorizontal #

If true the parallax effect will be disabled for the horizontal Axis.

Default value false.

bool fixedVertical #

If true the parallax effect will be disabled for the vertical Axis.

Default value false.

bool inverted #

If true the parallax effect will be inverted for both Axis.

Default value false.

Alignment alignment #

Define the point where this Parallax should be centered The aligment will be relative to the parent ParallaxArea. For example if you set the Alignment.topLeft, the Background widget will be centered when the ParallaxWidget top and left will be aligned with the top and the left of the ParallaxArea parent.

default value Alignment.center.

bool clipOverflow #

Define if the overflow should be clipped, if not clipped the content will overflow outside the ParallaxWidget.

Default value true.

EdgeInsets parallaxPadding #

Give the parallax a general padding, used to avoid pixel bleeding if the content doesn't cover completely the viewport.

Default value EdgeInsets.zero.

bool showDebugInfo #

Show some debug info like positioning on the current parallax boundary and overflows.

68
likes
100
pub points
83%
popularity

Publisher

unverified uploader

This plugin enable a parallax effect in any Scrollable, simply wrap your Scrollable in a ParallaxArea and use a ParallaxWidget inside it.

Homepage

Documentation

API reference

License

unknown (LICENSE)

Dependencies

flutter

More

Packages that depend on parallax_animation