tgomilar/paroller.js
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.
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 ToolsREADME.md
Originalparoller.js
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
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:
factormust 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