Swingdrag NPM | npm.io

swingdrag

What's swingdrag?\ swingdrag is a jQuery UI plugin, which adds a nice swing effect to the drag function.

Demo

For a full working demo click here.

What`s new?

v1.5.0

The speedInfluenceFactor option was added. This factor controls the influence of the drag speed on the rotation angle. This is useful to control the rotation angle for different display resolutions (DPI).
The maxRotationAngleDeg option was added. It controls the same behaviour as the rotationAngleDeg option and will replace it in future releases.
swingdrag containers will always be topmost during dragging.

Install

npm install swingdrag

Usage

HTML

<script src="node_modules/swingdrag/dist/src/jquery.ui.swingdrag.min.js"></script>
<link rel="stylesheet" href="node_modules/swingdrag/dist/css/swingdrag.css" />

<div id="container">The container element which should be dragged</div>

JavaScript

$("#container").swingdrag();

Options

rotationAngleDeg `Deprecated since version 1.5.0. Use maxRotationAngleDeg instead.`

The maximum possible angle of rotation in degrees.
Default : 20

showShadow

Indicates whether a pickup-/drop shadow should be shown.
Default: true

pickUpScaleFactor

The pick up scale factor indicates the size change during dragging.
Default: 1.1

maxRotationAngleDeg

The maximum possible angle of rotation in degrees.
Default : 20

speedInfluenceFactor

This factor controls the influence of the drag speed on the rotation angle.
It is useful to control the rotation angle for different display resolutions (DPI).
Default: 2.0

Example

let options = {
    maxRotationAngleDeg: 20, 
    showShadow: true, 
    pickUpScaleFactor: 1.1,
    speedInfluenceFactor: 2.0
}

$("#container").swingdrag(options);

Release notes

v1.5.1

Bug Fix: The maximum angle of rotation is now calculated correctly.

v1.5.0

The speedInfluenceFactor option was added. This factor controls the influence of the drag speed on the rotation angle. This is useful to control the rotation angle for different display resolutions (DPI).
The maxRotationAngleDeg option was added. It controls the same behaviour as the rotationAngleDeg option and will replace it in future releases.
swingdrag containers will always be topmost during dragging.

v1.4.0

swingdrag works together with other draggable plugins like gridstack.

v1.3.1

The API documentation and the examples were updated.

v1.3.0

The swing effect is now depending on drag speed.

v1.2.0

All used styles have been moved from code into a css/swingdrag.css file.
The source file swingdrag.scss has been added, too.

v1.1.0

The option maxRotationAngleDeg was renamed to rotationAngleDeg and its default value was set to 8.
The size of the deployed jquery.ui.swingdrag.min.js file was reduced.

v1.0.0

Display/performance bugs were fixed.
swingdrag now works smooth in all popular browsers like Chrome, Firefox, Internet Explorer and Edge.
Options have been added.