carousel_animations

Description:

carousel animations

This is a very early fork, recommend using the original for now. #








card_swiper #
Swiper/Carousel for flutter, with multiple layouts, infinite loop. Compatible with Android & iOS.
✨✨ New Features:Layout for pagination. #
✨✨ New Features:PageTransformer #
Finally, we have PageTransformer like android, just set a transformer to Swiper,
it returns a widget that has been transformed. For now, only support for layout DEFAULT.
Thanks to @FlutterRocks ,you've done great job 👏.
✨✨ New Features:Layout #



See More
Showcases #






See More
Changelogs #

see:CHANGELOG.md

Getting Started #

Installation
Basic Usage
Constructor

Basic
Pagination
Control buttons
Controller
Autoplay


Build in layouts
Codes

Installation #
Add
carousel_animations :
copied to clipboard
to your pubspec.yaml, and run
flutter packages get
copied to clipboard
in your project's root directory.
OR
run
flutter pub add carousel_animations
copied to clipboard
in your project's root directory.
Basic Usage #
Create a new project with command
flutter create myapp
copied to clipboard
Edit lib/main.dart like this:

import 'package:flutter/material.dart';

import 'package:carousel_animations/carousel_animations.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
return MaterialApp(
title: 'Flutter Demo',
theme: ThemeData(
primarySwatch: Colors.blue,
),
home: MyHomePage(title: 'Flutter Demo Home Page'),
);
}
}

class MyHomePage extends StatefulWidget {
MyHomePage({Key key, this.title}) : super(key: key);

final String title;

@override
_MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {

@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: Text(widget.title),
),
body: Swiper(
itemBuilder: (BuildContext context,int index){
return Image.network("https://via.placeholder.com/350x150",fit: BoxFit.fill,);
},
itemCount: 3,
pagination: SwiperPagination(),
control: SwiperControl(),
),
);
}
}

copied to clipboard
Constructor #
Basic



Parameter
Default
Description




scrollDirection
Axis.horizontal
If Axis.horizontal, the scroll view's children are arranged horizontally in a row instead of vertically in a column.


axisDirection
AxisDirection.left
If AxisDirection.right, the scroll view's children are arranged right side in a row instead of left.Note: Currently supported for horizontal stack layout only


loop
true
Set to false to disable continuous loop mode.


index
0
Index number of initial slide.


autoplay
false
Set to true enable auto play mode.


onIndexChanged
void onIndexChanged(int index)
Called with the new index when the user swiped or autoplay


onTap
void onTap(int index)
Called when user tap ui.


duration
300.0
The milliscends of every transaction animation costs


pagination
null
set SwiperPagination() to show default pagination


control
null
set SwiperControl() to show default control buttons



Pagination
The pagination extends from SwiperPlugin,the SwiperPlugin provides extra ui for Swiper.Set SwiperPagination() to show default pagination.



Parameter
Default
Description




alignment
Alignment.bottomCenter
Change this value if you what to put pagination in other place


margin
const EdgeInsets.all(10.0)
The distance between inner side of the parent container.


builder
SwiperPagination.dots
There are three default styles SwiperPagination.dots, SwiperPagination.fraction and SwiperPagination.rect, these can be customized.



If you'd like to customize your own pagination, you can do like this:
Swiper(
...,
pagination: SwiperCustomPagination(
builder:(BuildContext context, SwiperPluginConfig config){
return YourOwnPagination();
}
)
);

copied to clipboard
Implemented pagination
DotSwiperPaginationBuilder



Parameter
Default
Description
Required




activeColor
Theme.of(context).primaryColor
Active bullet color
false


color
Theme.of(context).scaffoldBackgroundColor
Bullet color
false


activeSize
10.0
Active bullet size
false


size
10.0
Bullet size
false


space
3.0
Distance between bullets
false


key
-
key
false



FractionPaginationBuilder



Parameter
Default
Description
Required




activeColor
Theme.of(context).primaryColor
Active font color
false


color
Theme.of(context).scaffoldBackgroundColor
font color
false


activeFontSize
35.0
Active font size
false


fontSize
20.0
Font size
false


key
-
key
false



RectSwiperPaginationBuilder



Parameter
Default
Description
Required




activeColor
Theme.of(context).primaryColor
Active bullet color
false


color
Theme.of(context).scaffoldBackgroundColor
Bullet color
false


activeSize
10.0
Active bullet size
false


size
10.0
Bullet size
false


space
3.0
Distance between bullets
false


key
-
key
false



