18 |
19 | If you don't have git installed in your machine, [install it](https://help.github.com/articles/set-up-git/).
20 |
21 | ## Fork this repository
22 |
23 | Fork this repository by clicking on the fork button on the top of this page.
24 | This will create a copy of this repository in your account.
25 |
26 | ## Clone the repository
27 |
28 | 
29 |
30 | Now clone the forked repository to your machine. Go to your GitHub account, open the forked repository, click on the clone button and then click the _copy to clipboard_ icon.
31 |
32 | Open a terminal and run the following git command:
33 |
34 | ```
35 | git clone "URL you just copied"
36 | ```
37 |
38 | 
39 |
40 | For example:
41 |
42 | ```
43 | git clone https://github.com/this-is-you/first-contributions.git
44 | ```
45 |
46 | where `this-is-you` is your GitHub username. Here you're copying the contents of the first-contributions repository in GitHub to your computer.
47 |
48 | ## Create a branch
49 |
50 | Change to the repository directory on your computer (if you are not already there):
51 |
52 | ```
53 | cd first-contributions
54 | ```
55 |
56 | Now create a branch using the `git checkout` command:
57 |
58 | ```
59 | git checkout -b 
75 |
76 | If you go to the project directory and execute the command `git status`, you'll see there are changes.
77 |
78 | Add those changes to the branch you just created using the `git add` command:
79 |
80 | ```
81 | git add _data/contributions.yml
82 | ```
83 |
84 | Now commit those changes using the `git commit` command:
85 |
86 | ```
87 | git commit -m "Add 
107 |
108 | Now submit the pull request.
109 |
110 | 
111 |
112 | Soon, I'll be merging all your pull requests into the master branch of this project. You will get a notification email once the changes have been merged.
113 |
114 | ## Contributors
115 |
116 | Thank you to all the contributors who help in making this project better :raised_hands:
117 |
118 |
119 | {{ site.title }}
3 |
19 |
25 |
44 |
45 |
46 |
47 |
48 |
49 |
--------------------------------------------------------------------------------
/vanilla-tilt.js:
--------------------------------------------------------------------------------
1 | var VanillaTilt = (function () {
2 | 'use strict';
3 |
4 | /**
5 | * Created by Sergiu Șandor (micku7zu) on 1/27/2017.
6 | * Original idea: https://github.com/gijsroge/tilt.js
7 | * MIT License.
8 | * Version 1.7.2
9 | */
10 |
11 | class VanillaTilt {
12 | constructor(element, settings = {}) {
13 | if (!(element instanceof Node)) {
14 | throw ("Can't initialize VanillaTilt because " + element + " is not a Node.");
15 | }
16 |
17 | this.width = null;
18 | this.height = null;
19 | this.clientWidth = null;
20 | this.clientHeight = null;
21 | this.left = null;
22 | this.top = null;
23 |
24 | // for Gyroscope sampling
25 | this.gammazero = null;
26 | this.betazero = null;
27 | this.lastgammazero = null;
28 | this.lastbetazero = null;
29 |
30 | this.transitionTimeout = null;
31 | this.updateCall = null;
32 | this.event = null;
33 |
34 | this.updateBind = this.update.bind(this);
35 | this.resetBind = this.reset.bind(this);
36 |
37 | this.element = element;
38 | this.settings = this.extendSettings(settings);
39 |
40 | this.reverse = this.settings.reverse ? -1 : 1;
41 | this.glare = VanillaTilt.isSettingTrue(this.settings.glare);
42 | this.glarePrerender = VanillaTilt.isSettingTrue(this.settings["glare-prerender"]);
43 | this.fullPageListening = VanillaTilt.isSettingTrue(this.settings["full-page-listening"]);
44 | this.gyroscope = VanillaTilt.isSettingTrue(this.settings.gyroscope);
45 | this.gyroscopeSamples = this.settings.gyroscopeSamples;
46 |
47 | this.elementListener = this.getElementListener();
48 |
49 | if (this.glare) {
50 | this.prepareGlare();
51 | }
52 |
53 | if (this.fullPageListening) {
54 | this.updateClientSize();
55 | }
56 |
57 | this.addEventListeners();
58 | this.reset();
59 | this.updateInitialPosition();
60 | }
61 |
62 | static isSettingTrue(setting) {
63 | return setting === "" || setting === true || setting === 1;
64 | }
65 |
66 | /**
67 | * Method returns element what will be listen mouse events
68 | * @return {Node}
69 | */
70 | getElementListener() {
71 | if (this.fullPageListening) {
72 | return window.document;
73 | }
74 |
75 | if (typeof this.settings["mouse-event-element"] === "string") {
76 | const mouseEventElement = document.querySelector(this.settings["mouse-event-element"]);
77 |
78 | if (mouseEventElement) {
79 | return mouseEventElement;
80 | }
81 | }
82 |
83 | if (this.settings["mouse-event-element"] instanceof Node) {
84 | return this.settings["mouse-event-element"];
85 | }
86 |
87 | return this.element;
88 | }
89 |
90 | /**
91 | * Method set listen methods for this.elementListener
92 | * @return {Node}
93 | */
94 | addEventListeners() {
95 | this.onMouseEnterBind = this.onMouseEnter.bind(this);
96 | this.onMouseMoveBind = this.onMouseMove.bind(this);
97 | this.onMouseLeaveBind = this.onMouseLeave.bind(this);
98 | this.onWindowResizeBind = this.onWindowResize.bind(this);
99 | this.onDeviceOrientationBind = this.onDeviceOrientation.bind(this);
100 |
101 | this.elementListener.addEventListener("mouseenter", this.onMouseEnterBind);
102 | this.elementListener.addEventListener("mouseleave", this.onMouseLeaveBind);
103 | this.elementListener.addEventListener("mousemove", this.onMouseMoveBind);
104 |
105 | if (this.glare || this.fullPageListening) {
106 | window.addEventListener("resize", this.onWindowResizeBind);
107 | }
108 |
109 | if (this.gyroscope) {
110 | window.addEventListener("deviceorientation", this.onDeviceOrientationBind);
111 | }
112 | }
113 |
114 | /**
115 | * Method remove event listeners from current this.elementListener
116 | */
117 | removeEventListeners() {
118 | this.elementListener.removeEventListener("mouseenter", this.onMouseEnterBind);
119 | this.elementListener.removeEventListener("mouseleave", this.onMouseLeaveBind);
120 | this.elementListener.removeEventListener("mousemove", this.onMouseMoveBind);
121 |
122 | if (this.gyroscope) {
123 | window.removeEventListener("deviceorientation", this.onDeviceOrientationBind);
124 | }
125 |
126 | if (this.glare || this.fullPageListening) {
127 | window.removeEventListener("resize", this.onWindowResizeBind);
128 | }
129 | }
130 |
131 | destroy() {
132 | clearTimeout(this.transitionTimeout);
133 | if (this.updateCall !== null) {
134 | cancelAnimationFrame(this.updateCall);
135 | }
136 |
137 | this.reset();
138 |
139 | this.removeEventListeners();
140 | this.element.vanillaTilt = null;
141 | delete this.element.vanillaTilt;
142 |
143 | this.element = null;
144 | }
145 |
146 | onDeviceOrientation(event) {
147 | if (event.gamma === null || event.beta === null) {
148 | return;
149 | }
150 |
151 | this.updateElementPosition();
152 |
153 | if (this.gyroscopeSamples > 0) {
154 | this.lastgammazero = this.gammazero;
155 | this.lastbetazero = this.betazero;
156 |
157 | if (this.gammazero === null) {
158 | this.gammazero = event.gamma;
159 | this.betazero = event.beta;
160 | } else {
161 | this.gammazero = (event.gamma + this.lastgammazero) / 2;
162 | this.betazero = (event.beta + this.lastbetazero) / 2;
163 | }
164 |
165 | this.gyroscopeSamples -= 1;
166 | }
167 |
168 | const totalAngleX = this.settings.gyroscopeMaxAngleX - this.settings.gyroscopeMinAngleX;
169 | const totalAngleY = this.settings.gyroscopeMaxAngleY - this.settings.gyroscopeMinAngleY;
170 |
171 | const degreesPerPixelX = totalAngleX / this.width;
172 | const degreesPerPixelY = totalAngleY / this.height;
173 |
174 | const angleX = event.gamma - (this.settings.gyroscopeMinAngleX + this.gammazero);
175 | const angleY = event.beta - (this.settings.gyroscopeMinAngleY + this.betazero);
176 |
177 | const posX = angleX / degreesPerPixelX;
178 | const posY = angleY / degreesPerPixelY;
179 |
180 | if (this.updateCall !== null) {
181 | cancelAnimationFrame(this.updateCall);
182 | }
183 |
184 | this.event = {
185 | clientX: posX + this.left,
186 | clientY: posY + this.top,
187 | };
188 |
189 | this.updateCall = requestAnimationFrame(this.updateBind);
190 | }
191 |
192 | onMouseEnter() {
193 | this.updateElementPosition();
194 | this.element.style.willChange = "transform";
195 | this.setTransition();
196 | }
197 |
198 | onMouseMove(event) {
199 | if (this.updateCall !== null) {
200 | cancelAnimationFrame(this.updateCall);
201 | }
202 |
203 | this.event = event;
204 | this.updateCall = requestAnimationFrame(this.updateBind);
205 | }
206 |
207 | onMouseLeave() {
208 | this.setTransition();
209 |
210 | if (this.settings.reset) {
211 | requestAnimationFrame(this.resetBind);
212 | }
213 | }
214 |
215 | reset() {
216 | this.event = {
217 | clientX: this.left + this.width / 2,
218 | clientY: this.top + this.height / 2
219 | };
220 |
221 | if (this.element && this.element.style) {
222 | this.element.style.transform = `perspective(${this.settings.perspective}px) ` +
223 | `rotateX(0deg) ` +
224 | `rotateY(0deg) ` +
225 | `scale3d(1, 1, 1)`;
226 | }
227 |
228 | this.resetGlare();
229 | }
230 |
231 | resetGlare() {
232 | if (this.glare) {
233 | this.glareElement.style.transform = "rotate(180deg) translate(-50%, -50%)";
234 | this.glareElement.style.opacity = "0";
235 | }
236 | }
237 |
238 | updateInitialPosition() {
239 | if (this.settings.startX === 0 && this.settings.startY === 0) {
240 | return;
241 | }
242 |
243 | this.onMouseEnter();
244 |
245 | if (this.fullPageListening) {
246 | this.event = {
247 | clientX: (this.settings.startX + this.settings.max) / (2 * this.settings.max) * this.clientWidth,
248 | clientY: (this.settings.startY + this.settings.max) / (2 * this.settings.max) * this.clientHeight
249 | };
250 | } else {
251 | this.event = {
252 | clientX: this.left + ((this.settings.startX + this.settings.max) / (2 * this.settings.max) * this.width),
253 | clientY: this.top + ((this.settings.startY + this.settings.max) / (2 * this.settings.max) * this.height)
254 | };
255 | }
256 |
257 |
258 | let backupScale = this.settings.scale;
259 | this.settings.scale = 1;
260 | this.update();
261 | this.settings.scale = backupScale;
262 | this.resetGlare();
263 | }
264 |
265 | getValues() {
266 | let x, y;
267 |
268 | if (this.fullPageListening) {
269 | x = this.event.clientX / this.clientWidth;
270 | y = this.event.clientY / this.clientHeight;
271 | } else {
272 | x = (this.event.clientX - this.left) / this.width;
273 | y = (this.event.clientY - this.top) / this.height;
274 | }
275 |
276 | x = Math.min(Math.max(x, 0), 1);
277 | y = Math.min(Math.max(y, 0), 1);
278 |
279 | let tiltX = (this.reverse * (this.settings.max - x * this.settings.max * 2)).toFixed(2);
280 | let tiltY = (this.reverse * (y * this.settings.max * 2 - this.settings.max)).toFixed(2);
281 | let angle = Math.atan2(this.event.clientX - (this.left + this.width / 2), -(this.event.clientY - (this.top + this.height / 2))) * (180 / Math.PI);
282 |
283 | return {
284 | tiltX: tiltX,
285 | tiltY: tiltY,
286 | percentageX: x * 100,
287 | percentageY: y * 100,
288 | angle: angle
289 | };
290 | }
291 |
292 | updateElementPosition() {
293 | let rect = this.element.getBoundingClientRect();
294 |
295 | this.width = this.element.offsetWidth;
296 | this.height = this.element.offsetHeight;
297 | this.left = rect.left;
298 | this.top = rect.top;
299 | }
300 |
301 | update() {
302 | let values = this.getValues();
303 |
304 | this.element.style.transform = "perspective(" + this.settings.perspective + "px) " +
305 | "rotateX(" + (this.settings.axis === "x" ? 0 : values.tiltY) + "deg) " +
306 | "rotateY(" + (this.settings.axis === "y" ? 0 : values.tiltX) + "deg) " +
307 | "scale3d(" + this.settings.scale + ", " + this.settings.scale + ", " + this.settings.scale + ")";
308 |
309 | if (this.glare) {
310 | this.glareElement.style.transform = `rotate(${values.angle}deg) translate(-50%, -50%)`;
311 | this.glareElement.style.opacity = `${values.percentageY * this.settings["max-glare"] / 100}`;
312 | }
313 |
314 | this.element.dispatchEvent(new CustomEvent("tiltChange", {
315 | "detail": values
316 | }));
317 |
318 | this.updateCall = null;
319 | }
320 |
321 | /**
322 | * Appends the glare element (if glarePrerender equals false)
323 | * and sets the default style
324 | */
325 | prepareGlare() {
326 | // If option pre-render is enabled we assume all html/css is present for an optimal glare effect.
327 | if (!this.glarePrerender) {
328 | // Create glare element
329 | const jsTiltGlare = document.createElement("div");
330 | jsTiltGlare.classList.add("js-tilt-glare");
331 |
332 | const jsTiltGlareInner = document.createElement("div");
333 | jsTiltGlareInner.classList.add("js-tilt-glare-inner");
334 |
335 | jsTiltGlare.appendChild(jsTiltGlareInner);
336 | this.element.appendChild(jsTiltGlare);
337 | }
338 |
339 | this.glareElementWrapper = this.element.querySelector(".js-tilt-glare");
340 | this.glareElement = this.element.querySelector(".js-tilt-glare-inner");
341 |
342 | if (this.glarePrerender) {
343 | return;
344 | }
345 |
346 | Object.assign(this.glareElementWrapper.style, {
347 | "position": "absolute",
348 | "top": "0",
349 | "left": "0",
350 | "width": "100%",
351 | "height": "100%",
352 | "overflow": "hidden",
353 | "pointer-events": "none"
354 | });
355 |
356 | Object.assign(this.glareElement.style, {
357 | "position": "absolute",
358 | "top": "50%",
359 | "left": "50%",
360 | "pointer-events": "none",
361 | "background-image": `linear-gradient(0deg, rgba(255,255,255,0) 0%, rgba(255,255,255,1) 100%)`,
362 | "transform": "rotate(180deg) translate(-50%, -50%)",
363 | "transform-origin": "0% 0%",
364 | "opacity": "0",
365 | });
366 |
367 | this.updateGlareSize();
368 | }
369 |
370 | updateGlareSize() {
371 | if (this.glare) {
372 | const glareSize = (this.element.offsetWidth > this.element.offsetHeight ? this.element.offsetWidth : this.element.offsetHeight) * 2;
373 |
374 | Object.assign(this.glareElement.style, {
375 | "width": `${glareSize}px`,
376 | "height": `${glareSize}px`,
377 | });
378 | }
379 | }
380 |
381 | updateClientSize() {
382 | this.clientWidth = window.innerWidth
383 | || document.documentElement.clientWidth
384 | || document.body.clientWidth;
385 |
386 | this.clientHeight = window.innerHeight
387 | || document.documentElement.clientHeight
388 | || document.body.clientHeight;
389 | }
390 |
391 | onWindowResize() {
392 | this.updateGlareSize();
393 | this.updateClientSize();
394 | }
395 |
396 | setTransition() {
397 | clearTimeout(this.transitionTimeout);
398 | this.element.style.transition = this.settings.speed + "ms " + this.settings.easing;
399 | if (this.glare) this.glareElement.style.transition = `opacity ${this.settings.speed}ms ${this.settings.easing}`;
400 |
401 | this.transitionTimeout = setTimeout(() => {
402 | this.element.style.transition = "";
403 | if (this.glare) {
404 | this.glareElement.style.transition = "";
405 | }
406 | }, this.settings.speed);
407 |
408 | }
409 |
410 | /**
411 | * Method return patched settings of instance
412 | * @param {boolean} settings.reverse - reverse the tilt direction
413 | * @param {number} settings.max - max tilt rotation (degrees)
414 | * @param {startX} settings.startX - the starting tilt on the X axis, in degrees. Default: 0
415 | * @param {startY} settings.startY - the starting tilt on the Y axis, in degrees. Default: 0
416 | * @param {number} settings.perspective - Transform perspective, the lower the more extreme the tilt gets
417 | * @param {string} settings.easing - Easing on enter/exit
418 | * @param {number} settings.scale - 2 = 200%, 1.5 = 150%, etc..
419 | * @param {number} settings.speed - Speed of the enter/exit transition
420 | * @param {boolean} settings.transition - Set a transition on enter/exit
421 | * @param {string|null} settings.axis - What axis should be disabled. Can be X or Y
422 | * @param {boolean} settings.glare - What axis should be disabled. Can be X or Y
423 | * @param {number} settings.max-glare - the maximum "glare" opacity (1 = 100%, 0.5 = 50%)
424 | * @param {boolean} settings.glare-prerender - false = VanillaTilt creates the glare elements for you, otherwise
425 | * @param {boolean} settings.full-page-listening - If true, parallax effect will listen to mouse move events on the whole document, not only the selected element
426 | * @param {string|object} settings.mouse-event-element - String selector or link to HTML-element what will be listen mouse events
427 | * @param {boolean} settings.reset - false = If the tilt effect has to be reset on exit
428 | * @param {gyroscope} settings.gyroscope - Enable tilting by deviceorientation events
429 | * @param {gyroscopeSensitivity} settings.gyroscopeSensitivity - Between 0 and 1 - The angle at which max tilt position is reached. 1 = 90deg, 0.5 = 45deg, etc..
430 | * @param {gyroscopeSamples} settings.gyroscopeSamples - How many gyroscope moves to decide the starting position.
431 | */
432 | extendSettings(settings) {
433 | let defaultSettings = {
434 | reverse: false,
435 | max: 15,
436 | startX: 0,
437 | startY: 0,
438 | perspective: 1000,
439 | easing: "cubic-bezier(.03,.98,.52,.99)",
440 | scale: 1,
441 | speed: 300,
442 | transition: true,
443 | axis: null,
444 | glare: false,
445 | "max-glare": 1,
446 | "glare-prerender": false,
447 | "full-page-listening": false,
448 | "mouse-event-element": null,
449 | reset: true,
450 | gyroscope: true,
451 | gyroscopeMinAngleX: -45,
452 | gyroscopeMaxAngleX: 45,
453 | gyroscopeMinAngleY: -45,
454 | gyroscopeMaxAngleY: 45,
455 | gyroscopeSamples: 10
456 | };
457 |
458 | let newSettings = {};
459 | for (var property in defaultSettings) {
460 | if (property in settings) {
461 | newSettings[property] = settings[property];
462 | } else if (this.element.hasAttribute("data-tilt-" + property)) {
463 | let attribute = this.element.getAttribute("data-tilt-" + property);
464 | try {
465 | newSettings[property] = JSON.parse(attribute);
466 | } catch (e) {
467 | newSettings[property] = attribute;
468 | }
469 |
470 | } else {
471 | newSettings[property] = defaultSettings[property];
472 | }
473 | }
474 |
475 | return newSettings;
476 | }
477 |
478 | static init(elements, settings) {
479 | if (elements instanceof Node) {
480 | elements = [elements];
481 | }
482 |
483 | if (elements instanceof NodeList) {
484 | elements = [].slice.call(elements);
485 | }
486 |
487 | if (!(elements instanceof Array)) {
488 | return;
489 | }
490 |
491 | elements.forEach((element) => {
492 | if (!("vanillaTilt" in element)) {
493 | element.vanillaTilt = new VanillaTilt(element, settings);
494 | }
495 | });
496 | }
497 | }
498 |
499 | if (typeof document !== "undefined") {
500 | /* expose the class to window */
501 | window.VanillaTilt = VanillaTilt;
502 |
503 | /**
504 | * Auto load
505 | */
506 | VanillaTilt.init(document.querySelectorAll("[data-tilt]"));
507 | }
508 |
509 | return VanillaTilt;
510 |
511 | }());
512 |
--------------------------------------------------------------------------------
20 |
24 |
21 | 🎉 {{ site.data.contributions.devs | size }} developers who contributed to this open source project for the first time 🎉
22 |
23 |