Twenty Seventeen: Update the scrollTo jQuery plugin.

This updates the `scrollTo` jQuery plugin included in Twenty Seventeen to the latest version, `2.1.3`.

For a full list of changes in this update, see GitHub: https://github.com/flesler/jquery.scrollTo/compare/2.1.2...v2.1.3.

Props sarahricker, mukesh27, desrosj.
Fixes #56702.

git-svn-id: https://develop.svn.wordpress.org/trunk@54374 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
Jonathan Desrosiers 2022-10-04 01:41:59 +00:00
parent 074a0ab820
commit 5cfc851ac0
2 changed files with 53 additions and 47 deletions

View File

@ -1,29 +1,29 @@
/*!
* jQuery.scrollTo
* Copyright (c) 2007-2015 Ariel Flesler - aflesler<a>gmail<d>com | http://flesler.blogspot.com
* Copyright (c) 2007 Ariel Flesler - aflesler gmail com | https://github.com/flesler
* Licensed under MIT
* http://flesler.blogspot.com/2007/10/jqueryscrollto.html
* https://github.com/flesler/jquery.scrollTo
* @projectDescription Lightweight, cross-browser and highly customizable animated scrolling with jQuery
* @author Ariel Flesler
* @version 2.1.2
* @version 2.1.3
*/
;(function(factory) {
'use strict';
if (typeof define === 'function' && define.amd) {
// AMD
define( ['jquery'], factory );
define(['jquery'], factory);
} else if (typeof module !== 'undefined' && module.exports) {
// CommonJS
module.exports = factory( require( 'jquery' ) );
module.exports = factory(require('jquery'));
} else {
// Global
factory( jQuery );
factory(jQuery);
}
})(function($) {
'use strict';
var $scrollTo = $.scrollTo = function(target, duration, settings) {
return $( window ).scrollTo( target, duration, settings );
return $(window).scrollTo(target, duration, settings);
};
$scrollTo.defaults = {
@ -33,8 +33,13 @@
};
function isWin(elem) {
return ! elem.nodeName ||
$.inArray( elem.nodeName.toLowerCase(), ['iframe','#document','html','body'] ) !== -1;
return !elem.nodeName ||
$.inArray(elem.nodeName.toLowerCase(), ['iframe','#document','html','body']) !== -1;
}
function isFunction(obj) {
// Brought from jQuery since it's deprecated
return typeof obj === 'function'
}
$.fn.scrollTo = function(target, duration, settings) {
@ -49,7 +54,7 @@
target = 9e9;
}
settings = $.extend( {}, $scrollTo.defaults, settings );
settings = $.extend({}, $scrollTo.defaults, settings);
// Speed is still recognized for backwards compatibility
duration = duration || settings.duration;
// Make sure the settings are given right
@ -58,16 +63,16 @@
// Let's keep the overall duration
duration /= 2;
}
settings.offset = both( settings.offset );
settings.over = both( settings.over );
settings.offset = both(settings.offset);
settings.over = both(settings.over);
return this.each(function() {
// Null target yields nothing, just like jQuery does
if (target === null) { return; }
if (target === null) return;
var win = isWin( this ),
var win = isWin(this),
elem = win ? this.contentWindow || window : this,
$elem = $( elem ),
$elem = $(elem),
targ = target,
attr = {},
toff;
@ -76,39 +81,39 @@
// A number will pass the regex
case 'number':
case 'string':
if (/^([+-]=?)?\d+(\.\d+)?(px|%)?$/.test( targ )) {
targ = both( targ );
if (/^([+-]=?)?\d+(\.\d+)?(px|%)?$/.test(targ)) {
targ = both(targ);
// We are done
break;
}
// Relative/Absolute selector
targ = win ? $( targ ) : $( targ, elem );
targ = win ? $(targ) : $(targ, elem);
/* falls through */
case 'object':
if (targ.length === 0) { return; }
if (targ.length === 0) return;
// DOMElement / jQuery
if (targ.is || targ.style) {
// Get the real position of the target
toff = (targ = $( targ )).offset();
toff = (targ = $(targ)).offset();
}
}
var offset = $.isFunction( settings.offset ) && settings.offset( elem, targ ) || settings.offset;
var offset = isFunction(settings.offset) && settings.offset(elem, targ) || settings.offset;
$.each(settings.axis.split( '' ), function(i, axis) {
$.each(settings.axis.split(''), function(i, axis) {
var Pos = axis === 'x' ? 'Left' : 'Top',
pos = Pos.toLowerCase(),
key = 'scroll' + Pos,
prev = $elem[key](),
max = $scrollTo.max( elem, axis );
max = $scrollTo.max(elem, axis);
if (toff) {// jQuery / DOMElement
attr[key] = toff[pos] + (win ? 0 : prev - $elem.offset()[pos]);
// If it's a dom element, reduce the margin
if (settings.margin) {
attr[key] -= parseInt( targ.css( 'margin' + Pos ), 10 ) || 0;
attr[key] -= parseInt( targ.css( 'border' + Pos + 'Width' ), 10 ) || 0;
attr[key] -= parseInt(targ.css('margin'+Pos), 10) || 0;
attr[key] -= parseInt(targ.css('border'+Pos+'Width'), 10) || 0;
}
attr[key] += offset[pos] || 0;
@ -120,32 +125,32 @@
} else {
var val = targ[pos];
// Handle percentage values
attr[key] = val.slice && val.slice( -1 ) === '%' ?
parseFloat( val ) / 100 * max
attr[key] = val.slice && val.slice(-1) === '%' ?
parseFloat(val) / 100 * max
: val;
}
// Number or 'number'
if (settings.limit && /^\d+$/.test( attr[key] )) {
if (settings.limit && /^\d+$/.test(attr[key])) {
// Check the limits
attr[key] = attr[key] <= 0 ? 0 : Math.min( attr[key], max );
attr[key] = attr[key] <= 0 ? 0 : Math.min(attr[key], max);
}
// Don't waste time animating, if there's no need.
if ( ! i && settings.axis.length > 1) {
if (!i && settings.axis.length > 1) {
if (prev === attr[key]) {
// No animation needed
attr = {};
} else if (queue) {
// Intermediate animation
animate( settings.onAfterFirst );
animate(settings.onAfterFirst);
// Don't animate this axis again in the next iteration.
attr = {};
}
}
});
animate( settings.onAfter );
animate(settings.onAfter);
function animate(callback) {
var opts = $.extend({}, settings, {
@ -154,10 +159,10 @@
queue: true,
duration: duration,
complete: callback && function() {
callback.call( elem, targ, settings );
callback.call(elem, targ, settings);
}
});
$elem.animate( attr, opts );
$elem.animate(attr, opts);
}
});
};
@ -166,40 +171,41 @@
// It only fails (not too badly) on IE, quirks mode.
$scrollTo.max = function(elem, axis) {
var Dim = axis === 'x' ? 'Width' : 'Height',
scroll = 'scroll' + Dim;
scroll = 'scroll'+Dim;
if ( ! isWin( elem )) {
return elem[scroll] - $( elem )[Dim.toLowerCase()](); }
if (!isWin(elem))
return elem[scroll] - $(elem)[Dim.toLowerCase()]();
var size = 'client' + Dim,
doc = elem.ownerDocument || elem.document,
html = doc.documentElement,
body = doc.body;
return Math.max( html[scroll], body[scroll] ) - Math.min( html[size], body[size] );
return Math.max(html[scroll], body[scroll]) - Math.min(html[size], body[size]);
};
function both(val) {
return $.isFunction( val ) || $.isPlainObject( val ) ? val : { top:val, left:val };
return isFunction(val) || $.isPlainObject(val) ? val : { top:val, left:val };
}
// Add special hooks so that window scroll properties can be animated
$.Tween.propHooks.scrollLeft = $.Tween.propHooks.scrollTop = {
$.Tween.propHooks.scrollLeft =
$.Tween.propHooks.scrollTop = {
get: function(t) {
return $( t.elem )[t.prop]();
return $(t.elem)[t.prop]();
},
set: function(t) {
var curr = this.get( t );
var curr = this.get(t);
// If interrupt is true and user scrolled, stop animating
if (t.options.interrupt && t._last && t._last !== curr) {
return $( t.elem ).stop();
return $(t.elem).stop();
}
var next = Math.round( t.now );
var next = Math.round(t.now);
// Don't waste CPU
// Browsers don't render floating point scroll
if (curr !== next) {
$( t.elem )[t.prop](next);
t._last = this.get( t );
$(t.elem)[t.prop](next);
t._last = this.get(t);
}
}
};

View File

@ -498,7 +498,7 @@ function twentyseventeen_scripts() {
wp_enqueue_script( 'twentyseventeen-global', get_theme_file_uri( '/assets/js/global.js' ), array( 'jquery' ), '20190121', true );
wp_enqueue_script( 'jquery-scrollto', get_theme_file_uri( '/assets/js/jquery.scrollTo.js' ), array( 'jquery' ), '2.1.2', true );
wp_enqueue_script( 'jquery-scrollto', get_theme_file_uri( '/assets/js/jquery.scrollTo.js' ), array( 'jquery' ), '2.1.3', true );
wp_localize_script( 'twentyseventeen-skip-link-focus-fix', 'twentyseventeenScreenReaderText', $twentyseventeen_l10n );