Control buttons
The control also extends from SwiperPlugin,set SwiperControl() to show default control buttons.



Parameter
Default
Description




iconPrevious
Icons.arrow_back_ios
The icon data to display previous control button


iconNext
Icons.arrow_forward_ios
The icon data to display next.


color
Theme.of(context).primaryColor
Control button color


disableColor
Theme.of(context).disabledColor
Disabled control button color


size
30.0
Control button size


padding
const EdgeInsets.all(5.0)
Control button padding



Controller
The Controller is used to control the index of the Swiper, start or stop autoplay.You can create a controller by SwiperController() and save the instance by futher usage.



Method
Description




void move(int index, {bool animation: true})
Move to the spicified index,with animation or not


void next({bool animation: true})
Move to next


void previous({bool animation: true})
Move to previous


void startAutoplay()
Start autoplay


void stopAutoplay()
Stop autoplay



Autoplay



Parameter
Default
Description




autoplayDelay
3000
Autoplay delay milliseconds.


autoplayDisableOnInteraction
true
If set true, autoplay is disabled when use swipes.



Build in layouts #

Swiper(
itemBuilder: (BuildContext context, int index) {
return Image.network(
"https://via.placeholder.com/288x188",
fit: BoxFit.fill,
);
},
itemCount: 10,
viewportFraction: 0.8,
scale: 0.9,
)

copied to clipboard

Swiper(
itemBuilder: (BuildContext context, int index) {
return Image.network(
"https://via.placeholder.com/288x188",
fit: BoxFit.fill,
);
},
itemCount: 10,
itemWidth: 300.0,
layout: SwiperLayout.STACK,
)
copied to clipboard

Swiper(
itemBuilder: (BuildContext context, int index) {
return Image.network(
"https://via.placeholder.com/288x188",
fit: BoxFit.fill,
);
},
itemCount: 10,
itemWidth: 300.0,
itemHeight: 400.0,
layout: SwiperLayout.TINDER,
)
copied to clipboard

Very easy to create you own custom animation:

Swiper(
layout: SwiperLayout.CUSTOM,
customLayoutOption: CustomLayoutOption(
startIndex: -1,
stateCount: 3
)..addRotate([
-45.0/180,
0.0,
45.0/180
])..addTranslate([
Offset(-370.0, -40.0),
Offset(0.0, 0.0),
Offset(370.0, -40.0)
]),
itemWidth: 300.0,
itemHeight: 200.0,
itemBuilder: (context, index) {
return Container(
color: Colors.grey,
child: Center(
child: Text("$index"),
),
);
},
itemCount: 10,
)

copied to clipboard
The CustomLayoutOption is designed to describe animations.
It is very easy to specify every state of items in Swiper.
CustomLayoutOption(
// Which index is the first item of array below
startIndex: -1,
// array length
stateCount: 3
)..addRotate([
// rotation of every item
-45.0/180,
0.0,
45.0/180
])..addTranslate([
// offset of every item
Offset(-370.0, -40.0),
Offset(0.0, 0.0),
Offset(370.0, -40.0)
]);

copied to clipboard
Codes #

ConstrainedBox(
child: Swiper(
outer:false,
itemBuilder: (c, i) {
return Wrap(
runSpacing: 6.0,
children: [0,1,2,3,4,5,6,7,8,9].map((i){
return SizedBox(
width: MediaQuery.of(context).size.width/5,
child: Column(
mainAxisSize: MainAxisSize.min,
children: <Widget>[
SizedBox(
child: Container(
child: Image.network("https://fuss10.elemecdn.com/c/db/d20d49e5029281b9b73db1c5ec6f9jpeg.jpeg%3FimageMogr/format/webp/thumbnail/!90x90r/gravity/Center/crop/90x90"),
),
height: MediaQuery.of(context).size.width * 0.12,
width: MediaQuery.of(context).size.width * 0.12,
),
Padding(padding: EdgeInsets.only(top:6.0),child: Text("$i"),)
],
),
);
}).toList(),
);
},
pagination: SwiperPagination(
margin: EdgeInsets.all(5.0)
),
itemCount: 10,
),
constraints:BoxConstraints.loose(Size(screenWidth, 170.0))
),

copied to clipboard
FAQs #
How to remove default controlls? #

Do not pass any value in control parameter of constructor

How to remove default pagination? #

Do not pass any value in pagination parameter of constructor


You can find all custom options here:

https://github.com/TheAnkurPanchani/flutter_swiper/blob/master/example/lib/src/ExampleCustom.dart