1.9.0 • Published 4 months ago

enlarger v1.9.0

Weekly downloads
-
License
MIT
Repository
github
Last release
4 months ago

Enlarger

A image enlarger library for web app. See example here.

Features

  • Make the image have a magnifying glass effect.
  • Easy to use.
  • Support Typescript.

Installation

# pnpm
$ pnpm add enlarger

# yarn
$ yarn add enlarger

# npm
$ npm i enlarger

Usage

  1. Imports the style.
import 'enlarger/lib/style.css'
  1. Create a image enlarger instance.
<!-- Define a container -->
<div id="enlarger-container"></div>
// Then, initial a instance

import { createEnlarger } from 'enlarger'

const imageEnlarger = createEnlarger({
  container: '#enlarger-container',
  src: 'https://www.some.com/path/foo.png',
  autoSize: true
})

Options

PropTypeDefault ValueDescription
containerHTMLElement, string''Specify container elements.
srcstring''Specify the src of <img />.
altstring''Specify the alt of <img />.
autoSizebooleanfalseSpecify whether the image is adaptive in size. If set to true, width and height config will not be available.
widthnumber0Initialize the width of the image.
heightnumber0Initialize the height of the image. Height is not necessary because it will automatically adapt based on the width value.
magnificationnumber2Define the magnification of the image.
magnifierColorstringrgba(255, 255, 255, 0.2)Define the background color of the magnifier element.
magnifierSizeRationumber0.5Define magnifier element size ratio equivalent to image size.
magnifierCursorstringcrosshairDefine the cursor style of the magnifier element.
magnifierBorderColorstring#bbbbbbDefine the border color of the magnifier element.
magnifierBorderWidthstring1pxDefine the border width of the magnifier element.
magnifierBorderStylestringsolidDefine the border width of the magnifier element.

APIs

Methods of instance

setOptions

You can modify the options via it after initialization.

imageEnlarger.setOptions({
  width: 500 // Set the image width to 500
})

setWidth

You can modify the wdith of image via it after initialization.

imageEnlarger.setWidth(500)

setHeight

You can modify the height of image via it after initialization.

TIPS, Usually, you only need to control the width of the image, and the height is responsive.

imageEnlarger.setHeight(800) // Set the image width to 800

destory

Destory the image enlarger instance.

imageEnlarger.destory()

CHANGE LOG

See here.

1.9.0

4 months ago

1.8.0

9 months ago

1.7.1

9 months ago

1.7.0

9 months ago

1.6.0

9 months ago

1.5.0

9 months ago

1.4.1

9 months ago

1.4.0

9 months ago

1.3.7

9 months ago

1.3.6

9 months ago

1.3.5

9 months ago

1.3.4

9 months ago

1.3.3

9 months ago

1.3.2

9 months ago

1.3.1

9 months ago

1.3.0

9 months ago

1.2.0

9 months ago

1.1.0

9 months ago

1.0.0

9 months ago