Pakete, Repositories und App-Kategorien suchen

Cover von pinch_zoom_release_unzoom
Paketdetailsv2.0.0

pinch_zoom_release_unzoom

Ein Widget, mit dem Sie einen Zoom per Daumen und Zeigefinger durchführen können, der nach Beendigung des Ziehens auf die ursprüngliche Größe zurückkehrt. Ähnlich wie beim Zoomen von Bildern in Instagram.

AndroidiOSWebmacOSWindowsLinux
30-Tage-Downloads
4150
Likes
65
Pub-Punkte
160

Paket installieren

flutter pub add pinch_zoom_release_unzoom

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Ein Flutter-Widget, das die Pinch-to-Zoom-Funktionalität ermöglicht und automatisch nach Beendigung der Geste in seine ursprüngliche Größe zurückkehrt, wodurch das Zoom-Verhalten von Instagram nachgeahmt wird. Es bietet einen reibungslosen, temporären Zoom-Effekt, der ideal für Bilder oder Inhalte ist, die nicht vergrößert bleiben sollen. Das Widget unterstützt alle wichtigen Plattformen wie Android, iOS, Web, macOS, Windows und Linux und ist somit vielseitig für plattformübergreifende Anwendungen geeignet. Es ist leichtgewichtig und einfach mit minimaler Konfiguration zu integrieren.

Anwendungsfälle

  • Bildanzeige mit temporärem Zoom
  • Interaktive Benutzeroberflächenelemente mit dynamischer Skalierung
  • Plattformübergreifende, gestenbasierte Inhaltserschließung
  • Verbesserung der Benutzererfahrung in Fotogalerien
  • Einfache Zoom-Effekte ohne dauerhafte Skalierung

Hauptmerkmale

  • Automatischer Rückkehr zum ursprünglichen Größe nach dem Ziehen
  • Glatte Animation während Zoomen und Entzoomen
  • Unterstützt alle wichtigen Flutter-Plattformen
  • Minimale Einrichtung erforderlich
  • Intuitive Gestenerkennung

Geeignet für

  • Entwickler, die bildintensive Apps erstellen
  • Apps, die temporäre Zoom-Interaktionen erfordern
  • Projekte mit dem Ziel, Instagram-ähnliche Gesten zu implementieren
  • UI-Designer, die intuitive Touch-Rückmeldung suchen
  • Plattformübergreifende Anwendungen mit Gestenbedarf

Hinweise

  • Nicht geeignet für dauerhafte Zoom-Zustände
  • Begrenzte Anpassung des Zoom-Verhaltens
  • Kann zusätzliche Behandlung für komplexe Layouts erfordern
  • Am besten mit statischem oder nicht scrollendem Inhalt verwenden
  • Die Leistung kann sich bei großen oder hochauflösenden Bildern unterscheiden

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

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

Kategorien

Quell-Repository

Projekte, die dieses Paket verwenden

Noch keine Daten verfügbar.