npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@thinkam/ngx-image-zoom

v1.2.3

Published

'Unofficial' package that implements 'toggle-freeze' as was 'hover-freeze' and does 'hover-freeze' without needing to click to zoom: Whenever the mouse cursor moves over the thumbnail it will show the zoomed image, first click freezes the zoomed image whe

Downloads

28

Readme

ngx-image-zoom

npm version

Project status

This version is only tested with Angular13. Moving forward this library may or may not work on older versions of Angular anymore.

Still in early development, more features are planned and incoming. Should be in a working state right now but it's not tested in lots of different setups yet.

Breaking changes in version 0.5.0, see changelog for details.

Demonstration of available features available here.

About

NgxImageZoom is inspired by angular2-image-zoom and JQuery libraries such as jQuery Zoom and elevateZoom-plus but a pure Angular2+ implementation of similar concepts. This plugin works with both URLs to images and in-line images (Data URI).

Available options

All settings except thumbImage are optional. If no fullImage is provided the thumbImage will be used as the high resolution version as well.

Option | Default value | Description :---:|:---:|--- thumbImage | none | (Required) The smaller version of the image that will be shown when there's no interaction by the user. fullImage | none | The full resolution version of the image to be used when zooming. If not supplied thumbImage will be used. magnification | 1 | The zoom factor to be used by default. 1 means we use the fullImage at its actual resolution. zoomMode | 'hover' | The mode of zooming to use, these are explained in a table below. enableScrollZoom | false | Boolean that toggles if the mouse wheel should be captured when hovering over the image to adjust magnification. scrollStepSize | 0.1 | When using scroll zoom this setting determines how big steps each scroll changes the zoom. enableLens | false | If enabled only a small portion around the mouse cursor will actually magnify instead of the entire image area. lensWidth | 100 | Width of the lens, if enabled. lensHeight | 100 | Height of the lens, if enabled. circularLens | false | Make the lens circular instead of square. This will only look good if width and height are equal. minZoomRatio | baseRatio | Lower limit on how much zoom can be applied with scrollZoom enabled. See below for details. maxZoomRatio | 2 | Upper limit on how much zoom can be applied with scrollZoom enabled. See below for details. altText | '' | alt attribute of the thumb and full image. titleText | '' | title attribute of the thumb and full image.

Zoom modes

Mode | Description :---:|--- hover | Whenever the mouse cursor moves over the thumbnail it will show the zoomed image until it leaves the thumbnail. click | Similar to hover but it only starts zooming if the user clicks the image. Moving the cursor away from the image disables it again. toggle | A click in the image will zoom at the point of the cursor. Another click will restore the small image. toggle-click | Combination of toggle and click. A click in the image will start zooming. Another click or moving the cursor away from the image will restore the small image. toggle-freeze | First click enables hover mode, second click freezes the zoomed image where it is, third click restores thumbnail. hover-freeze | Whenever the mouse cursor moves over the thumbnail it will show the zoomed image, first click freezes the zoomed image where it is, second click restores thumbnail.

Zoom ratio

The zoom ratio used in the minZoomRatio and maxZoomRatio settings refer to the relative size of the thumbnail and the full size image. The baseRatio default value is the calculated ratio that would make the zoomed image equal in size to the thumbnail. For example, if the full size image is 10x larger than the thumbnail, then minZoomRatio will default to 0.1, as in the full size image can at its smallest be shown at 0.1 times its original size. The default value for maxZoomRatio being 1 means the largest the fullSize image can appear is twice its original size.

Available output

The component outputs the follow events that can be triggered on.

Event name | Description :---:|--- zoomScroll | Whenever the user changes the zoom level using the scroll wheel this event will fire with the current zoom ratio (see above). zoomPosition | When the point on where the zoom is focused changes this event emits a Coord event (interface exported from the module) with X/Y in pixels relative thumbnails top left corner. Practically whenever the user moves the mouse cursor over the image. imagesLoaded | When the thumbnail and fullImage are loaded and ready to be used this output emits "true". It will emit "false" if images are changed and on initial setup

Installation

To install this library, run:

$ npm install ngx-image-zoom --save

Using this library

From your Angular AppModule:

import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';

import { AppComponent } from './app.component';

// Import the library
import { NgxImageZoomModule } from '@thinkam/ngx-image-zoom';

@NgModule({
  declarations: [
    AppComponent
  ],
  imports: [
    BrowserModule,
    NgxImageZoomModule // <-- Add this line
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

Once the library is imported, you can use its component in your Angular application:

<!-- You can now use NgxImageZoom component in app.component.html -->
<h1>
  {{title}}
</h1>
<lib-ngx-image-zoom
    [thumbImage]=myThumbnail
    [fullImage]=myFullresImage
></lib-ngx-image-zoom>

License

MIT © Mathias Wittlock