StoryView는 WhatsApp 및 인스타그램과 유사한 상호작용형 스와이프 가능한 스토리를 표시할 수 있도록 해주는 플러터 패키지입니다. 리스트나 컬럼 내부에 직접 통합할 수 있어 뉴스 피드나 소셜 미디어 앱에 이상적입니다. 패키지에는 스토리 페이지를 일시정지, 다음으로 넘기고 이동하는 등의 내장 제스처가 포함되어 있습니다. 다양한 플랫폼에서 원활한 성능을 위해 설계되었으며, 안드로이드, iOS, macOS에서 원활하게 작동합니다. pub add를 통해 최소한의 설정만으로도 사용자 정의 가능한 컨트롤과 애니메이션을 갖춘 네이티브처럼 느껴지는 스토리텔링 경험을 제공합니다.
This a Flutter widget to display stories just like Whatsapp and Instagram. Can also be used
inline/inside ListView or Column just like Google News app. Comes with gestures
to pause, forward and go to previous page.
Features
🕹 Still image, GIF and video support (with caching enabled)
📍 Gesture for pause, rewind and forward
⚜️ Caption for each story item
🎈 Animated progress indicator for each story item
📱 Fullscreen or inline
And useful callback to perform meta functionalities including vertical swipe gestures.
Look inside examples/example.dart on how to use this library. You can copy
and paste the code into your main.dart and run to have a quick look.
Basics
Use StoryView to add stories to screen or view heirarchy. StoryView requires a list of StoryItem, each of which describes the view to be displayed on each story page, duration and so forth. This gives you the freedom to customize each page of the story.
There are shorthands provided to create common pages.
StoryItem.text is a shorthand to create a story page that displays only text.
StoryItem.pageImage creates a story item to display images with a caption.
StoryItem.inlineImage creates a story item that is intended to be displayed in a linear view hierarchy like List
or Column
🍭 Both .inlineImage and pageImage support animated GIFs.
StoryItem.pageVideo creates a page story item with video media. Just provide your video url and get going.
Story controller, loaders and GIF support
While images load, it'll be a better experience to pause the stories until it's done. To achieve this effect, create a global instance of StoryController and use the shorthand StoryItem.pageImage or StoryItem.inlineImage while passing the same controller instance to it.
...
final controller = StoryController();
@overrideWidgetbuild(context) {
List<StoryItem> storyItems = [
StoryItem.text(...),
StoryItem.pageImage(...),
StoryItem.pageImage(...),
StoryItem.pageVideo(
...,
controller: controller,
)
]; // your list of storiesreturnStoryView(
storyItems,
controller: controller, // pass controller here too
repeat: true, // should the stories be slid forever
onStoryShow: (s) {notifyServer(s)},
onComplete: () {},
onVerticalSwipeComplete: (direction) {
if (direction == Direction.down) {
Navigator.pop(context);
}
} // To disable vertical swipe gestures, ignore this parameter.// Preferrably for inline story view.
)
}