パッケージ、リポジトリ、アプリカテゴリを検索

pinch_zoom_release_unzoom のカバー
パッケージ詳細v2.0.0

pinch_zoom_release_unzoom

ピンチでズームできるウィジェットで、ピンチ操作が終了すると元のサイズに戻ります。Instagramで写真を拡大する方法に非常に似ています。

AndroidiOSWebmacOSWindowsLinux
30日間ダウンロード
4150
いいね数
65
Pub ポイント
160

パッケージをインストール

flutter pub add pinch_zoom_release_unzoom

パッケージ概要

公開情報に基づく選定ガイドです。参考としてご利用ください。

ピンチでズームできる機能を有効にするFlutterウィジェットで、ジェスチャー終了後に自動的に元のサイズに戻り、Instagramの画像ズーム動作を模倣します。画像やコンテンツが拡大されたまま残ってはならない場合に最適な滑らかで一時的なズーム効果を提供します。Android、iOS、Web、macOS、Windows、Linuxなどすべての主要プラットフォームをサポートしており、クロスプラットフォームアプリケーションに非常に柔軟です。軽量で、最小限の設定で簡単に統合できます。

用途

  • 一時的なズームを使用した画像表示
  • 動的スケーリングを備えたインタラクティブなUI要素
  • クロスプラットフォームベースのジェスチャーによるコンテンツ探索
  • 写真ギャラリーにおけるユーザー体験の向上
  • 持続的なスケーリングなしのシンプルなズーム効果

主な機能

  • ピンチ後の元のサイズへの自動戻り
  • ズームおよびアンズーム中のスムーズなアニメーション
  • すべての主要なFlutterプラットフォームをサポートしています
  • 最小限のセットアップが必要
  • 直感的なジェスチャー認識

適している対象

  • 画像中心のアプリを開発する開発者
  • 一時的なズーム操作を必要とするアプリ
  • Instagram風のジェスチャーを実現するプロジェクト
  • 直感的なタッチフィードバックを求めるUIデザイナー
  • ジェスチャーが必要なクロスプラットフォームアプリケーション

注意事項

  • 恒久的なズーム状態には適していません
  • ズーム動作のカスタマイズが限定的
  • 複雑なレイアウトに対応するための追加処理が必要になる場合があります
  • 静的またはスクロールしないコンテンツと併用するのが最適です
  • 大または高解像度の画像ではパフォーマンスが異なる場合があります

元の README

関連するソースリポジトリの README 原文のスナップショットです。最新の内容はリポジトリをご覧ください。

pub package popularity likes pub points

This package helps to create an instagram like zoom picture. With pinch to zoom and release to unzoom

In this video I explained how to use pinch to zoom, in a flutter project

https://youtu.be/V2DglEpynF8

Zoom_demo

Features

Let's your app show zoomable images in an user friendly way.

It's a container of an uncliped interactive viewer that let's the user zoom the image occupying the entire screen. Once you release the screen and stop the pinch interaction the image/widget will come back to it's original size in an smooth animation.

Getting started

Add the dependency to your pubspec.yaml:

pinch_zoom_release_unzoom: ^1.0.1

Usage


PinchZoomReleaseUnzoomWidget(
  child: Image.network(
    'https://storage.googleapis.com/cms-storage-bucket/70760bf1e88b184bb1bc.png'
  ),
)

Additional information

This package also support some extra params that may be useful depending on what are you trying to achieve

PinchZoomReleaseUnzoomWidget(
    child: Image.network('https://storage.googleapis.com/cms-storage-bucket/70760bf1e88b184bb1bc.png'),
    minScale: 0.8,
    maxScale: 4,
    resetDuration: const Duration(milliseconds: 200),
    boundaryMargin: const EdgeInsets.only(bottom: 0),
    clipBehavior: Clip.none,
    useOverlay: true,
    maxOverlayOpacity: 0.5,
    overlayColor: Colors.black,
    fingersRequiredToPinch: 2
)

Making it work well inside a scroll

I made a video explaining how to solve the pinch to zoom inside a scroll:

https://youtu.be/FUuCOdQerpw

The problem with making a pinch working inside a scroll is that the drag of a screen, as a simple gesture that can be done with just one finger, tends to override the more complex scale gesture that needs two fingers to work well, the best way I found to overcome that challenge is to change the physics of the scroll to NeverScrollableScrollPhysics() when the second finger touch the screen, that way the scroll stops to override the scale gesture and it's easy to interact with the interactive viewer.

Another consideration that you will need to have is that to avoid losing frames of the reset animation, you need to delay the setState that will bring the scroll back to the parent widget

So the scroll build will look like this:

  bool blockScroll = false;
ScrollController controller = ScrollController();

@override
Widget build(BuildContext context) {
  return SingleChildScrollView(
      controller: controller,
      physics: blockScroll ? NeverScrollableScrollPhysics() : ScrollPhysics(),

And the PinchWidget will have this two extra parameters:

twoFingersOn: () => setState(() => blockScroll = true),
twoFingersOff: () => Future.delayed(
PinchZoomReleaseUnzoomWidget.defaultResetDuration,
() => setState(() => blockScroll = false),

For a complete widget example check this one:

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

  @override
  State<TestSimpleScroll> createState() => _TestSimpleScrollState();
}

class _TestSimpleScrollState extends State<TestSimpleScroll> {
  bool blockScroll = false;
  ScrollController controller = ScrollController();

  @override
  Widget build(BuildContext context) {
    return SingleChildScrollView(
      controller: controller,
      physics: blockScroll ? NeverScrollableScrollPhysics() : ScrollPhysics(),
      child: SizedBox(
        width: MediaQuery.of(context).size.width,
        child: Container(
          padding: const EdgeInsets.all(20),
          child: Column(
            children: [
              SizedBox(
                width: 300,
                height: 250,
                child: PinchZoomReleaseUnzoomWidget(
                  child: Image.network(
                    'https://www.animalfriends.co.uk/siteassets/media/images/article-images/cat-articles/38_afi_article1_caring-for-a-kitten-tips-for-the-first-month.png',
                  ),
                  twoFingersOn: () => setState(() => blockScroll = true),
                  twoFingersOff: () => Future.delayed(
                    PinchZoomReleaseUnzoomWidget.defaultResetDuration,
                        () => setState(() => blockScroll = false),
                  ),
                ),
              ),
              const SizedBox(
                height: 5000,
              )
            ],
          ),
        ),
      ),
    );
  }
}

Simulator test

To test in a simulator add a fingersRequiredToPinch to pinch with a -1 to disable the requirement of two fingers to start an interaction

PinchZoomReleaseUnzoomWidget(
    child: Image.network('https://storage.googleapis.com/cms-storage-bucket/70760bf1e88b184bb1bc.png'),
    fingersRequiredToPinch: -1
)

Like us on pub.dev

Package url: https://pub.dev/packages/pinch_zoom_release_unzoom

カテゴリー

ソースリポジトリ

このパッケージを使用しているプロジェクト

データはまだありません。