Flutter滑动操作增强插件swipe_plus的使用

插件简介

Swipe Plus 是一个用于创建消息拖拽效果的Flutter插件。它可以帮助开发者轻松实现类似iOS消息应用中的左右滑动手势，为用户提供更加流畅和直观的交互体验。

安装

在您的 pubspec.yaml 文件中添加以下依赖项：

dependencies:
  swipe_plus:
    git:
      url: https://github.com/DK070202/drag_and_swipe.git
      ref: master

然后运行 flutter pub get 来安装插件。

使用方法

要使用 SwipePlus，只需将需要滑动效果的组件包裹在 SwipePlus 内，并提供 onDragComplete 和/或 onDragCancel 回调函数。

示例代码

下面是一个完整的示例程序，展示了如何使用 SwipePlus 实现消息列表中的滑动删除功能：

import 'dart:math';

import 'package:faker/faker.dart';
import 'package:flutter/material.dart';
import 'package:swipe_plus/swipe_plus.dart';

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

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        useMaterial3: true,
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Drag And Swipe'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: const Color(0xffFFFBFE),
        elevation: 10,
        title: Text(widget.title),
      ),
      body: ListView.builder(
        padding: const EdgeInsets.symmetric(vertical: 16),
        itemBuilder: (context, index) => MessageWidget(
          textMessage: faker.lorem.sentence(),
        ),
      ),
    );
  }
}

class MessageWidget extends StatelessWidget {
  const MessageWidget({
    super.key,
    required this.textMessage,
  });
  final String textMessage;

  void showSnackBar(BuildContext context, String message) {
    ScaffoldMessenger.of(context).showSnackBar(SnackBar(
      content: Text('Reply to $textMessage'),
      behavior: SnackBarBehavior.floating,
    ));
  }

  @override
  Widget build(BuildContext context) {
    final size = MediaQuery.of(context).size;
    final x = Random().nextBool();
    return SwipePlus(
      onDragComplete: () => showSnackBar(context, textMessage),
      maxTranslation: .3,
      minThreshold: .50,
      alignment: x ? Alignment.centerRight : Alignment.centerLeft,
      child: ConstrainedBox(
        constraints: BoxConstraints(
          maxWidth: size.width * .60,
        ),
        child: Container(
          margin: const EdgeInsets.symmetric(vertical: 5, horizontal: 10),
          padding: const EdgeInsets.all(10),
          decoration: BoxDecoration(
            color: const Color(0xffFFD8E4),
            borderRadius: BorderRadius.circular(12),
          ),
          child: Text(
            textMessage,
            style: const TextStyle(color: Color(0xff31111D)),
          ),
        ),
      ),
    );
  }
}

配置选项

SwipePlus 提供了多个配置选项来满足不同的需求：

1. onDragComplete：当水平拖动超过最小阈值时触发。

   final VoidCallback? onDragComplete;
   

2. onDragCancel：当用户取消拖动时触发。

   final VoidCallback? onDragCancel;
   

3. alignment：设置子组件的对齐方式。

   final Alignment alignment;
   

4. dragDirection：决定拖动方向（从右到左或从左到右）。

   final DragDirection dragDirection;
   

5. maxTranslation：最大平移距离，以子组件宽度的百分比表示。

   final double maxTranslation;
   

6. reverseDuration：如果未完成拖动，则回弹动画的持续时间。

   final Duration reverseDuration;
   

7. minThreshold：定义触发 onDragComplete 的最小阈值，同样以宽度百分比表示。

   final double minThreshold;
   

通过这些配置选项，您可以灵活地调整滑动手势的行为，使其更好地适应应用程序的需求。