搜索插件、代码仓与 APP 分类

story_viewer 封面
插件详情v0.2.0

story_viewer

该包为任何 Flutter 应用提供常见的故事视图体验。

近 30 天下载
57
喜欢数
44
Pub 分数
50

安装插件

flutter pub add story_viewer

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

story_viewer 包使开发者能够轻松地将标准的故事浏览体验集成到其 Flutter 应用中。它提供了一个简洁、可定制的界面,用于以滑动格式显示顺序内容,如图片、视频或文字,这在社交媒体应用中很常见。该包设计时注重简单性和性能,支持基本的导航手势,如滑动和点击,并可根据各种应用设计进行定制。该包非常适合通过交互式故事功能提升用户参与度。

适合场景

  • 社交媒体故事动态
  • 用户资料亮点
  • 交互式教程
  • 产品展示幻灯片
  • 内容发现功能

主要特点

  • 可滑动的故事导航
  • 可自定义的 UI 组件
  • 支持图片和视频
  • 与 Flutter 的简单集成
  • 基于手势的交互

适合对象

  • 带有视觉叙事的移动应用
  • 需要用户参与的应用
  • 寻求快速故事实现的开发者
  • 社交网络平台
  • 教育或营销内容传递

使用建议

  • 仅限基本故事功能
  • 无内置分析跟踪
  • 需要手动处理故事数据
  • 未针对超长故事序列进行优化
  • 依赖外部资源提供内容

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

story_viewer

This package provides common story view experience for any Flutter app.

Features

  • Complate known gestures;
    • next story, previous story
    • hide UI layer on long press
  • Custom texts, icons, colors, paddings etc.
  • Easy to implement data model for story and story owner user.
  • Slide out page on vertical swipe down
  • Reply a story just like Instagram with text or emojis on vertical swipe up
  • **Display ratio for dynamic view inside any Widget.
  • Listener support with callbacks for story with StoryViewerController
    • played, paused, story index changed etc.
  • Customized additional layers support for under or on the media layer.
  • Blurred layer for possible inappropriate media

** Default and fully tested ratio is 9:16 with full screen.

Usage

This is common usage of story_viewer

StoryViewer(
    padding: EdgeInsets.all(8),
    backgroundColor: Colors.white,
    ratio: StoryRatio.r16_9,
    stories: [
        StoryItemModel(imageProvider: NetworkImage(imageURL)),
        StoryItemModel(imageProvider: MemoryImage(memoryImage)),
        StoryItemModel(imageProvider: AssetImage(assetName)),
    ],
    userModel: UserModel(
        username: username,
        profilePicture: NetworkImage(profileURL),
    ),
);

Custom controller example with event listeners

StoryViewerController controller = StoryViewerController();
controller.addListener(
    onPlayed: () {
        print("'onPlayed' callback outside of story_viewer");
    },
    onPaused: () {
        print("'onPaused' callback outside of story_viewer");
    },
);
return StoryViewer(
    viewerController: controller,
    .
    .

Check out example/lib/detailed_example.dart for more!

Dependencies

Package Name Type Description
extended_image Core Caching images, slide out page

所属分类

依赖

依赖清单 1 项

源码仓库

使用此插件的项目

暂无相关数据。