/*!
|
|
* Angular Material Design
|
|
* https://github.com/angular/material
|
|
* @license MIT
|
|
* v1.1.3
|
|
*/
|
|
(function( window, angular, undefined ){
|
|
"use strict";
|
|
|
|
/**
|
|
* @ngdoc module
|
|
* @name material.components.progressCircular
|
|
* @description Module for a circular progressbar
|
|
*/
|
|
|
|
angular.module('material.components.progressCircular', ['material.core']);
|
|
|
|
/**
|
|
* @ngdoc directive
|
|
* @name mdProgressCircular
|
|
* @module material.components.progressCircular
|
|
* @restrict E
|
|
*
|
|
* @description
|
|
* The circular progress directive is used to make loading content in your app as delightful and
|
|
* painless as possible by minimizing the amount of visual change a user sees before they can view
|
|
* and interact with content.
|
|
*
|
|
* For operations where the percentage of the operation completed can be determined, use a
|
|
* determinate indicator. They give users a quick sense of how long an operation will take.
|
|
*
|
|
* For operations where the user is asked to wait a moment while something finishes up, and it’s
|
|
* not necessary to expose what's happening behind the scenes and how long it will take, use an
|
|
* indeterminate indicator.
|
|
*
|
|
* @param {string} md-mode Select from one of two modes: **'determinate'** and **'indeterminate'**.
|
|
*
|
|
* Note: if the `md-mode` value is set as undefined or specified as not 1 of the two (2) valid modes, then **'indeterminate'**
|
|
* will be auto-applied as the mode.
|
|
*
|
|
* Note: if not configured, the `md-mode="indeterminate"` will be auto injected as an attribute.
|
|
* If `value=""` is also specified, however, then `md-mode="determinate"` would be auto-injected instead.
|
|
* @param {number=} value In determinate mode, this number represents the percentage of the
|
|
* circular progress. Default: 0
|
|
* @param {number=} md-diameter This specifies the diameter of the circular progress. The value
|
|
* should be a pixel-size value (eg '100'). If this attribute is
|
|
* not present then a default value of '50px' is assumed.
|
|
*
|
|
* @param {boolean=} ng-disabled Determines whether to disable the progress element.
|
|
*
|
|
* @usage
|
|
* <hljs lang="html">
|
|
* <md-progress-circular md-mode="determinate" value="..."></md-progress-circular>
|
|
*
|
|
* <md-progress-circular md-mode="determinate" ng-value="..."></md-progress-circular>
|
|
*
|
|
* <md-progress-circular md-mode="determinate" value="..." md-diameter="100"></md-progress-circular>
|
|
*
|
|
* <md-progress-circular md-mode="indeterminate"></md-progress-circular>
|
|
* </hljs>
|
|
*/
|
|
|
|
MdProgressCircularDirective['$inject'] = ["$window", "$mdProgressCircular", "$mdTheming", "$mdUtil", "$interval", "$log"];
|
|
angular
|
|
.module('material.components.progressCircular')
|
|
.directive('mdProgressCircular', MdProgressCircularDirective);
|
|
|
|
/* ngInject */
|
|
function MdProgressCircularDirective($window, $mdProgressCircular, $mdTheming,
|
|
$mdUtil, $interval, $log) {
|
|
|
|
// Note that this shouldn't use use $$rAF, because it can cause an infinite loop
|
|
// in any tests that call $animate.flush.
|
|
var rAF = $window.requestAnimationFrame ||
|
|
$window.webkitRequestAnimationFrame ||
|
|
angular.noop;
|
|
|
|
var cAF = $window.cancelAnimationFrame ||
|
|
$window.webkitCancelAnimationFrame ||
|
|
$window.webkitCancelRequestAnimationFrame ||
|
|
angular.noop;
|
|
|
|
var MODE_DETERMINATE = 'determinate';
|
|
var MODE_INDETERMINATE = 'indeterminate';
|
|
var DISABLED_CLASS = '_md-progress-circular-disabled';
|
|
var INDETERMINATE_CLASS = 'md-mode-indeterminate';
|
|
|
|
return {
|
|
restrict: 'E',
|
|
scope: {
|
|
value: '@',
|
|
mdDiameter: '@',
|
|
mdMode: '@'
|
|
},
|
|
template:
|
|
'<svg xmlns="http://www.w3.org/2000/svg">' +
|
|
'<path fill="none"/>' +
|
|
'</svg>',
|
|
compile: function(element, attrs) {
|
|
element.attr({
|
|
'aria-valuemin': 0,
|
|
'aria-valuemax': 100,
|
|
'role': 'progressbar'
|
|
});
|
|
|
|
if (angular.isUndefined(attrs.mdMode)) {
|
|
var mode = attrs.hasOwnProperty('value') ? MODE_DETERMINATE : MODE_INDETERMINATE;
|
|
attrs.$set('mdMode', mode);
|
|
} else {
|
|
attrs.$set('mdMode', attrs.mdMode.trim());
|
|
}
|
|
|
|
return MdProgressCircularLink;
|
|
}
|
|
};
|
|
|
|
function MdProgressCircularLink(scope, element, attrs) {
|
|
var node = element[0];
|
|
var svg = angular.element(node.querySelector('svg'));
|
|
var path = angular.element(node.querySelector('path'));
|
|
var startIndeterminate = $mdProgressCircular.startIndeterminate;
|
|
var endIndeterminate = $mdProgressCircular.endIndeterminate;
|
|
var iterationCount = 0;
|
|
var lastAnimationId = 0;
|
|
var lastDrawFrame;
|
|
var interval;
|
|
|
|
$mdTheming(element);
|
|
element.toggleClass(DISABLED_CLASS, attrs.hasOwnProperty('disabled'));
|
|
|
|
// If the mode is indeterminate, it doesn't need to
|
|
// wait for the next digest. It can start right away.
|
|
if(scope.mdMode === MODE_INDETERMINATE){
|
|
startIndeterminateAnimation();
|
|
}
|
|
|
|
scope.$on('$destroy', function(){
|
|
cleanupIndeterminateAnimation();
|
|
|
|
if (lastDrawFrame) {
|
|
cAF(lastDrawFrame);
|
|
}
|
|
});
|
|
|
|
scope.$watchGroup(['value', 'mdMode', function() {
|
|
var isDisabled = node.disabled;
|
|
|
|
// Sometimes the browser doesn't return a boolean, in
|
|
// which case we should check whether the attribute is
|
|
// present.
|
|
if (isDisabled === true || isDisabled === false){
|
|
return isDisabled;
|
|
}
|
|
|
|
return angular.isDefined(element.attr('disabled'));
|
|
}], function(newValues, oldValues) {
|
|
var mode = newValues[1];
|
|
var isDisabled = newValues[2];
|
|
var wasDisabled = oldValues[2];
|
|
|
|
if (isDisabled !== wasDisabled) {
|
|
element.toggleClass(DISABLED_CLASS, !!isDisabled);
|
|
}
|
|
|
|
if (isDisabled) {
|
|
cleanupIndeterminateAnimation();
|
|
} else {
|
|
if (mode !== MODE_DETERMINATE && mode !== MODE_INDETERMINATE) {
|
|
mode = MODE_INDETERMINATE;
|
|
attrs.$set('mdMode', mode);
|
|
}
|
|
|
|
if (mode === MODE_INDETERMINATE) {
|
|
startIndeterminateAnimation();
|
|
} else {
|
|
var newValue = clamp(newValues[0]);
|
|
|
|
cleanupIndeterminateAnimation();
|
|
|
|
element.attr('aria-valuenow', newValue);
|
|
renderCircle(clamp(oldValues[0]), newValue);
|
|
}
|
|
}
|
|
|
|
});
|
|
|
|
// This is in a separate watch in order to avoid layout, unless
|
|
// the value has actually changed.
|
|
scope.$watch('mdDiameter', function(newValue) {
|
|
var diameter = getSize(newValue);
|
|
var strokeWidth = getStroke(diameter);
|
|
var value = clamp(scope.value);
|
|
var transformOrigin = (diameter / 2) + 'px';
|
|
var dimensions = {
|
|
width: diameter + 'px',
|
|
height: diameter + 'px'
|
|
};
|
|
|
|
// The viewBox has to be applied via setAttribute, because it is
|
|
// case-sensitive. If jQuery is included in the page, `.attr` lowercases
|
|
// all attribute names.
|
|
svg[0].setAttribute('viewBox', '0 0 ' + diameter + ' ' + diameter);
|
|
|
|
// Usually viewBox sets the dimensions for the SVG, however that doesn't
|
|
// seem to be the case on IE10.
|
|
// Important! The transform origin has to be set from here and it has to
|
|
// be in the format of "Ypx Ypx Ypx", otherwise the rotation wobbles in
|
|
// IE and Edge, because they don't account for the stroke width when
|
|
// rotating. Also "center" doesn't help in this case, it has to be a
|
|
// precise value.
|
|
svg
|
|
.css(dimensions)
|
|
.css('transform-origin', transformOrigin + ' ' + transformOrigin + ' ' + transformOrigin);
|
|
|
|
element.css(dimensions);
|
|
|
|
path.attr('stroke-width', strokeWidth);
|
|
path.attr('stroke-linecap', 'square');
|
|
if (scope.mdMode == MODE_INDETERMINATE) {
|
|
path.attr('d', getSvgArc(diameter, strokeWidth, true));
|
|
path.attr('stroke-dasharray', (diameter - strokeWidth) * $window.Math.PI * 0.75);
|
|
path.attr('stroke-dashoffset', getDashLength(diameter, strokeWidth, 1, 75));
|
|
} else {
|
|
path.attr('d', getSvgArc(diameter, strokeWidth, false));
|
|
path.attr('stroke-dasharray', (diameter - strokeWidth) * $window.Math.PI);
|
|
path.attr('stroke-dashoffset', getDashLength(diameter, strokeWidth, 0, 100));
|
|
renderCircle(value, value);
|
|
}
|
|
|
|
});
|
|
|
|
function renderCircle(animateFrom, animateTo, easing, duration, iterationCount, maxValue) {
|
|
var id = ++lastAnimationId;
|
|
var startTime = $mdUtil.now();
|
|
var changeInValue = animateTo - animateFrom;
|
|
var diameter = getSize(scope.mdDiameter);
|
|
var strokeWidth = getStroke(diameter);
|
|
var ease = easing || $mdProgressCircular.easeFn;
|
|
var animationDuration = duration || $mdProgressCircular.duration;
|
|
var rotation = -90 * (iterationCount || 0);
|
|
var dashLimit = maxValue || 100;
|
|
|
|
// No need to animate it if the values are the same
|
|
if (animateTo === animateFrom) {
|
|
renderFrame(animateTo);
|
|
} else {
|
|
lastDrawFrame = rAF(function animation() {
|
|
var currentTime = $window.Math.max(0, $window.Math.min($mdUtil.now() - startTime, animationDuration));
|
|
|
|
renderFrame(ease(currentTime, animateFrom, changeInValue, animationDuration));
|
|
|
|
// Do not allow overlapping animations
|
|
if (id === lastAnimationId && currentTime < animationDuration) {
|
|
lastDrawFrame = rAF(animation);
|
|
}
|
|
});
|
|
}
|
|
|
|
function renderFrame(value) {
|
|
path.attr('stroke-dashoffset', getDashLength(diameter, strokeWidth, value, dashLimit));
|
|
path.attr('transform','rotate(' + (rotation) + ' ' + diameter/2 + ' ' + diameter/2 + ')');
|
|
}
|
|
}
|
|
|
|
function animateIndeterminate() {
|
|
renderCircle(
|
|
startIndeterminate,
|
|
endIndeterminate,
|
|
$mdProgressCircular.easeFnIndeterminate,
|
|
$mdProgressCircular.durationIndeterminate,
|
|
iterationCount,
|
|
75
|
|
);
|
|
|
|
// The %4 technically isn't necessary, but it keeps the rotation
|
|
// under 360, instead of becoming a crazy large number.
|
|
iterationCount = ++iterationCount % 4;
|
|
|
|
}
|
|
|
|
function startIndeterminateAnimation() {
|
|
if (!interval) {
|
|
// Note that this interval isn't supposed to trigger a digest.
|
|
interval = $interval(
|
|
animateIndeterminate,
|
|
$mdProgressCircular.durationIndeterminate,
|
|
0,
|
|
false
|
|
);
|
|
|
|
animateIndeterminate();
|
|
|
|
element
|
|
.addClass(INDETERMINATE_CLASS)
|
|
.removeAttr('aria-valuenow');
|
|
}
|
|
}
|
|
|
|
function cleanupIndeterminateAnimation() {
|
|
if (interval) {
|
|
$interval.cancel(interval);
|
|
interval = null;
|
|
element.removeClass(INDETERMINATE_CLASS);
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns SVG path data for progress circle
|
|
* Syntax spec: https://www.w3.org/TR/SVG/paths.html#PathDataEllipticalArcCommands
|
|
*
|
|
* @param {number} diameter Diameter of the container.
|
|
* @param {number} strokeWidth Stroke width to be used when drawing circle
|
|
* @param {boolean} indeterminate Use if progress circle will be used for indeterminate
|
|
*
|
|
* @returns {string} String representation of an SVG arc.
|
|
*/
|
|
function getSvgArc(diameter, strokeWidth, indeterminate) {
|
|
var radius = diameter / 2;
|
|
var offset = strokeWidth / 2;
|
|
var start = radius + ',' + offset; // ie: (25, 2.5) or 12 o'clock
|
|
var end = offset + ',' + radius; // ie: (2.5, 25) or 9 o'clock
|
|
var arcRadius = radius - offset;
|
|
return 'M' + start
|
|
+ 'A' + arcRadius + ',' + arcRadius + ' 0 1 1 ' + end // 75% circle
|
|
+ (indeterminate ? '' : 'A' + arcRadius + ',' + arcRadius + ' 0 0 1 ' + start); // loop to start
|
|
}
|
|
|
|
/**
|
|
* Return stroke length for progress circle
|
|
*
|
|
* @param {number} diameter Diameter of the container.
|
|
* @param {number} strokeWidth Stroke width to be used when drawing circle
|
|
* @param {number} value Percentage of circle (between 0 and 100)
|
|
* @param {number} limit Max percentage for circle
|
|
*
|
|
* @returns {number} Stroke length for progres circle
|
|
*/
|
|
function getDashLength(diameter, strokeWidth, value, limit) {
|
|
return (diameter - strokeWidth) * $window.Math.PI * ( (3 * (limit || 100) / 100) - (value/100) );
|
|
}
|
|
|
|
/**
|
|
* Limits a value between 0 and 100.
|
|
*/
|
|
function clamp(value) {
|
|
return $window.Math.max(0, $window.Math.min(value || 0, 100));
|
|
}
|
|
|
|
/**
|
|
* Determines the size of a progress circle, based on the provided
|
|
* value in the following formats: `X`, `Ypx`, `Z%`.
|
|
*/
|
|
function getSize(value) {
|
|
var defaultValue = $mdProgressCircular.progressSize;
|
|
|
|
if (value) {
|
|
var parsed = parseFloat(value);
|
|
|
|
if (value.lastIndexOf('%') === value.length - 1) {
|
|
parsed = (parsed / 100) * defaultValue;
|
|
}
|
|
|
|
return parsed;
|
|
}
|
|
|
|
return defaultValue;
|
|
}
|
|
|
|
/**
|
|
* Determines the circle's stroke width, based on
|
|
* the provided diameter.
|
|
*/
|
|
function getStroke(diameter) {
|
|
return $mdProgressCircular.strokeWidth / 100 * diameter;
|
|
}
|
|
|
|
}
|
|
|
|
/**
|
|
* @ngdoc service
|
|
* @name $mdProgressCircular
|
|
* @module material.components.progressCircular
|
|
*
|
|
* @description
|
|
* Allows the user to specify the default options for the `progressCircular` directive.
|
|
*
|
|
* @property {number} progressSize Diameter of the progress circle in pixels.
|
|
* @property {number} strokeWidth Width of the circle's stroke as a percentage of the circle's size.
|
|
* @property {number} duration Length of the circle animation in milliseconds.
|
|
* @property {function} easeFn Default easing animation function.
|
|
* @property {object} easingPresets Collection of pre-defined easing functions.
|
|
*
|
|
* @property {number} durationIndeterminate Duration of the indeterminate animation.
|
|
* @property {number} startIndeterminate Indeterminate animation start point.
|
|
* @property {number} endIndeterminate Indeterminate animation end point.
|
|
* @property {function} easeFnIndeterminate Easing function to be used when animating
|
|
* between the indeterminate values.
|
|
*
|
|
* @property {(function(object): object)} configure Used to modify the default options.
|
|
*
|
|
* @usage
|
|
* <hljs lang="js">
|
|
* myAppModule.config(function($mdProgressCircularProvider) {
|
|
*
|
|
* // Example of changing the default progress options.
|
|
* $mdProgressCircularProvider.configure({
|
|
* progressSize: 100,
|
|
* strokeWidth: 20,
|
|
* duration: 800
|
|
* });
|
|
* });
|
|
* </hljs>
|
|
*
|
|
*/
|
|
|
|
angular
|
|
.module('material.components.progressCircular')
|
|
.provider("$mdProgressCircular", MdProgressCircularProvider);
|
|
|
|
function MdProgressCircularProvider() {
|
|
var progressConfig = {
|
|
progressSize: 50,
|
|
strokeWidth: 10,
|
|
duration: 100,
|
|
easeFn: linearEase,
|
|
|
|
durationIndeterminate: 1333,
|
|
startIndeterminate: 1,
|
|
endIndeterminate: 149,
|
|
easeFnIndeterminate: materialEase,
|
|
|
|
easingPresets: {
|
|
linearEase: linearEase,
|
|
materialEase: materialEase
|
|
}
|
|
};
|
|
|
|
return {
|
|
configure: function(options) {
|
|
progressConfig = angular.extend(progressConfig, options || {});
|
|
return progressConfig;
|
|
},
|
|
$get: function() { return progressConfig; }
|
|
};
|
|
|
|
function linearEase(t, b, c, d) {
|
|
return c * t / d + b;
|
|
}
|
|
|
|
function materialEase(t, b, c, d) {
|
|
// via http://www.timotheegroleau.com/Flash/experiments/easing_function_generator.htm
|
|
// with settings of [0, 0, 1, 1]
|
|
var ts = (t /= d) * t;
|
|
var tc = ts * t;
|
|
return b + c * (6 * tc * ts + -15 * ts * ts + 10 * tc);
|
|
}
|
|
}
|
|
|
|
})(window, window.angular);
|