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

插件详情v0.1.4

sliver_catalog

Flutter 的一组实验性和创意性滑动条。

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
29
喜欢数
47
Pub 分数
150

安装插件

flutter pub add sliver_catalog

插件介绍

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

sliver_catalog 是一个 Flutter 包,提供经过精心挑选的实验性和创意性滑块,旨在增强可滚动界面。专为寻求独特且视觉上引人入胜的滚动体验的开发者设计,它扩展了 Flutter 内置的滑块组件,提供了创新的布局和行为。适用于原型设计或为具有复杂滚动交互的应用增添亮点,该包支持所有主要平台,包括移动、Web 和桌面。其模块化设计使其能够轻松集成到现有的滚动视图中。

适合场景

  • 创建动态可滚动的用户界面
  • 原型设计高级滚动效果
  • 提升应用程序的视觉吸引力
  • 构建自定义滚动布局
  • 添加实验性滑块行为

主要特点

  • 实验性滑动小部件
  • 创意滚动设计
  • 跨平台支持
  • 模块化且可扩展
  • 与 ScrollView 的轻松集成

适合对象

  • Flutter 开发人员探索滚动效果
  • 想要独特用户界面组件的设计师
  • 寻求视觉创新的应用程序构建者
  • 原型设计人员测试新的滚动模式
  • 构建沉浸式滚动体验的团队

使用建议

  • 最适合实验性项目
  • 可能需要额外的样式
  • 不建议用于生产环境稳定性
  • 有限的文档
  • 复杂布局可能带来的性能影响

原始 README

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

Sliver Catalog Logo

Owner Pub Version Pub points Pub Likes Downloads Coverage Status Contributors License


What this library is

A collection of experimental and creative slivers for Flutter. Extend your scrolling experience beyond the basics.

Gallery

ScrollHijackSliver demo SpinnerSliver demo GliderSliver demo FreezeSliver demo BloodSliver demo

Demo

Current release Latest Demo

Overview

Sliver Catalog provides a set of advanced and experimental slivers for Flutter, enabling developers to create unique, visually engaging scroll effects. The package includes basic slivers as a platform for creating effects and specific implementations that provide ready-to-use effects.

Basics
  • ScrollHijackSliver: A sliver that consumes a specified amount of scrollable space before allowing its child to start scrolling.
  • LeavingViewportShaderSliver: Applies a shader on top of the child while it leaves the viewport.
  • LeavingViewportTransformedRenderSliver: A render object that applies a transformation to the child while it leaves the viewport.
Ready-to-use effects
  • SpinnerSliver: Rotates its child as it leaves the viewport, with configurable anchor and angle.
  • GliderSliver: Smoothly shifts the child in and out of the viewport.
  • FreezeSliver: Applies a freezing effect to the child while it leaves the viewport.
  • BloodSliver: Applies a blood covering effect to the child while it leaves the viewport.

Explore the library

ScrollHijackSliver

A sliver that consumes a specified amount of scrollable space before allowing its child to start scrolling. This is useful for creating custom scroll-driven animations and effects.

Key features:

  • Exposes a ValueListenable<double> progress (0.0–1.0) to the builder, so you can animate your child based on the progress.
  • Supports different progress calculation behaviors via ScrollHijackProgressBehavior.

Example:

CustomScrollView(
  slivers: [
    ScrollHijackSliver(
      consumingSpaceSize: 800,
      builder: (context, consumingProgress) {
        return Container(
          color: Colors.grey,
          height: 300,
          child: ValueListenableBuilder(
            valueListenable: consumingProgress,
            builder: (context, value, child) {
              return CustomPaint(
                painter: MyCustomPainter(progress: value),
              );
            },
          ),
        );
      },
    ),
    // ... other slivers ...
  ],
)

LeavingViewportShaderSliver

A sliver that applies a fragment shader effect to its child as it leaves the viewport. This enables advanced visual effects as the user scrolls.

Key features:

  • Can operate with a raw FragmentShader that uses a specific order of arguments (size, offset, progress), or with a custom shader wrapper for any uniform order via the LeavingViewportShader interface.
  • The shader receives the child's size, paint offset, and a progress value (0.0–1.0) indicating how much the child has left the viewport.

Example:

CustomScrollView(
  slivers: [
    // Using a raw FragmentShader (default uniform order)
    LeavingViewportShaderSliver.fromFragmentShader(
      shader: myFragmentShader,
      child: Image.network('https://...'),
    ),
    // Using a custom wrapper for arbitrary uniform order
    LeavingViewportShaderSliver(
      shader: MyCustomLeavingViewportShader(),
      child: Image.network('https://...'),
    ),
    // ... other slivers ...
  ],
)

There are also two built-in inheritances of LeavingViewportShaderSliver:

FreezeSliver

A sliver that applies a "freezing" shader effect to its child as it leaves the viewport. This effect is built-in and requires no manual shader setup.

Key features:

  • Uses a predefined freezing shader bundled with the package.
  • No shader code required—just wrap a content with the sliver.

Example:

CustomScrollView(
  slivers: [
    FreezeSliver(
      child: Image.network('https://...'),
    ),
    // ... other slivers ...
  ],
)
BloodSliver

A sliver that applies a "blood covering" shader effect to its child as it leaves the viewport. This effect is built-in and requires no manual shader setup.

Key features:

  • Uses a predefined blood shader bundled with the package.
  • No shader code required—just wrap a content with the sliver.

Example:

CustomScrollView(
  slivers: [
    BloodSliver(
      child: Image.network('https://...'),
    ),
    // ... other slivers ...
  ],
)

LeavingViewportTransformedRenderSliver

A base render sliver for creating scroll-driven 3D or 2D transformations as a child leaves the viewport. This class is intended for advanced use, enabling you to define custom transformation effects (such as rotation, scaling, skewing, etc.) based on scroll progress.

Key features:

  • Exposes a performTransform method to define any transformation matrix based on child size and leaving progress.
  • Handles all the layout, painting, and hit testing logic for you.
  • Allows to define a custom hit testing logic if it is necessary.

Usage: To create a custom effect, extend LeavingViewportTransformedRenderSliver and implement performTransform.

Example:

class MyCustomTransformedSliver extends SingleChildRenderObjectWidget {
  const MyCustomTransformedSliver({super.key, required super.child});

  @override
  RenderObject createRenderObject(BuildContext context) =>
      _MyCustomTransformedRenderSliver();
}

class _MyCustomTransformedRenderSliver extends LeavingViewportTransformedRenderSliver {
  @override
  Matrix4? performTransform(Size childSize, double progress) {
    // Scale pulsation: scale oscillates as the child leaves the viewport
    final double scale = 1.0 - 0.2 * (math.sin(progress * math.pi * 4)).abs();
    final Matrix4 matrix = Matrix4.identity();
    matrix.translate(childSize.width / 2, childSize.height / 2);
    matrix.scale(scale, scale);
    matrix.translate(-childSize.width / 2, -childSize.height / 2);
    return matrix;
  }
}

There are also two built-in inheritances of LeavingViewportTransformedRenderSliver:

SpinnerSliver

A sliver that rotates its child as it leaves the viewport. The rotation is anchored to a configurable side and the maximum angle can be customized.

Key features:

  • Rotates the child around a specified anchor (left or right).
  • Configurable maximum rotation angle.

Example:

CustomScrollView(
  slivers: [
    SpinnerSliver(
      anchorSide: SpinnerAnchorSide.left, // or SpinnerAnchorSide.right
      maxAngle: math.pi / 2, // 90 degrees
      child: Image.network('https://...'),
    ),
    // ... other slivers ...
  ],
)
GliderSliver

A sliver that smoothly slides its child left or right as it leaves the viewport, creating a gliding effect.

Key features:

  • Shifts the child along the cross axis based on scroll progress.
  • Configurable exit side (left or right).

Example:

CustomScrollView(
  slivers: [
    GliderSliver(
      exitSide: GliderExitSide.left, // or GliderExitSide.right
      child: Image.network('https://...'),
    ),
    // ... other slivers ...
  ],
)

Maintainer

Maintainer avatar

Mikhail Zotyev

Support

We appreciate any form of support, whether it's a financial donation, a public sharing, or a star on GitHub and a like on Pub. If you want to provide financial support, there are several ways you can do it:

Thank you for all your support!

License

This project is licensed under the MIT License. See LICENSE for details.

所属分类

源码仓库

使用此插件的项目

暂无相关数据。