/* Copyright (c) 2012, 2014 Hyunje Alex Jun and other contributors * Licensed under the MIT License */ (function (factory) { 'use strict'; if (typeof define === 'function' && define.amd) { // AMD. Register as an anonymous module. define(['jquery'], factory); } else if (typeof exports === 'object') { // Node/CommonJS factory(require('jquery')); } else { // Browser globals factory(jQuery); } }(function ($) { 'use strict'; // helper functions function int(x) { if (typeof x === 'string') { return parseInt(x, 10); } else { return ~~x; } } // The default settings for the plugin var defaultSettings = { wheelSpeed: 1, wheelPropagation: false, minScrollbarLength: null, maxScrollbarLength: null, useBothWheelAxes: false, useKeyboard: true, suppressScrollX: false, suppressScrollY: false, scrollXMarginOffset: 0, scrollYMarginOffset: 0, includePadding: false }; var getEventClassName = (function () { var incrementingId = 0; return function () { var id = incrementingId; incrementingId += 1; return '.perfect-scrollbar-' + id; }; })(); $.fn.perfectScrollbar = function (suppliedSettings, option) { return this.each(function () { // Use the default settings var settings = $.extend(true, {}, defaultSettings); var $this = $(this); if (typeof suppliedSettings === "object") { // But override any supplied $.extend(true, settings, suppliedSettings); } else { // If no setting was supplied, then the first param must be the option option = suppliedSettings; } // Catch options if (option === 'update') { if ($this.data('perfect-scrollbar-update')) { $this.data('perfect-scrollbar-update')(); } return $this; } else if (option === 'destroy') { if ($this.data('perfect-scrollbar-destroy')) { $this.data('perfect-scrollbar-destroy')(); } return $this; } if ($this.data('perfect-scrollbar')) { // if there's already perfect-scrollbar return $this.data('perfect-scrollbar'); } // Or generate new perfectScrollbar $this.addClass('ps-container'); var $scrollbarXRail = $("
").appendTo($this); var $scrollbarYRail = $("
").appendTo($this); var $scrollbarX = $("
").appendTo($scrollbarXRail); var $scrollbarY = $("
").appendTo($scrollbarYRail); var scrollbarXActive; var scrollbarYActive; var containerWidth; var containerHeight; var contentWidth; var contentHeight; var scrollbarXWidth; var scrollbarXLeft; var scrollbarXBottom = int($scrollbarXRail.css('bottom')); var isScrollbarXUsingBottom = scrollbarXBottom === scrollbarXBottom; // !isNaN var scrollbarXTop = isScrollbarXUsingBottom ? null : int($scrollbarXRail.css('top')); var scrollbarYHeight; var scrollbarYTop; var scrollbarYRight = int($scrollbarYRail.css('right')); var isScrollbarYUsingRight = scrollbarYRight === scrollbarYRight; // !isNaN var scrollbarYLeft = isScrollbarYUsingRight ? null : int($scrollbarYRail.css('left')); var isRtl = $this.css('direction') === "rtl"; var eventClassName = getEventClassName(); var railBorderXWidth = int($scrollbarXRail.css('borderLeftWidth')) + int($scrollbarXRail.css('borderRightWidth')); var railBorderYWidth = int($scrollbarXRail.css('borderTopWidth')) + int($scrollbarXRail.css('borderBottomWidth')); var updateContentScrollTop = function (currentTop, deltaY) { var newTop = currentTop + deltaY; var maxTop = containerHeight - scrollbarYHeight; if (newTop < 0) { scrollbarYTop = 0; } else if (newTop > maxTop) { scrollbarYTop = maxTop; } else { scrollbarYTop = newTop; } var scrollTop = int(scrollbarYTop * (contentHeight - containerHeight) / (containerHeight - scrollbarYHeight)); $this.scrollTop(scrollTop); }; var updateContentScrollLeft = function (currentLeft, deltaX) { var newLeft = currentLeft + deltaX; var maxLeft = containerWidth - scrollbarXWidth; if (newLeft < 0) { scrollbarXLeft = 0; } else if (newLeft > maxLeft) { scrollbarXLeft = maxLeft; } else { scrollbarXLeft = newLeft; } var scrollLeft = int(scrollbarXLeft * (contentWidth - containerWidth) / (containerWidth - scrollbarXWidth)); $this.scrollLeft(scrollLeft); }; var getSettingsAdjustedThumbSize = function (thumbSize) { if (settings.minScrollbarLength) { thumbSize = Math.max(thumbSize, settings.minScrollbarLength); } if (settings.maxScrollbarLength) { thumbSize = Math.min(thumbSize, settings.maxScrollbarLength); } return thumbSize; }; var updateScrollbarCss = function () { var scrollbarXStyles = { width: containerWidth, display: scrollbarXActive ? "inherit" : "none" }; if (isRtl) { scrollbarXStyles.left = $this.scrollLeft() + containerWidth - contentWidth; } else { scrollbarXStyles.left = $this.scrollLeft(); } if (isScrollbarXUsingBottom) { scrollbarXStyles.bottom = scrollbarXBottom - $this.scrollTop(); } else { scrollbarXStyles.top = scrollbarXTop + $this.scrollTop(); } $scrollbarXRail.css(scrollbarXStyles); var scrollbarYStyles = { top: $this.scrollTop(), height: containerHeight, display: scrollbarYActive ? "inherit" : "none" }; if (isScrollbarYUsingRight) { if (isRtl) { scrollbarYStyles.right = contentWidth - $this.scrollLeft() - scrollbarYRight - $scrollbarY.outerWidth(); } else { scrollbarYStyles.right = scrollbarYRight - $this.scrollLeft(); } } else { if (isRtl) { scrollbarYStyles.left = $this.scrollLeft() + containerWidth * 2 - contentWidth - scrollbarYLeft - $scrollbarY.outerWidth(); } else { scrollbarYStyles.left = scrollbarYLeft + $this.scrollLeft(); } } $scrollbarYRail.css(scrollbarYStyles); $scrollbarX.css({ left: scrollbarXLeft, width: scrollbarXWidth - railBorderXWidth }); $scrollbarY.css({ top: scrollbarYTop, height: scrollbarYHeight - railBorderYWidth }); if (scrollbarXActive) { $this.addClass('ps-active-x'); } else { $this.removeClass('ps-active-x'); } if (scrollbarYActive) { $this.addClass('ps-active-y'); } else { $this.removeClass('ps-active-y'); } }; var updateBarSizeAndPosition = function () { // Hide scrollbars not to affect scrollWidth and scrollHeight $scrollbarXRail.hide(); $scrollbarYRail.hide(); containerWidth = settings.includePadding ? $this.innerWidth() : $this.width(); containerHeight = settings.includePadding ? $this.innerHeight() : $this.height(); contentWidth = $this.prop('scrollWidth'); contentHeight = $this.prop('scrollHeight'); if (!settings.suppressScrollX && containerWidth + settings.scrollXMarginOffset < contentWidth) { scrollbarXActive = true; scrollbarXWidth = getSettingsAdjustedThumbSize(int(containerWidth * containerWidth / contentWidth)); scrollbarXLeft = int($this.scrollLeft() * (containerWidth - scrollbarXWidth) / (contentWidth - containerWidth)); } else { scrollbarXActive = false; scrollbarXWidth = 0; scrollbarXLeft = 0; $this.scrollLeft(0); } if (!settings.suppressScrollY && containerHeight + settings.scrollYMarginOffset < contentHeight) { scrollbarYActive = true; scrollbarYHeight = getSettingsAdjustedThumbSize(int(containerHeight * containerHeight / contentHeight)); scrollbarYTop = int($this.scrollTop() * (containerHeight - scrollbarYHeight) / (contentHeight - containerHeight)); } else { scrollbarYActive = false; scrollbarYHeight = 0; scrollbarYTop = 0; $this.scrollTop(0); } if (scrollbarYTop >= containerHeight - scrollbarYHeight) { scrollbarYTop = containerHeight - scrollbarYHeight; } if (scrollbarXLeft >= containerWidth - scrollbarXWidth) { scrollbarXLeft = containerWidth - scrollbarXWidth; } updateScrollbarCss(); // Show scrollbars if needed after updated if (!settings.suppressScrollX) { $scrollbarXRail.show(); } if (!settings.suppressScrollY) { $scrollbarYRail.show(); } }; var bindMouseScrollXHandler = function () { var currentLeft; var currentPageX; $scrollbarX.bind('mousedown' + eventClassName, function (e) { currentPageX = e.pageX; currentLeft = $scrollbarX.position().left; $scrollbarXRail.addClass('in-scrolling'); e.stopPropagation(); e.preventDefault(); }); $(document).bind('mousemove' + eventClassName, function (e) { if ($scrollbarXRail.hasClass('in-scrolling')) { updateContentScrollLeft(currentLeft, e.pageX - currentPageX); updateBarSizeAndPosition(); e.stopPropagation(); e.preventDefault(); } }); $(document).bind('mouseup' + eventClassName, function (e) { if ($scrollbarXRail.hasClass('in-scrolling')) { $scrollbarXRail.removeClass('in-scrolling'); } }); currentLeft = currentPageX = null; }; var bindMouseScrollYHandler = function () { var currentTop; var currentPageY; $scrollbarY.bind('mousedown' + eventClassName, function (e) { currentPageY = e.pageY; currentTop = $scrollbarY.position().top; $scrollbarYRail.addClass('in-scrolling'); e.stopPropagation(); e.preventDefault(); }); $(document).bind('mousemove' + eventClassName, function (e) { if ($scrollbarYRail.hasClass('in-scrolling')) { updateContentScrollTop(currentTop, e.pageY - currentPageY); updateBarSizeAndPosition(); e.stopPropagation(); e.preventDefault(); } }); $(document).bind('mouseup' + eventClassName, function (e) { if ($scrollbarYRail.hasClass('in-scrolling')) { $scrollbarYRail.removeClass('in-scrolling'); } }); currentTop = currentPageY = null; }; // check if the default scrolling should be prevented. var shouldPreventDefault = function (deltaX, deltaY) { var scrollTop = $this.scrollTop(); if (deltaX === 0) { if (!scrollbarYActive) { return false; } if ((scrollTop === 0 && deltaY > 0) || (scrollTop >= contentHeight - containerHeight && deltaY < 0)) { return !settings.wheelPropagation; } } var scrollLeft = $this.scrollLeft(); if (deltaY === 0) { if (!scrollbarXActive) { return false; } if ((scrollLeft === 0 && deltaX < 0) || (scrollLeft >= contentWidth - containerWidth && deltaX > 0)) { return !settings.wheelPropagation; } } return true; }; // bind handlers var bindMouseWheelHandler = function () { var shouldPrevent = false; var getDeltaFromEvent = function (e) { var deltaX = e.originalEvent.deltaX; var deltaY = -1 * e.originalEvent.deltaY; if (typeof deltaX === "undefined" || typeof deltaY === "undefined") { // OS X Safari deltaX = -1 * e.originalEvent.wheelDeltaX / 6; deltaY = e.originalEvent.wheelDeltaY / 6; } if (e.originalEvent.deltaMode && e.originalEvent.deltaMode === 1) { // Firefox in deltaMode 1: Line scrolling deltaX *= 10; deltaY *= 10; } if (deltaX !== deltaX && deltaY !== deltaY/* NaN checks */) { // IE in some mouse drivers deltaX = 0; deltaY = e.originalEvent.wheelDelta; } return [deltaX, deltaY]; }; var mousewheelHandler = function (e) { var delta = getDeltaFromEvent(e); var deltaX = delta[0]; var deltaY = delta[1]; shouldPrevent = false; if (!settings.useBothWheelAxes) { // deltaX will only be used for horizontal scrolling and deltaY will // only be used for vertical scrolling - this is the default $this.scrollTop($this.scrollTop() - (deltaY * settings.wheelSpeed)); $this.scrollLeft($this.scrollLeft() + (deltaX * settings.wheelSpeed)); } else if (scrollbarYActive && !scrollbarXActive) { // only vertical scrollbar is active and useBothWheelAxes option is // active, so let's scroll vertical bar using both mouse wheel axes if (deltaY) { $this.scrollTop($this.scrollTop() - (deltaY * settings.wheelSpeed)); } else { $this.scrollTop($this.scrollTop() + (deltaX * settings.wheelSpeed)); } shouldPrevent = true; } else if (scrollbarXActive && !scrollbarYActive) { // useBothWheelAxes and only horizontal bar is active, so use both // wheel axes for horizontal bar if (deltaX) { $this.scrollLeft($this.scrollLeft() + (deltaX * settings.wheelSpeed)); } else { $this.scrollLeft($this.scrollLeft() - (deltaY * settings.wheelSpeed)); } shouldPrevent = true; } // update bar position updateBarSizeAndPosition(); shouldPrevent = (shouldPrevent || shouldPreventDefault(deltaX, deltaY)); if (shouldPrevent) { e.stopPropagation(); e.preventDefault(); } }; if (typeof window.onwheel !== "undefined") { $this.bind('wheel' + eventClassName, mousewheelHandler); } else if (typeof window.onmousewheel !== "undefined") { $this.bind('mousewheel' + eventClassName, mousewheelHandler); } }; var bindKeyboardHandler = function () { var hovered = false; $this.bind('mouseenter' + eventClassName, function (e) { hovered = true; }); $this.bind('mouseleave' + eventClassName, function (e) { hovered = false; }); var shouldPrevent = false; $(document).bind('keydown' + eventClassName, function (e) { if (e.isDefaultPrevented && e.isDefaultPrevented()) { return; } if (!hovered || $(document.activeElement).is(":input,[contenteditable]")) { return; } var deltaX = 0; var deltaY = 0; switch (e.which) { case 37: // left deltaX = -30; break; case 38: // up deltaY = 30; break; case 39: // right deltaX = 30; break; case 40: // down deltaY = -30; break; case 33: // page up deltaY = 90; break; case 32: // space bar case 34: // page down deltaY = -90; break; case 35: // end deltaY = -containerHeight; break; case 36: // home deltaY = containerHeight; break; default: return; } $this.scrollTop($this.scrollTop() - deltaY); $this.scrollLeft($this.scrollLeft() + deltaX); shouldPrevent = shouldPreventDefault(deltaX, deltaY); if (shouldPrevent) { e.preventDefault(); } }); }; var bindRailClickHandler = function () { var stopPropagation = function (e) { e.stopPropagation(); }; $scrollbarY.bind('click' + eventClassName, stopPropagation); $scrollbarYRail.bind('click' + eventClassName, function (e) { var halfOfScrollbarLength = int(scrollbarYHeight / 2); var positionTop = e.pageY - $scrollbarYRail.offset().top - halfOfScrollbarLength; var maxPositionTop = containerHeight - scrollbarYHeight; var positionRatio = positionTop / maxPositionTop; if (positionRatio < 0) { positionRatio = 0; } else if (positionRatio > 1) { positionRatio = 1; } $this.scrollTop((contentHeight - containerHeight) * positionRatio); }); $scrollbarX.bind('click' + eventClassName, stopPropagation); $scrollbarXRail.bind('click' + eventClassName, function (e) { var halfOfScrollbarLength = int(scrollbarXWidth / 2); var positionLeft = e.pageX - $scrollbarXRail.offset().left - halfOfScrollbarLength; var maxPositionLeft = containerWidth - scrollbarXWidth; var positionRatio = positionLeft / maxPositionLeft; if (positionRatio < 0) { positionRatio = 0; } else if (positionRatio > 1) { positionRatio = 1; } $this.scrollLeft((contentWidth - containerWidth) * positionRatio); }); }; // bind mobile touch handler var bindMobileTouchHandler = function () { var applyTouchMove = function (differenceX, differenceY) { $this.scrollTop($this.scrollTop() - differenceY); $this.scrollLeft($this.scrollLeft() - differenceX); // update bar position updateBarSizeAndPosition(); }; var startCoords = {}; var startTime = 0; var speed = {}; var breakingProcess = null; var inGlobalTouch = false; $(window).bind("touchstart" + eventClassName, function (e) { inGlobalTouch = true; }); $(window).bind("touchend" + eventClassName, function (e) { inGlobalTouch = false; }); $this.bind("touchstart" + eventClassName, function (e) { var touch = e.originalEvent.targetTouches[0]; startCoords.pageX = touch.pageX; startCoords.pageY = touch.pageY; startTime = (new Date()).getTime(); if (breakingProcess !== null) { clearInterval(breakingProcess); } e.stopPropagation(); }); $this.bind("touchmove" + eventClassName, function (e) { if (!inGlobalTouch && e.originalEvent.targetTouches.length === 1) { var touch = e.originalEvent.targetTouches[0]; var currentCoords = {}; currentCoords.pageX = touch.pageX; currentCoords.pageY = touch.pageY; var differenceX = currentCoords.pageX - startCoords.pageX; var differenceY = currentCoords.pageY - startCoords.pageY; applyTouchMove(differenceX, differenceY); startCoords = currentCoords; var currentTime = (new Date()).getTime(); var timeGap = currentTime - startTime; if (timeGap > 0) { speed.x = differenceX / timeGap; speed.y = differenceY / timeGap; startTime = currentTime; } e.preventDefault(); } }); $this.bind("touchend" + eventClassName, function (e) { clearInterval(breakingProcess); breakingProcess = setInterval(function () { if (Math.abs(speed.x) < 0.01 && Math.abs(speed.y) < 0.01) { clearInterval(breakingProcess); return; } applyTouchMove(speed.x * 30, speed.y * 30); speed.x *= 0.8; speed.y *= 0.8; }, 10); }); }; var bindScrollHandler = function () { $this.bind('scroll' + eventClassName, function (e) { updateBarSizeAndPosition(); }); }; var destroy = function () { $this.unbind(eventClassName); $(window).unbind(eventClassName); $(document).unbind(eventClassName); $this.data('perfect-scrollbar', null); $this.data('perfect-scrollbar-update', null); $this.data('perfect-scrollbar-destroy', null); $scrollbarX.remove(); $scrollbarY.remove(); $scrollbarXRail.remove(); $scrollbarYRail.remove(); // clean all variables $scrollbarXRail = $scrollbarYRail = $scrollbarX = $scrollbarY = scrollbarXActive = scrollbarYActive = containerWidth = containerHeight = contentWidth = contentHeight = scrollbarXWidth = scrollbarXLeft = scrollbarXBottom = isScrollbarXUsingBottom = scrollbarXTop = scrollbarYHeight = scrollbarYTop = scrollbarYRight = isScrollbarYUsingRight = scrollbarYLeft = isRtl = eventClassName = null; }; var ieSupport = function (version) { $this.addClass('ie').addClass('ie' + version); var bindHoverHandlers = function () { var mouseenter = function () { $(this).addClass('hover'); }; var mouseleave = function () { $(this).removeClass('hover'); }; $this.bind('mouseenter' + eventClassName, mouseenter).bind('mouseleave' + eventClassName, mouseleave); $scrollbarXRail.bind('mouseenter' + eventClassName, mouseenter).bind('mouseleave' + eventClassName, mouseleave); $scrollbarYRail.bind('mouseenter' + eventClassName, mouseenter).bind('mouseleave' + eventClassName, mouseleave); $scrollbarX.bind('mouseenter' + eventClassName, mouseenter).bind('mouseleave' + eventClassName, mouseleave); $scrollbarY.bind('mouseenter' + eventClassName, mouseenter).bind('mouseleave' + eventClassName, mouseleave); }; var fixIe6ScrollbarPosition = function () { updateScrollbarCss = function () { var scrollbarXStyles = { left: scrollbarXLeft + $this.scrollLeft(), width: scrollbarXWidth }; if (isScrollbarXUsingBottom) { scrollbarXStyles.bottom = scrollbarXBottom; } else { scrollbarXStyles.top = scrollbarXTop; } $scrollbarX.css(scrollbarXStyles); var scrollbarYStyles = { top: scrollbarYTop + $this.scrollTop(), height: scrollbarYHeight }; if (isScrollbarYUsingRight) { scrollbarYStyles.right = scrollbarYRight; } else { scrollbarYStyles.left = scrollbarYLeft; } $scrollbarY.css(scrollbarYStyles); $scrollbarX.hide().show(); $scrollbarY.hide().show(); }; }; if (version === 6) { bindHoverHandlers(); fixIe6ScrollbarPosition(); } }; var supportsTouch = (('ontouchstart' in window) || window.DocumentTouch && document instanceof window.DocumentTouch); var initialize = function () { var ieMatch = navigator.userAgent.toLowerCase().match(/(msie) ([\w.]+)/); if (ieMatch && ieMatch[1] === 'msie') { // must be executed at first, because 'ieSupport' may addClass to the container ieSupport(int(ieMatch[2])); } updateBarSizeAndPosition(); bindScrollHandler(); bindMouseScrollXHandler(); bindMouseScrollYHandler(); bindRailClickHandler(); bindMouseWheelHandler(); if (supportsTouch) { bindMobileTouchHandler(); } if (settings.useKeyboard) { bindKeyboardHandler(); } $this.data('perfect-scrollbar', $this); $this.data('perfect-scrollbar-update', updateBarSizeAndPosition); $this.data('perfect-scrollbar-destroy', destroy); }; // initialize initialize(); return $this; }); }; }));