Flutter图片缩放与手势操作插件zoom_hover_pinch_image的使用

Features

zoom_hover_pinch_image 是一个用于Flutter应用中实现图片缩放和手势操作的强大插件。它提供了多种自定义属性，以满足不同的交互需求：

• Zoom功能：支持对子组件进行双指缩放。
• 圆角自定义：可以指定圆角半径，以便裁剪子组件。
• 宽高比自定义：可以指定组件的宽高比。
• 最小和最大缩放限制：设置允许的最小和最大的缩放级别。
• 裁剪行为：确定是否应该对子组件应用裁剪行为。

通过定制这些属性，您可以控制缩放级别、宽高比、裁剪行为和缩放限制，从而根据具体要求定制交互体验。

示例代码片段

Zoom(
  child: Image.network("https://i.pravatar.cc/300"),
  clipBehavior: false,
),

Zoom(
  child: Image.network("https://i.pravatar.cc/300"),
  clipBehavior: true,
),

Zoom.pinch(
  child: Image.network("https://i.pravatar.cc/300"),
  clipBehavior: false,
  borderRadius: BorderRadius.circular(8.0),
),

Zoom.hover(
  child: Image.network("https://i.pravatar.cc/300"),
  zoomedScale: 3.0
),

Zoom.hoverMouseRegion(
  child: Image.network("https://i.pravatar.cc/300"),
  zoomedScale: 3.0
),

Zoom.zoomOnTap(
  child: Image.network("https://i.pravatar.cc/300"),
  zoomedScale: 3.0,
  clipBehavior: true,
),

Zoom.zoomOnTap(
  child: Image.network("https://i.pravatar.cc/300"),
  zoomedScale: 3.0,
  clipBehavior: false,
),

Zoom.zoomOnTap(
  child: Image.network("https://i.pravatar.cc/300"),
  zoomedScale: 3.0,
  clipBehavior: true,
  oneTapZoom: true,
  doubleTapZoom: false,
),

Getting Started

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

dependencies:
  zoom_hover_pinch_image: ^1.0.3

然后导入包：

import 'package:zoom_hover_pinch_image/zoom_hover_pinch_image.dart';

How to use

下面是一个完整的示例demo，展示了如何在Flutter应用程序中使用此插件：

import 'package:flutter/material.dart';
import 'package:zoom_hover_pinch_image/zoom_hover_pinch_image.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(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key});

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

class _MyHomePageState extends State<MyHomePage> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: const Text('Flutter Demo Home Page'),
      ),
      body: SingleChildScrollView(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.spaceBetween,
          children: <Widget>[
            const SizedBox(height: 10),
            SizedBox(
              child: Zoom(
                child: Image.network('https://picsum.photos/200/300'),
              ),
            ),
            const SizedBox(height: 10),
            Zoom.hover(child: Image.network('https://picsum.photos/200/300')),
            const SizedBox(height: 10),
            Zoom.hoverMouseRegion(
                child: Image.network('https://picsum.photos/200/300')),
            const SizedBox(height: 10),
            Zoom.pinch(child: Image.network('https://picsum.photos/200/300')),
            const SizedBox(height: 10),
            Zoom.zoomOnTap(
                child: Image.network('https://picsum.photos/200/300')),
          ],
        ),
      ),
    );
  }
}

Additional Information

如果您有任何问题或建议，请随时联系开发者：swan.dev1993@gmail.com。

更多关于此插件的信息可以在其GitHub仓库找到。欢迎贡献代码并提出问题或错误报告。感谢您使用我们的插件！