Skip to content
Projects

tgomilar/paroller.js has 604 GitHub stars and 143 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 16:56 UTC. Last push 2026-03-15.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Parallax scrolling jQuery plugin

Developer Tools

README.md

Original

paroller.js

npm

A lightweight jQuery plugin that enables parallax scrolling effect.

  • You can use it on elements with background property or on any other element
  • Elements can move vertically or horizontally while scrolling
  • Controlled via data-* attributes or jQuery options
  • Breakpoint-aware with per-screen-size factors
  • Mobile ready
  • Easy to use

Demo: Preview


Install

Before closing </body> include jQuery and paroller.js.

npm

npm install paroller.js

Yarn

yarn add paroller.js

CDN

jsDelivr · unpkg


Usage

<!-- Set attributes on element -->
<div
  class="my-paroller"
  data-paroller-factor="0.4"
  data-paroller-factor-xs="0.2"
  data-paroller-factor-sm="0.3"
  data-paroller-type="foreground"
  data-paroller-direction="horizontal"></div>

<div class="my-element"></div>
// a) initialize using data attributes
$(".my-paroller").paroller();

// b) initialize with options
$(".my-element").paroller({
  factor: 0.5,
  factorXs: 0.2,
  factorSm: 0.3,
  type: "foreground",
  direction: "horizontal",
});

npm / browserify

require("paroller.js");

Options

data attributes

data-paroller-* jQuery option Value Default
data-paroller-factor factor number (+/-) 0
data-paroller-factor-xs factorXs number (+/-) inherits factor
data-paroller-factor-sm factorSm number (+/-) inherits factor
data-paroller-factor-md factorMd number (+/-) inherits factor
data-paroller-factor-lg factorLg number (+/-) inherits factor
data-paroller-factor-xl factorXl number (+/-) inherits factor
data-paroller-type type background, foreground background
data-paroller-direction direction vertical, horizontal vertical
data-paroller-transition transition CSS transition transform 0.1s ease

factor

Sets speed and distance of the parallax effect. Positive and negative values control direction (up/down, left/right). A larger absolute value means faster/further movement.

Note: factor must be set for paroller.js to have any effect.

Breakpoint factors

If a breakpoint factor is not set, it inherits the main factor value. Set a breakpoint factor to 0 to disable parallax at that screen size.

data attribute jQuery option Window width
Extra small data-paroller-factor-xs factorXs < 576px
Small data-paroller-factor-sm factorSm ≤ 768px
Medium data-paroller-factor-md factorMd ≤ 1024px
Large data-paroller-factor-lg factorLg ≤ 1200px
Extra large data-paroller-factor-xl factorXl ≤ 1920px

transition

CSS transition applied only to foreground elements.

Full example

$("[data-paroller-factor]").paroller({
  factor: 0.3, // main factor, used when no breakpoint factor matches
  factorXs: 0.1, // < 576px
  factorSm: 0.2, // <= 768px
  factorMd: 0.3, // <= 1024px
  factorLg: 0.4, // <= 1200px
  factorXl: 0.5, // <= 1920px
  type: "foreground", // background | foreground
  direction: "horizontal", // vertical | horizontal
  transition: "transform 0.2s ease-in",
});

Development

npm install
npm run build   # generates dist/jquery.paroller.min.js from source

License

MIT