npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

ngx-parallax

v4.0.0

Published

Parallax effect module for Angular 4+

Downloads

710

Readme

ngx-parallax

A parallax plugin/directive for Angular 2+

You can use this directive right now if you write Angular code using SystemJS to import/export files, or at the very least you write it in TypeScript. ES5 and Dart versions are not yet complete/started, but as demand grows for those as well as the documentation gets updated, those versions will be made available.

Forked

This is a fork from cwadrupldijjit/ng2-parallax - fixing webpack support while maintaining systemjs support and also supporting all angular versions above 2, not just 2.

Installation of files

In order to install this plugin, you can do one of a few things:

  • Install from npm:
npm install --save ngx-parallax
  • clone it from the project GitHub repository:
git clone https://github.com/MattJeanes/ngx-parallax

If you'd like to contribute, feel free to fork it.

If you have copied/created a version of the directive file (either parallax.directive.ts or parallax.directive.js), place the copy of the file in a convenient place to reference it in your working directory, and reference however you need to have it be available in the rest of your application.

To reference it in your application, you can import it just like the rest of the Angular files and components.

Using the npm package:

For System.js Users:

First, you have to register where the ngx-parallax is:

<!-- index.html -->
<script>
    System.config({
        paths: {
            '/*': '/app/*',
            'ngx-parallax/*': '/node_modules/ngx-parallax/*' // <--- add this
        },
        packages: {
            app: {
                format: 'register',
                defaultExtension: 'js'
            },
            '/node_modules/ngx-parallax': { // <--- and this
                format: 'register',
                defaultExtension: js
            }
        }
    });
    
    System.import('/app/boot')
        .then(null, console.error.bind(console));
</script>

Using webpack or systemjs:

import { ParallaxModule, ParallaxConfig } from 'ngx-parallax';

Using a local copy:

import { ParallaxModule, ParallaxConfig } from './path/to/directives/parallax.directive';

If you import both Parallax and ParallaxConfig, you can get some IntelliSense or type verification help for the parallaxConfig object you can define in your component's class. You'll see how to implement that shortly.

In order to get your component to recognize it, you need to add it to your module's annotations like so:

@NgModule({
    imports: [
        ParallaxModule  // <----- Right here
    ]
})

You can then use the directive anywhere within that component itself by sticking it on any element you've put in your template like so:
```html
<h1>Welcome to my website!</h1>

<div parallax></div>
<!-- ^ here ^ -->

This plugin assumes you've added styling to the element you've put the "parallax" attribute onto, like height, width, and background-image. If you'd like to override any of the default settings for the parallax directive when you'd like to customize the functionality. One way you can do that is by passing in a [config] object through the HTML.

<div parallax [config]="{initialValue: -100, ratio: .7}"></div>

For more specific information, refer to the examples found at the project page, or in the examples folder for the version of the plugin you'd like to use, which you can access when you've cloned or downloaded the project. Currently, only the TypeScript version works. The JS version is under development and the Dart version will happen later, when demand is up for it (or when it's requested and I have time to learn Dart or someone helps to contribute to that version... :P).

Any feedback is much appreciated. Log issues, send pull requests, you know the drill.

Thanks for showing interest in this project and hope you enjoy it!