연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.
Flutter Page Transition Package
A Flutter package that provides beautiful page transitions with an easy-to-use API.
Installation
dependencies:
page_transition: ^latest_version
Usage
Using Extensions (Recommended)
context.pushTransition (
type: PageTransitionType .fade,
child: DetailScreen (),
);
context.pushTransition (
type: PageTransitionType .fade,
childBuilder: (context) => DetailScreen (
id: someId,
title: someTitle,
),
);
context.pushReplacementTransition (
type: PageTransitionType .rightToLeft,
child: DetailScreen (),
);
context.pushAndRemoveUntilTransition (
type: PageTransitionType .fade,
child: HomePage (),
predicate: (route) => false ,
);
context.pushNamedTransition (
routeName: '/detail' ,
type: PageTransitionType .fade,
arguments: {'id' : 1 },
);
Traditional Usage
Navigator .push (
context,
PageTransition (
type: PageTransitionType .fade,
child: DetailScreen (),
),
);
Navigator .push (
context,
PageTransition (
type: PageTransitionType .fade,
childBuilder: (context) => DetailScreen (id: someId),
),
);
Using with Route Generation (GoRouter, AutoRoute, etc.)
MaterialApp (
onGenerateRoute: (settings) {
switch (settings.name) {
case '/details' :
return PageTransition (
type: PageTransitionType .rightToLeftJoined,
childCurrent: context.currentRoute,
child: DetailsPage (),
settings: settings,
);
case '/shared-axis' :
return PageTransition (
type: PageTransitionType .rightToLeftJoined,
childCurrent: context.currentRoute,
child: SharedAxisPage (),
settings: settings,
curve: Curves .easeInOut,
duration: Duration (milliseconds: 400 ),
);
}
},
);
Using with GoRouter
final router = GoRouter (
routes: [
GoRoute (
path: '/details/:id' ,
pageBuilder: (context, state) {
return PageTransition (
type: PageTransitionType .rightToLeftJoined,
childCurrent: context.currentRoute,
child: DetailsPage (id: state.params['id' ]),
settings: RouteSettings (name: state.location),
);
},
),
],
);
Using with AutoRoute
First, define your routes:
@MaterialAutoRouter (
replaceInRouteName: 'Page,Route' ,
routes: <AutoRoute >[
AutoRoute (
page: HomePage ,
initial: true ,
),
CustomRoute (
page: DetailsPage ,
path: '/details/:id' ,
transitionsBuilder: (context, animation, secondaryAnimation, child) {
return PageTransition (
type: PageTransitionType .sharedAxisHorizontal,
child: child,
).buildTransitions (
context,
animation,
secondaryAnimation,
child,
);
},
),
CustomRoute (
page: ProfilePage ,
path: '/profile' ,
transitionsBuilder: (context, animation, secondaryAnimation, child) {
return PageTransition (
type: PageTransitionType .sharedAxisVertical,
child: child,
).buildTransitions (
context,
animation,
secondaryAnimation,
child,
);
},
),
],
)
class $AppRouter {}
Then use it in your app:
@override
Widget build (BuildContext context) {
return MaterialApp .router (
routerDelegate: _appRouter.delegate (),
routeInformationParser: _appRouter.defaultRouteParser (),
);
}
context.router.push (DetailsRoute (id: 123 ));
context.router.push (const ProfileRoute ());
Using with Navigation 2.0 (Router)
final router = GoRouter (
routes: [
GoRoute (
path: '/details/:id' ,
pageBuilder: (context, state) {
return PageTransition (
type: PageTransitionType .sharedAxisHorizontal,
child: DetailsPage (id: state.params['id' ]),
settings: RouteSettings (name: state.location),
);
},
),
],
);
Additional Features
iOS Swipe Back
Enable iOS-style swipe back gesture:
context.pushTransition (
type: PageTransitionType .rightToLeft,
child: DetailScreen (),
isIos: true ,
);
Note: iOS swipe back works only with rightToLeft and fade transitions.
Inherit Theme
Use the parent's theme in the transition:
context.pushTransition (
type: PageTransitionType .rightToLeft,
child: DetailScreen (),
inheritTheme: true ,
);
Custom Duration and Curve
context.pushTransition (
type: PageTransitionType .fade,
child: DetailScreen (),
duration: Duration (milliseconds: 300 ),
curve: Curves .easeInOut,
);
Advanced Usage
Shared Axis Transitions
Material Design 3 style shared axis transitions:
context.pushTransition (
type: PageTransitionType .sharedAxisHorizontal,
child: DetailScreen (),
duration: Duration (milliseconds: 400 ),
curve: Curves .easeInOut,
);
context.pushTransition (
type: PageTransitionType .sharedAxisVertical,
child: DetailScreen (),
);
context.pushTransition (
type: PageTransitionType .sharedAxisScale,
child: DetailScreen (),
);
Nested Navigation with Named Routes
MaterialApp (
onGenerateRoute: (settings) {
switch (settings.name) {
case '/details' :
return PageTransition (
type: PageTransitionType .sharedAxisHorizontal,
settings: settings,
child: DetailsPage (),
);
case '/profile/settings' :
return PageTransition (
type: PageTransitionType .sharedAxisVertical,
settings: settings,
child: SettingsPage (),
);
}
},
);
context.pushNamedTransition (
routeName: '/details' ,
type: PageTransitionType .sharedAxisHorizontal,
arguments: {'id' : 123 },
);
Using with GoRouter
final router = GoRouter (
routes: [
GoRoute (
path: '/details/:id' ,
pageBuilder: (context, state) {
return PageTransition (
type: PageTransitionType .rightToLeftJoined,
childCurrent: context.currentRoute,
child: DetailsPage (id: state.params['id' ]),
settings: RouteSettings (name: state.location),
);
},
),
],
);
Using with AutoRoute
final router = GoRouter (
routes: [
GoRoute (
path: '/details/:id' ,
pageBuilder: (context, state) {
return PageTransition (
type: PageTransitionType .rightToLeftJoined,
childCurrent: context.currentRoute,
child: DetailsPage (id: state.params['id' ]),
settings: RouteSettings (name: state.location),
);
},
),
],
);
Using with Navigation 2.0 (Router)
final router = GoRouter (
routes: [
GoRoute (
path: '/details/:id' ,
pageBuilder: (context, state) {
return PageTransition (
type: PageTransitionType .sharedAxisHorizontal,
child: DetailsPage (id: state.params['id' ]),
settings: RouteSettings (name: state.location),
);
},
),
],
);
Resources
Video Tutorial
Check out Johannes Milke's tutorial for a detailed walkthrough.
Contributing
Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.
License
BSD 2-Clause
Performance Tips
For optimal performance:
Keep transition durations short (200-300ms)
Use simpler curves like Curves.easeOut
Avoid complex transitions for frequent navigation
Consider using childBuilder for lazy widget construction
Use RepaintBoundary on heavy widgets being transitioned
context.pushTransition (
type: PageTransitionType .fade,
duration: Duration (milliseconds: 200 ),
curve: Curves .easeOut,
child: RepaintBoundary (
child: HeavyWidget (),
),
);