show_touches 0.1.0

Show finger touch effects for Flutter, with support for multiple fingers, controllers, custom widgets, and animations.

📓 Language: English | 中文

Show Touches

Show finger touch effects for Flutter!

Table of contents 🪄

• Features

• Install

  • Versions compatibility

  • Platforms compatibility

  • Add package

• Simple usage

  • ShowTouches

• Usage

  • ShowTouches widget parameters

  • PointerBuilder

  • ShowTouchesController

• Contributors

• License

Features ✨

• 👇 Multiple fingers (pointers)
• 🔧 Controller control
• ⚙️ Customizable pointer widgets and animations

Install 🎯

Versions compatibility 🐦

Flutter	3.3.0+
show_touches 0.0.1+	✅

Platforms compatibility 📱

Android	iOS	Web	macOS	Windows	Linux
✅	✅	✅	✅	✅	✅

Add package 📦

Run this command with Flutter,

$ flutter pub add show_touches

or add show_touches to pubspec.yaml dependencies manually.

dependencies:
  show_touches: ^latest_version

Simple usage 📖

Example: show_touches/example

ShowTouches 📦

ShowTouches widget will have default gesture logic and pointer widgets.

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

MaterialApp(
  builder: ShowTouches.init(),
  home: XxxPage(),
);

/// or

ShowTouches(child: XxxPage()),

Usage 📖

ShowTouches widget parameters 🤖

Parameter	Type	Default	Description
child required	Widget	-	-
enable	bool	true	true (enable) false (disable)
controller	ShowTouchesController?	null	ShowTouchesController to control the pointer.
pointerBuilder	PointerBuilder?	null	Custom pointer widget, but it will cause the defaultPointerStyle to be invalid.
defaultPointerStyle	DefaultPointerStyle	DefaultPointerStyle()	Default style for the pointer widget when pointerBuilder is not used.
showDuration	Duration	Duration(milliseconds: 50)	Show animation duration (pointer).
removeDuration	Duration	Duration(milliseconds: 200)	Remove animation duration (pointer).

PointerBuilder 📄

Example:

ShowTouches(
  pointerBuilder: (
    BuildContext context,
    int pointerId,
    Offset position,
    Animation<double> animation,
  ) {
    const double size = 60.0;
    return Positioned(
      left: position.dx - size / 2,
      top: position.dy - size / 2,
      child: IgnorePointer(
        child: RepaintBoundary(
          child: ScaleTransition(
            scale: animation.drive(Tween<double>(begin: 2.0, end: 1.0)),
            child: FadeTransition(
              opacity: animation,
              child: Container(
                width: size,
                height: size,
                color: Colors.black,
              ),
            ),
          ),
        ),
      ),
    );
  },
  child: XxxPage(),
),

Parameter	Type	Description
context	BuildContext	-
pointerId	int	Pointer (touch) ID.
position	Offset	Current touch position.
animation	Animation<double>	Animation controller.

ShowTouchesController 📄

You can use the controller to control the pointers in the ShowTouches widget,
or you can implement your own gesture logic to control the pointers.

Example:

final ShowTouchesController controller = ShowTouchesController();

......

@override
void dispose() {
  controller.dispose();
  super.dispose();
}

......

Listener(
  onPointerDown: (event) => controller.addPointer(...),
  onPointerMove: (event) => controller.updatePointer(...),
  onPointerUp: (event) => controller.removePointer(...),
  onPointerCancel: (event) => controller.removePointer(...),
  behavior: HitTestBehavior.translucent,
  child: child,
);

Get all pointer data

controller.data to get all the pointer data (Map<int, PointerData>).

Map<int, PointerData> -> key: pointerId, value: PointerData

PointerData

Parameter	Type	Description
pointerId	int	Pointer (touch) ID.
positionState	ValueNotifier<Offset>	Current touch position.
animationController	AnimationController	Animation controller.
pointerOverlayEntry	OverlayEntry?	Pointer OverlayEntry.

addPointer()

Parameter	Type	Default	Description
context required	BuildContext	-	-
pointerId required	int	-	Pointer (touch) ID.
position required	Offset	-	Current touch position.
animationController required	AnimationController	-	Animation controller.
pointerBuilder	PointerBuilder?	null	Custom pointer widget, but it will cause the defaultPointerStyle to be invalid.
defaultPointerStyle	DefaultPointerStyle	DefaultPointerStyle()	Default style for the pointer widget when pointerBuilder is not used.

updatePointer()

Parameter	Type	Default	Description
pointerId required	int	-	Pointer (touch) ID.
position required	Offset	-	Current touch position.

removePointer()

Parameter	Type	Default	Description
pointerId required	int	-	Pointer (touch) ID.
onRemoved	VoidCallback?	null	Called after the pointer and its animation are fully removed.

disposePointer()

Parameter	Type	Default	Description
pointerId required	int	-	Pointer (touch) ID.

Contributors ✨

AmosHuKe

License 📄

Open sourced under the MIT license.

© AmosHuKe