Security News
tea.xyz Spam Plagues npm and RubyGems Package Registries
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
ng2-parallax
Advanced tools
Readme
A parallax plugin/directive for Angular 2
You can use this directive right now if you write Angular 2 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.
In order to install this plugin, you can do one of a few things:
npm install --save ng2-parallax
git clone https://github.com/cwadrupldijjit/ng2-parallax
If you'd like to contribute, feel free to fork it.
Copy code from the file itself (ts version)
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.
For System.js
Users:
First, you have to register where the ng2-parallax is:
<!-- index.html -->
<script>
System.config({
paths: {
'/*': '/app/*',
'ng2-parallax/*': '/node_modules/ng2-parallax/*' // <--- add this
},
packages: {
app: {
format: 'register',
defaultExtension: 'js'
},
'/node_modules/ng2-parallax': { // <--- and this
format: 'register',
defaultExtension: js
}
}
});
System.import('/app/boot')
.then(null, console.error.bind(console));
</script>
For webpack
Users:
NOTE: Webpack isn't as straightforward as I'd assume with requiring node_modules such as the ng2-parallax, and as such, despite my efforts in figuring out what is preventing it from reading from node_modules, I've been unable to locate the source of the problem. The direction below is just a temporary fix before we can get the situation straight with that one. Any help to get that working fine with webpack would be greatly appreciated.
If you have npm install
-ed the parallax directive, you will have to either figure out how to reference it without problems, or you could simply copy it into a subdirectory of your app
or src
folder where it's easily accessible, then follow the import directions in the "Using a local copy" section below.
And then you can import it just like the Angular 2 components:
import { Component,
View } from 'angular2/core';
import { Parallax,
// either (for Systemjs)
ParallaxConfig } from 'ng2-parallax/system';
// or, if webpack is finding it fine:
ParallaxConfig } from 'ng2-parallax/commonjs';
import { Component,
View } from 'angular2/core';
import { Parallax,
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 component's annotations like so:
@Component({
selector: 'my-app',
templateUrl: `./path/to/template.html`,
directives: [
Parallax // <----- Right here
]
})
Or:
@Component({
selector: 'my-app'
})
@View({
templateUrl: `./path/to/template.html`,
directives: [
Parallax // <----- Right here
]
})
class MyComponent {}
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:
<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]="{parallaxInitVal: -100, parallaxRatio: .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!
FAQs
Parallax effect module for Angular 2 Beta
The npm package ng2-parallax receives a total of 28 weekly downloads. As such, ng2-parallax popularity was classified as not popular.
We found that ng2-parallax demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
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.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.