Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More →

universal-parallax

Package Overview

Dependencies

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

universal-parallax

Easy parallax plugin using pure javascript. Also works on mobile platforms. Cross browser support.

1.1.0
Source
npm

Version published: 7 years ago

Weekly downloads: 59; increased by11.32%

Maintainers: 1

Weekly downloads

Created: 7 years ago

Source

Universal Parallax

Easy parallax plugin using pure javascript. Cross browser support, including mobile platforms. See demo

Features

Easy setup
Pure JavaScript plugin - no jQuery needed
Adaptive height
Mobile phone support
Support for transparent backgrounds - without affecting content

Install

$ npm i universal-parallax -S

Usage

#1

Include the script at the bottom of your project

<script src="node_modules/universal-parallax/dist/universal-parallax.min.js"></script>

#2

Choose between either..

Including this in your <head> section

<link href="node_modules/universal-parallax/dist/universal-parallax.min.css" rel="stylesheet">

Or adding this CSS
-- Gives more flexibility controlling the behaviour of bg images (see "optional" comment)

.parallax--container {
	position: absolute;
	clip: rect(0, auto, auto, 0);
	width: 100%;
	height: 100%;
	top: 0;
	left: 0;
	z-index: -10; /* place further back if necessary */
}

.parallax {
	position: fixed;
	width: 100%;
	height: 100%;
	top: 0;
	left: 0;
	/* optional - see step #3 */
	background-repeat: no-repeat;
	background-position: center;
	background-size: cover;
}

#3

If <section> is your container, make the parallax element inside it, just before the closing tag

<section>
	...
	<div class="parallax" data-parallax-image="path/to/your_image">
</section>

You can also use a class to define your background-image in CSS, instead of using data-parallax-image=""

#4

Fire up the JS function

new universalParallax().init();

#5

Check the result in your project

If it resembles the demo then you're done
Pls report any problems you find! Thanks :)

Custom speed

You can change the parallax speed; the higher the number, the slower the parallax effect.

new universalParallax().init({
	speed: 6.0
});

Note: speed: 1.2 is the minimum value before the background image is fixed.

Opacity

If desired, transparency can be added to one, or all parallax elements with CSS and it won't affect the opacity of your content above

.parallax {
	opacity: 0.5;
}

Keywords

FAQs

What is universal-parallax?

Is universal-parallax popular?

Is universal-parallax well maintained?

Package last updated on 01 Mar 2018

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install