s_bounceable #

A Flutter package providing a bounceable widget with intelligent single and double tap detection, built on top of flutter_bounceable.

Features #

✨ Smooth Bounce Animation - Provides satisfying visual feedback using scale animations

👆 Smart Tap Detection - Intelligently distinguishes between single and double taps

⚙️ Customizable - Configure scale factor to match your design requirements

🎯 Easy to Use - Simple API that wraps any Flutter widget

🧪 Well Tested - Comprehensive test coverage for reliable behavior

Demo #

Installation #

Add this to your package's pubspec.yaml file:

dependencies:
  s_bounceable: ^2.0.0

Then run:

flutter pub get

Usage #

Basic Example #

Import the package:

import 'package:s_bounceable/s_bounceable.dart';

Wrap any widget with SBounceable:

SBounceable(
  onTap: () {
    debugPrint('Single tap!');
  },
  onDoubleTap: () {
    debugPrint('Double tap!');
  },
  child: Container(
    padding: const EdgeInsets.all(24.0),
    decoration: BoxDecoration(
      color: Colors.blue,
      borderRadius: BorderRadius.circular(12),
    ),
    child: const Text(
      'Tap or Double Tap Me',
      style: TextStyle(color: Colors.white, fontSize: 18),
    ),
  ),
)

Custom Scale Factor #

Adjust the bounce intensity:

SBounceable(
  onTap: () => print('Tapped'),
  scaleFactor: 0.90, // More pronounced bounce (default is 0.95)
  child: YourWidget(),
)

Single Tap Only #

SBounceable(
  onTap: () => print('Tapped'),
  child: YourWidget(),
)

Double Tap Only #

SBounceable(
  onDoubleTap: () => print('Double tapped'),
  child: YourWidget(),
)

Complete Example #

See the full working example in the example directory:

import 'package:flutter/material.dart';
import 'package:s_bounceable/s_bounceable.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('SBounceable Example')),
        body: Center(
          child: SBounceable(
            onTap: () {
              debugPrint('Single tap!');
            },
            onDoubleTap: () {
              debugPrint('Double tap!');
            },
            child: Container(
              padding: const EdgeInsets.all(24.0),
              decoration: BoxDecoration(
                color: Colors.blue,
                borderRadius: BorderRadius.circular(12),
              ),
              child: const Text(
                'Tap or Double Tap Me',
                style: TextStyle(color: Colors.white, fontSize: 18),
              ),
            ),
          ),
        ),
      ),
    );
  }
}

How It Works #

The SBounceable widget uses a smart tap detection algorithm:

• Double Tap Threshold: 300ms window to detect double taps
• Single Tap Delay: Waits for the threshold period before executing single tap to avoid false triggers
• Triple Tap Prevention: Resets state after double tap to prevent unintended triple taps

API Reference #

SBounceable #

Dependencies #

This package depends on:

• flutter_bounceable ^1.2.0 - For the underlying bounce animation

Contributing #

Contributions are welcome! Please feel free to submit a Pull Request.

License #

This project is licensed under the MIT License - see the LICENSE file for details.

Author #

Christophe Chanteur

Repository #

https://github.com/SoundSliced/s_bounceable

Issues #

Please file issues at: https://github.com/SoundSliced/s_bounceable/issues