flutter_tilt 0.0.1-dev.1 copy "flutter_tilt: ^0.0.1-dev.1" to clipboard
flutter_tilt: ^0.0.1-dev.1 copied to clipboard

Easily apply tilt parallax hover effects on Flutter!

Language: English | 中文


Flutter Tilt

package package MIT License

Easily Apply Tilt Parallax Hover Effects on Flutter!



Table of contents 🪄 #


Features ✨ #

  • 📦 Tilt effect
  • 🔦 Light effect
  • 💡 Shadow effect
  • 👀 Parallax effect
  • 👇 Supports mouse and touch events
  • 🖼️ Smooth animation
  • ⚙️ Many custom parameters

TODO 💡 #

  • Sensors
  • Tilt data callback
  • Tilt controller

Install 🎯 #

Versions compatibility 🐦 #

3.0.x 3.3.x 3.10.x
0.0.1+

Add package 📦 #

Run this command with Flutter,

$ flutter pub add flutter_tilt

or add flutter_tilt to pubspec.yaml dependencies manually.

dependencies:
  flutter_tilt: ^latest_version

Usage 📖 #

Example: flutter_tilt/example

Simple usage: Tilt 📦 #

Tilt widget will have default tilt, shadow, and light effects.

/// Import flutter_tilt
import 'package:flutter_tilt/flutter_tilt.dart';

...
Tilt(
  child: Container(
    width: 150.0,
    height: 300.0,
    color: Colors.grey,
  ),
),
... 

Tilt widget parameters

Parameter Type Default Description
child required Widget - Create a widget that its child widget can be tilted.
childInner List<Widget> <Widget>[] As with Stack, you can use the Stack layout to create widgets that are above the child.
e.g. parallax effects.
disable bool false Disable all effects.
fps int 60 Gesture triggered frames.
borderRadius BorderRadiusGeometry? null If non-null, the corners of this box are rounded by this BorderRadius.
clipBehavior Clip Clip.antiAlias Flutter clipBehavior.
tiltConfig TiltConfig TiltConfig() Tilt effect config.
lightConfig LightConfig LightConfig() Light effect config.
shadowConfig ShadowConfig ShadowConfig() Shadow effect config.
TiltConfig
Parameter Type Default Description
disable bool false Only disable the tilt effect.
initial Offset? null Initial tilt progress, range (x, y): (1, 1) to (-1, -1),
you can exceed the range, but the maximum tilt angle during gesture movement is always tilted according to [TiltConfig.angle].
e.g. (0.0, 0.0) center
(1.0, 1.0) Maximum tilt top left [TiltConfig.angle].
angle double 10.0 Maximum tilt angle.
e.g. 180 will flip.
direction List<TiltDirection>? null Tilt Direction, multiple directions, customized direction values.
enableRevert bool true Enable Tilt Revert, will revert to the initial state.
enableReverse bool false Tilt reverse, can be tilted up or down.
enableOutsideAreaMove bool true Tilt can continue to be triggered outside the area.
(only when the pointer is pressed and moved)
enableMouseHover bool true Mouse hover to trigger tilt.
filterQuality FilterQuality FilterQuality.high Flutter FilterQuality.
LightConfig
Parameter Type Default Description
disable bool false Only disable the light effect.
color Color Color(0xFFFFFFFF) Light color.
minIntensity double 0.0 Color minimum opacity, also initial opacity.
maxIntensity double 0.5 Color maximum opacity for tilt progresses.
direction LightDirection LightDirection.around Light direction.
Affects:
[ShadowConfig.direction] (not affected after configuration).
enableReverse bool false Reverse light direction.
Affects:
[ShadowConfig.direction] (not affected after configuration).
[ShadowConfig.enableReverse] (not affected after configuration).
ShadowConfig
Parameter Type Default Description
disable bool false Only disable the shadow effect.
color Color Color(0xFF9E9E9E) Shadow color.
minIntensity double 0.0 Color minimum opacity, also initial opacity.
maxIntensity double 0.5 Color maximum opacity as tilt progresses.
offsetInitial Offset Offset(0.0, 0.0) Initial value of shadow offset (pixel).
e.g. (0.0, 0.0) center.
(40.0, 40.0) Offset 40 pixels to the top left.
offsetFactor double 0.1 Shadow offset factor, relative to current widget size.
spreadInitial double 0.0 Initial value of shadow spread radius (pixel).
spreadFactor double 0.0 Shadow spread radius factor, relative to current widget size.
minBlurRadius double 10.0 Minimum blur radius, also initial blur radius.
maxBlurRadius double 20.0 Maximum blur radius for tilt progresses.
direction ShadowDirection? null Shadow direction.
enableReverse bool? null Reverse shadow direction.

Simple usage: Parallax 👀 #

TiltParallax widget can only be used in the childInner of Tilt widget.
childInner is the same as Stack widget.

/// Import flutter_tilt
import 'package:flutter_tilt/flutter_tilt.dart';

...
Tilt(
  childInner: const [
    /// Parallax here
    Positioned.fill(
      child: Center(
        child: TiltParallax(
          child: Text('Parallax'),
        ),
      ),
    ),
    /// Parallax here
    Positioned.fill(
      top: 20.0,
      left: 20.0,
      child: TiltParallax(
        size: Offset(-10.0, -10.0),
        child: Text('Tilt'),
      ),
    ),
  ],
  child: Container(
    width: 150.0,
    height: 300.0,
    color: Colors.brown,
  ),
),
... 

TiltParallax widget parameters

Parameter Type Default Description
child required Widget - Create a widget with parallax.
size Offset Offset(10.0, 10.0) Parallax size (pixel).
filterQuality FilterQuality FilterQuality.high Flutter FilterQuality.

License 📄 #

MIT License
Open sourced under the MIT license.

© AmosHuKe

136
likes
0
pub points
89%
popularity

Publisher

verified publisheramoshk.top

Easily apply tilt parallax hover effects on Flutter!

Repository (GitHub)
View/report issues

License

unknown (LICENSE)

Dependencies

flutter

More

Packages that depend on flutter_tilt