enmi-conf.org: comparison wp/wp-includes/js/admin-bar.js

Mercurial Mercurial > enmi-conf.org / comparison

summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help

wp/wp-includes/js/admin-bar.js

changeset 9	177826044cd9
parent 7	cf61fcea0001
child 16	a86126ab1dd4

equal deleted inserted replaced

-:c7c34916027a
+:177826044cd9
+/**
+* @output wp-includes/js/admin-bar.js
+*/
 /* jshint loopfunc: true */
 // use jQuery and hoverIntent if loaded
 if ( typeof(jQuery) != 'undefined' ) {
 	if ( typeof(jQuery.fn.hoverIntent) == 'undefined' ) {
 		/* jshint ignore:start */
 		/* jshint ignore:end */
 	}
 	jQuery(document).ready(function($){
 		var adminbar = $('#wpadminbar'), refresh, touchOpen, touchClose, disableHoverIntent = false;
-		refresh = function(i, el){ // force the browser to refresh the tabbing index
+		/**
+		 * Forces the browser to refresh the tabbing index.
+		 *
+		 * @since 3.3.0
+		 *
+		 * @param {number}      i  The index of the HTML element to remove the tab index
+		 *                         from. This parameter is necessary because we use this
+		 *                         function in .each calls.
+		 * @param {HTMLElement} el The HTML element to remove the tab index from.
+		 *
+		 * @return {void}
+		 */
+		refresh = function(i, el){
 			var node = $(el), tab = node.attr('tabindex');
 			if ( tab )
 				node.attr('tabindex', '0').attr('tabindex', tab);
 		};
+		/**
+		 * Adds or removes the hover class on touch.
+		 *
+		 * @since 3.5.0
+		 *
+		 * @param {boolean} unbind If true removes the wp-mobile-hover class.
+		 *
+		 * @return {void}
+		 */
 		touchOpen = function(unbind) {
 			adminbar.find('li.menupop').on('click.wp-mobile-hover', function(e) {
 				var el = $(this);
 				if ( el.parent().is('#wp-admin-bar-root-default') && !el.hasClass('hover') ) {
 					disableHoverIntent = false;
 				}
 			});
 		};
+		/**
+		 * Removes the hover class if clicked or touched outside the admin bar.
+		 *
+		 * @since 3.5.0
+		 *
+		 * @return {void}
+		 */
 		touchClose = function() {
 			var mobileEvent = /Mobile\/.+Safari/.test(navigator.userAgent) ? 'touchstart' : 'click';
 			// close any open drop-downs when the click/touch is not on the toolbar
 			$(document.body).on( mobileEvent+'.wp-mobile-hover', function(e) {
 				if ( !$(e.target).closest('#wpadminbar').length )
 			});
 		};
 		adminbar.removeClass('nojq').removeClass('nojs');
+		// If clicked on the adminbar add the hoverclass, if clicked outside it remove
+		// it.
 		if ( 'ontouchstart' in window ) {
 			adminbar.on('touchstart', function(){
 				touchOpen(true);
 				disableHoverIntent = true;
 			});
 		} else if ( /IEMobile\/[1-9]/.test(navigator.userAgent) ) {
 			touchOpen();
 			touchClose();
 		}
+		// Adds or removes the hover class based on the hover intent.
 		adminbar.find('li.menupop').hoverIntent({
 			over: function() {
 				if ( disableHoverIntent )
 					return;
 			timeout: 180,
 			sensitivity: 7,
 			interval: 100
 		});
+		// Prevents the toolbar from covering up content when a hash is present in the
+		// URL.
 		if ( window.location.hash )
 			window.scrollBy( 0, -32 );
+		/**
+		 * Handles the selected state of the Shortlink link.
+		 *
+		 * When the input is visible the link should be selected, when the input is
+		 * unfocused the link should be unselected.
+		 *
+		 * @param {Object} e The click event.
+		 *
+		 * @return {void}
+		 **/
 		$('#wp-admin-bar-get-shortlink').click(function(e){
 			e.preventDefault();
 			$(this).addClass('selected').children('.shortlink-input').blur(function(){
 				$(this).parents('#wp-admin-bar-get-shortlink').removeClass('selected');
 			}).focus().select();
 		});
+		/**
+		 * Removes the hoverclass if the enter key is pressed.
+		 *
+		 * Makes sure the tab index is refreshed by refreshing each ab-item
+		 * and its children.
+		 *
+		 * @param {Object} e The keydown event.
+		 *
+		 * @return {void}
+		 */
 		$('#wpadminbar li.menupop > .ab-item').bind('keydown.adminbar', function(e){
+			// Key code 13 is the enter key.
 			if ( e.which != 13 )
 				return;
 			var target = $(e.target),
 				wrap = target.closest('.ab-sub-wrapper'),
 			}
 			target.siblings('.ab-sub-wrapper').find('.ab-item').each(refresh);
 		}).each(refresh);
+		/**
+		 * Removes the hover class when the escape key is pressed.
+		 *
+		 * Makes sure the tab index is refreshed by refreshing each ab-item
+		 * and its children.
+		 *
+		 * @param {Object} e The keydown event.
+		 *
+		 * @return {void}
+		 */
 		$('#wpadminbar .ab-item').bind('keydown.adminbar', function(e){
+			// Key code 27 is the escape key.
 			if ( e.which != 27 )
 				return;
 			var target = $(e.target);
 			target.closest('.hover').removeClass('hover').children('.ab-item').focus();
 			target.siblings('.ab-sub-wrapper').find('.ab-item').each(refresh);
 		});
+		/**
+		 * Scrolls to top of page by clicking the adminbar.
+		 *
+		 * @param {Object} e The click event.
+		 *
+		 * @return {void}
+		 */
 		adminbar.click( function(e) {
 			if ( e.target.id != 'wpadminbar' && e.target.id != 'wp-admin-bar-top-secondary' ) {
 				return;
 			}
 			adminbar.find( 'li.menupop.hover' ).removeClass( 'hover' );
 			$( 'html, body' ).animate( { scrollTop: 0 }, 'fast' );
 			e.preventDefault();
 		});
-		// fix focus bug in WebKit
+		/**
+		 * Sets the focus on an element with a href attribute.
+		 *
+		 * The timeout is used to fix a focus bug in WebKit.
+		 *
+		 * @param {Object} e The keydown event.
+		 *
+		 * @return {void}
+		 */
 		$('.screen-reader-shortcut').keydown( function(e) {
 			var id, ua;
 			if ( 13 != e.which )
 				return;
 				}, 100);
 			}
 		});
 		$( '#adminbar-search' ).on({
+			/**
+			 * Adds the adminbar-focused class on focus.
+			 *
+			 * @return {void}
+			 */
 			focus: function() {
 				$( '#adminbarsearch' ).addClass( 'adminbar-focused' );
+			/**
+			 * Removes the adminbar-focused class on blur.
+			 *
+			 * @return {void}
+			 */
 			}, blur: function() {
 				$( '#adminbarsearch' ).removeClass( 'adminbar-focused' );
 			}
 		} );
-		// Empty sessionStorage on logging out
 		if ( 'sessionStorage' in window ) {
+			/**
+			 * Empties sessionStorage on logging out.
+			 *
+			 * @return {void}
+			 */
 			$('#wp-admin-bar-logout a').click( function() {
 				try {
 					for ( var key in sessionStorage ) {
 						if ( key.indexOf('wp-autosave-') != -1 )
 							sessionStorage.removeItem(key);
 			document.body.className += ' no-font-face';
 		}
 	});
 } else {
+	/**
+	 * Wrapper function for the adminbar that's used if jQuery isn't available.
+	 *
+	 * @param {Object} d The document object.
+	 * @param {Object} w The window object.
+	 *
+	 * @return {void}
+	 */
 	(function(d, w) {
+		/**
+		 * Adds an event listener to an object.
+		 *
+		 * @since 3.1.0
+		 *
+		 * @param {Object}   obj  The object to add the event listener to.
+		 * @param {string}   type The type of event.
+		 * @param {function} fn   The function to bind to the event listener.
+		 *
+		 * @return {void}
+		 */
 		var addEvent = function( obj, type, fn ) {
-			if ( obj.addEventListener )
+			if ( obj && typeof obj.addEventListener === 'function' ) {
-				obj.addEventListener(type, fn, false);
+				obj.addEventListener( type, fn, false );
-			else if ( obj.attachEvent )
+			} else if ( obj && typeof obj.attachEvent === 'function' ) {
-				obj.attachEvent('on' + type, function() { return fn.call(obj, window.event);});
+				obj.attachEvent( 'on' + type, function() {
+					return fn.call( obj, window.event );
+				} );
+			}
 		},
 		aB, hc = new RegExp('\\bhover\\b', 'g'), q = [],
 		rselected = new RegExp('\\bselected\\b', 'g'),
 		/**
-		 * Get the timeout ID of the given element
+		 * Gets the timeout ID of the given element.
+		 *
+		 * @since 3.1.0
+		 *
+		 * @param {HTMLElement} el The HTML element.
+		 *
+		 * @return {number|boolean} The ID value of the timer that is set or false.
 		 */
 		getTOID = function(el) {
 			var i = q.length;
 			while ( i-- ) {
 				if ( q[i] && el == q[i][1] )
 					return q[i][0];
 			}
 			return false;
 		},
+		/**
+		 * Adds the hoverclass to menu items.
+		 *
+		 * @since 3.1.0
+		 *
+		 * @param {HTMLElement} t The HTML element.
+		 *
+		 * @return {void}
+		 */
 		addHoverClass = function(t) {
 			var i, id, inA, hovering, ul, li,
 				ancestors = [],
 				ancestorLength = 0;
+			// aB is adminbar. d is document.
 			while ( t && t != aB && t != d ) {
 				if ( 'LI' == t.nodeName.toUpperCase() ) {
 					ancestors[ ancestors.length ] = t;
 					id = getTOID(t);
 					if ( id )
 					hovering = t;
 				}
 				t = t.parentNode;
 			}
-			// Remove any selected classes.
+			// Removes any selected classes.
 			if ( hovering && hovering.parentNode ) {
 				ul = hovering.parentNode;
 				if ( ul && 'UL' == ul.nodeName.toUpperCase() ) {
 					i = ul.childNodes.length;
 					while ( i-- ) {
 							li.className = li.className ? li.className.replace( rselected, '' ) : '';
 					}
 				}
 			}
-			/* remove the hover class for any objects not in the immediate element's ancestry */
+			// Removes the hover class for any objects not in the immediate element's ancestry.
 			i = q.length;
 			while ( i-- ) {
 				inA = false;
 				ancestorLength = ancestors.length;
 				while( ancestorLength-- ) {
 				if ( ! inA )
 					q[i][1].className = q[i][1].className ? q[i][1].className.replace(hc, '') : '';
 			}
 		},
+		/**
+		 * Removes the hoverclass from menu items.
+		 *
+		 * @since 3.1.0
+		 *
+		 * @param {HTMLElement} t The HTML element.
+		 *
+		 * @return {void}
+		 */
 		removeHoverClass = function(t) {
 			while ( t && t != aB && t != d ) {
 				if ( 'LI' == t.nodeName.toUpperCase() ) {
 					(function(t) {
 						var to = setTimeout(function() {
 				}
 				t = t.parentNode;
 			}
 		},
+		/**
+		 * Handles the click on the Shortlink link in the adminbar.
+		 *
+		 * @since 3.1.0
+		 *
+		 * @param {Object} e The click event.
+		 *
+		 * @return {boolean} Returns false to prevent default click behavior.
+		 */
 		clickShortlink = function(e) {
 			var i, l, node,
 				t = e.target || e.srcElement;
 			// Make t the shortlink menu item, or return.
 				}
 			}
 			return false;
 		},
+		/**
+		 * Scrolls to the top of the page.
+		 *
+		 * @since 3.4.0
+		 *
+		 * @param {HTMLElement} t The HTML element.
+		 *
+		 * @return {void}
+		 */
 		scrollToTop = function(t) {
 			var distance, speed, step, steps, timer, speed_step;
 			// Ensure that the #wpadminbar was the target of the click.
 			if ( t.id != 'wpadminbar' && t.id != 'wp-admin-bar-top-secondary' )

enmi-conf.org