Search packages, repositories and app categories

zoom_widget cover
Package detailsv2.0.1

zoom_widget

Widget to zoom on a canvas of modifiable size that a child widget can hold.

AndroidiOSWebmacOSWindowsLinux
30-day downloads
8.2K
Likes
215
Pub points
125

Install package

flutter pub add zoom_widget

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

The zoom_widget package provides a customizable Flutter widget that enables interactive zooming on a canvas of adjustable size. It allows developers to wrap any child widget with zoom and pan functionality, making it ideal for images, maps, or complex UI elements requiring detailed exploration. The widget supports touch gestures and mouse interactions across multiple platforms, ensuring consistent behavior on Android, iOS, Web, macOS, Windows, and Linux. It is lightweight and designed for seamless integration into existing Flutter applications.

Use cases

  • Interactive image viewers
  • Digital whiteboards
  • Map navigation interfaces
  • Data visualization tools
  • Educational apps with scalable content

Key features

  • Supports pinch-to-zoom and drag gestures
  • Adjustable canvas size
  • Cross-platform compatibility
  • Smooth animation transitions
  • Customizable zoom limits
  • Easy integration with existing widgets

Suitable for

  • Developers building interactive visualizations
  • Apps requiring scalable content display
  • Projects needing multi-touch support
  • Cross-platform applications with gesture controls
  • UIs involving detailed graphics or diagrams

Considerations

  • Performance may vary with very large canvases
  • Requires careful handling of child widget sizing
  • May need additional logic for edge cases like overflow
  • Not optimized for high-frequency updates
  • Best suited for static or infrequently updated content

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Flutter zoom widget

With this widget you can create a customizable canvas in which you can zoom in flutter.

It is possible to customize virtually all the canvases of the canvas such as color, background color, acitvate and deactivate scrolls, change the color of scrolls, modify the sensitivity of the zoom, the initial zoom enters other aspects found in the construction of the Zoom class.

Installation

Add to pubspec.yaml:

dependencies:
zoom_widget: ^2.0.0

How to use

You only need to create an instance of the Zoom class in the child of your Scaffold or within the widget of your choice, within the child attribute, put the widget that you want to zoom in and the width and height of the canvas where it will be made zoom.

Import
import 'package:zoom_widget/zoom_widget.dart';
Simple examples

Center flutter logo using all space of view port:

 Zoom(
        initTotalZoomOut: true,
        child: Center(
          child: FlutterLogo(
            size: 1000,
          ),
        ),
      );

Center text with max width and max height:

Zoom(
    maxZoomWidth: 1800,
    maxZoomHeight: 1800,
    child: Center(
        child: Text("Happy zoom!!"),
    )
);
Callbacks

It is possible to obtain the x and y position of our canvas with respect to the scrolls and and the zoom and scale of our canvas using two simple callbacks in our Zoom instance.

Zoom(
    maxZoomWidth: 1800,
    maxZoomHeight: 1800,
    onTap: (){
        print("Widget clicked");
    },
    onPositionUpdate: (Offset position){
        print(position);
    },
    onScaleUpdate: (double scale,double zoom){
        print("$scale  $zoom");
    },
    child: Center(
        child: Text("Happy zoom!!"),
    )
);
Customize properties

Customizing the properties you can get amazing results.

  • width (Depreceted) double.
  • height (Depreceted) double.
  • maxZoomWidth double.
  • maxZoomHeight double.
  • backgroundColor Color.
  • canvasColor Color.
  • onPositionUpdate() Callaback.
  • onScaleUpdate() Callaback.
  • onTap() Callaback.
  • scrollWeight double.
  • opacityScrollBars double 0.0-1.0.
  • colorScrollBars Color.
  • centerOnScale bool.
  • initZoom (Depreceted) double.
  • initPosition Offset.
  • initScale double
  • enableScroll bool.
  • zoomSensibility double.
  • doubleTapZoom bool.
  • transformationController TransformationController.
  • radiusScrollBars double.
  • doubleTapScaleChange double.
  • doubleTapAnimDuration Duration.
  • initTotalZoomOut bool.
Customized properties example
Zoom(
    maxZoomWidth: 1800,
    maxZoomHeight: 1800,
    canvasColor: Colors.grey,
    backgroundColor: Colors.orange,
    colorScrollBars: Colors.purple,
    opacityScrollBars: 0.9,
    scrollWeight: 10.0,
    centerOnScale: true,
    enableScroll: true,
    doubleTapZoom: true,
    zoomSensibility: 0.05,
    onTap: (){ 
        print("Widget clicked");
    }
    onPositionUpdate: (position){
        setState(() {
            x=position.dx;
            y=position.dy;
        });
    },
    onScaleUpdate: (scale,zoom){
        setState(() {
            _zoom=zoom;
        });
    },
    child: Center(
        child: Text("x:${x.toStringAsFixed(2)} y:${y.toStringAsFixed(2)} zoom:${_zoom.toStringAsFixed(2)}",style: TextStyle(color: Colors.deepPurple,fontSize: 50),),
    ),
);
Complex example

It can be used for more complex things like an image gallery.

All examples of gifs are inside the example

Categories

Dependencies

Dependency list 1 items

Source repository

Projects using this package