Flutter悬浮拖拽组件插件mek_floating_drag的使用

Flutter悬浮拖拽组件插件mek_floating_drag的使用

通过mek_floating_drag插件，你可以实现一个可以拖动的组件，并且在特定条件下可以被移除或者隐藏。

特性

• ✅ 可以拖到任何你想要的地方
• ✅ 按钮会吸附到容器边缘，弹跳效果
• ✅ 如果按钮释放时超出自然边缘，它会被吸回容器内
• ✅ 按钮会在一段时间后隐藏
• ✅ 如果不与按钮互动，或者与其他物体碰撞，按钮也会隐藏
• ✅ 你可以通过将按钮拖到指定区域（垃圾桶）来删除它
• ✅ 当按钮被释放到垃圾桶内时，它会缩小并居中对齐于垃圾桶中心
• ❌ 当按钮接近垃圾桶时，它会被吸引到垃圾桶

开始使用

首先，确保所有内容都包裹在一个FloatingZone内。

使用示例

定义可拖动的组件

final draggable = FloatingDraggable(
  controller: _dartController,
  naturalEdgesResolver: (containerSize, childSize) {
    return const EdgeInsets.symmetric(horizontal: double.nan, vertical: 16.0);
  },
  elasticEdgesResolver: (containerSize, childSize) {
    return const EdgeInsets.symmetric(horizontal: 16.0, vertical: double.nan);
  },
  retractEdgesResolver: (containerSize, childSize) {
    return EdgeInsets.symmetric(horizontal: -(0.60 * childSize.width), vertical: double.nan);
  },
  child: FloatingActionButton(
    onPressed: () {},
    child: const Icon(Icons.message),
  ),
);

定义一个目标区域

该目标区域用于删除可拖动组件。

const dragTargetBin = FloatingCircularDragBin();

将所有内容包裹在FloatingZone内

这是确保组件正确工作的必要步骤。也可以使用FloatingZone.inOverlay。

final result = FloatingZone.inStack(
  entries: [
    const Positioned(
      bottom: 16.0,
      right: 0.0,
      left: 0.0,
      child: dragTargetBin,
    ),
    Positioned(
      bottom: 16.0,
      right: 16.0,
      child: draggable,
    ),
  ],
  child: RestrictedFloatingZone(
    child: scaffold,
  ),
);

额外信息

如果你使用了RestrictedFloatingZone，则可以在用户按下RestrictedFloatingZone时隐藏可拖动组件。

完整示例代码

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

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

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      title: 'Mek Floating Drag',
      theme: ThemeData(
        primarySwatch: Colors.deepPurple,
      ),
      home: const MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key}) : super(key: key);

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> with TickerProviderStateMixin {
  late final _draggableController = FloatingDraggableController(vsync: this);

  [@override](/user/override)
  void dispose() {
    _draggableController.dispose();
    super.dispose();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    final scaffold = Scaffold(
      appBar: AppBar(
        title: const Text('Mek Floating Drag'),
        actions: [
          AnimatedBuilder(
            animation: _draggableController.visibilityAnimation,
            child: IconButton(
              onPressed: () => _draggableController.show(),
              icon: const Icon(Icons.add),
            ),
            builder: (context, child) {
              return Transform.scale(
                scale: 1 - _draggableController.visibilityAnimation.value,
                transformHitTests: false,
                child: child!,
              );
            },
          ),
        ],
      ),
      body: SingleChildScrollView(
        child: Column(
          children: Colors.primaries.reversed.map((color) {
            return Container(
              height: 100.0,
              color: color,
            );
          }).toList(),
        ),
      ),
    );

    const dragTargetBin = FloatingCircularDragBin();

    final draggable = FloatingDraggable(
      controller: _draggableController,
      naturalEdgesResolver: (containerSize, childSize) {
        return const EdgeInsets.symmetric(horizontal: double.nan, vertical: 16.0);
      },
      elasticEdgesResolver: (containerSize, childSize) {
        return const EdgeInsets.symmetric(horizontal: 16.0, vertical: double.nan);
      },
      retractEdgesResolver: (containerSize, childSize) {
        return EdgeInsets.symmetric(horizontal: -(0.60 * childSize.width), vertical: double.nan);
      },
      child: FloatingActionButton(
        onPressed: () => ScaffoldMessenger.of(context).showSnackBar(SnackBar(
          duration: const Duration(seconds: 1),
          content: Text('Tapped!'),
        )),
        child: const Icon(Icons.message),
      ),
    );

    final result = FloatingZone.inStack(
      entries: [
        const Positioned(
          bottom: 16.0,
          right: 0.0,
          left: 0.0,
          child: dragTargetBin,
        ),
        Positioned(
          bottom: 16.0,
          right: 16.0,
          child: draggable,
        ),
      ],
      child: RestrictedFloatingZone(
        child: scaffold,
      ),
    );

    return result;
  }
}