From 19e1d8076d808181611034bb05ce20c924db0462 Mon Sep 17 00:00:00 2001
From: Mark Jaquith <markjaquith@git.wordpress.org>
Date: Sat, 16 Mar 2013 04:47:19 +0000
Subject: [PATCH] Accessibility revamp for nav menus.

props lessbloat. fixes #14045

git-svn-id: https://develop.svn.wordpress.org/trunk@23727 602fd350-edb4-49c9-b593-d223f7449a82
---
 wp-admin/css/colors-fresh.css  |   4 -
 wp-admin/css/wp-admin.css      |  10 +-
 wp-admin/includes/nav-menu.php |  13 +-
 wp-admin/js/nav-menu.js        | 314 ++++++++++++++++++++++++---------
 wp-admin/nav-menus.php         |  13 +-
 5 files changed, 265 insertions(+), 89 deletions(-)

diff --git a/wp-admin/css/colors-fresh.css b/wp-admin/css/colors-fresh.css
index e20d6d499e..d5088678ec 100644
--- a/wp-admin/css/colors-fresh.css
+++ b/wp-admin/css/colors-fresh.css
@@ -1789,10 +1789,6 @@ div.widgets-sortables,
 	background: #fbfbfb;
 }
 
-.menu-settings {
-	border-top: 1px solid #eeeeee;
-}
-
 .theme-location-set {
 	color: #999999;
 }
diff --git a/wp-admin/css/wp-admin.css b/wp-admin/css/wp-admin.css
index 61dc531008..b2512f5505 100644
--- a/wp-admin/css/wp-admin.css
+++ b/wp-admin/css/wp-admin.css
@@ -7305,9 +7305,12 @@ a.rsswidget {
 	margin: .3em 0 .6em;
 }
 
+.menu-edit #post-body-content h3 {
+	margin: 0 0 10px;
+}
+
 .menu-settings {
 	margin-top: 2em;
-	padding-top: 16px;
 	overflow: hidden;
 }
 
@@ -7801,6 +7804,11 @@ body.menu-max-depth-11 { min-width: 1280px !important; }
 	border-bottom-right-radius: 3px;
 }
 
+.menu-item-settings .field-move a {
+	display: none;
+	margin: 0 2px;
+}
+
 .menu-item-edit-active .menu-item-settings {
 	display: block;
 }
diff --git a/wp-admin/includes/nav-menu.php b/wp-admin/includes/nav-menu.php
index 27729b9be6..11b19a867e 100644
--- a/wp-admin/includes/nav-menu.php
+++ b/wp-admin/includes/nav-menu.php
@@ -89,7 +89,7 @@ class Walker_Nav_Menu_Edit extends Walker_Nav_Menu {
 		<li id="menu-item-<?php echo $item_id; ?>" class="<?php echo implode(' ', $classes ); ?>">
 			<dl class="menu-item-bar">
 				<dt class="menu-item-handle">
-					<span class="item-title"><?php echo esc_html( $title ); ?> <span class="is-submenu" <?php echo $submenu_text; ?>><?php _e( 'sub item' ); ?></span></span>
+					<span class="item-title"><span class="menu-item-title"><?php echo esc_html( $title ); ?></span> <span class="is-submenu" <?php echo $submenu_text; ?>><?php _e( 'sub item' ); ?></span></span>
 					<span class="item-controls">
 						<span class="item-type"><?php echo esc_html( $item->type_label ); ?></span>
 						<span class="item-order hide-if-js">
@@ -173,6 +173,17 @@ class Walker_Nav_Menu_Edit extends Walker_Nav_Menu {
 					</label>
 				</p>
 
+				<p class="field-move description description-wide">
+					<label>
+						<?php _e( 'Move' ); ?>
+						<a href="#" class="menus-move-up"><?php _e( 'Up one' ); ?></a>
+						<a href="#" class="menus-move-down"><?php _e( 'Down one' ); ?></a>
+						<a href="#" class="menus-move-left"></a>
+						<a href="#" class="menus-move-right"></a>
+						<a href="#" class="menus-move-top"><?php _e( 'To the top' ); ?></a>
+					</label>
+				</p>
+
 				<div class="menu-item-actions description-wide submitbox">
 					<?php if( 'custom' != $item->type && $original_title !== false ) : ?>
 						<p class="link-to-original">
diff --git a/wp-admin/js/nav-menu.js b/wp-admin/js/nav-menu.js
index 7e06aadb2b..f8501545a3 100644
--- a/wp-admin/js/nav-menu.js
+++ b/wp-admin/js/nav-menu.js
@@ -45,7 +45,7 @@ var wpNavMenu;
 			if( api.menuList.length )
 				this.initSortables();
 
-			if( oneThemeLocationNoMenus )
+			if( menu.oneThemeLocationNoMenus )
 				$( '#posttype-page' ).addSelectedToMenu( api.addMenuItemToBottom );
 
 			this.initAccessibility();
@@ -162,7 +162,7 @@ var wpNavMenu;
 
 					return this.each(function() {
 						var t = $(this), menuItems = {},
-							checkboxes = ( oneThemeLocationNoMenus && 0 == t.find('.tabs-panel-active .categorychecklist li input:checked').length ) ? t.find('#page-all li input[type="checkbox"]') : t.find('.tabs-panel-active .categorychecklist li input:checked'),
+							checkboxes = ( menu.oneThemeLocationNoMenus && 0 == t.find('.tabs-panel-active .categorychecklist li input:checked').length ) ? t.find('#page-all li input[type="checkbox"]') : t.find('.tabs-panel-active .categorychecklist li input:checked'),
 							re = new RegExp('menu-item\\[(\[^\\]\]*)');
 
 						processMethod = processMethod || api.addMenuItemToBottom;
@@ -271,9 +271,226 @@ var wpNavMenu;
 			accordionOptions.filter(':visible').first().addClass( 'open' );
 		},
 
+		countMenuItems : function( depth ) {
+			return $( '.menu-item-depth-' + depth ).length;
+		},
+
+		moveMenuItem : function( $this, dir ) {
+
+			var menuItems = $('#menu-to-edit li');
+				menuItemsCount = menuItems.length,
+				thisItem = $this.parents( 'li.menu-item' ),
+				thisItemChildren = thisItem.childMenuItems(),
+				thisItemData = thisItem.getItemData(),
+				thisItemDepth = parseInt( thisItem.menuItemDepth() ),
+				thisItemPosition = parseInt( thisItem.index() ),
+				nextItem = thisItem.next(),
+				nextItemChildren = nextItem.childMenuItems(),
+				nextItemDepth = parseInt( nextItem.menuItemDepth() ) + 1,
+				prevItem = thisItem.prev(),
+				prevItemDepth = parseInt( prevItem.menuItemDepth() ),
+				prevItemId = prevItem.getItemData()['menu-item-db-id'];
+
+			switch ( dir ) {
+			case 'up':
+				var newItemPosition = thisItemPosition - 1;
+
+				// Already at top
+				if ( 0 === thisItemPosition )
+					break;
+
+				// If a sub item is moved to top, shift it to 0 depth
+				if ( 0 === newItemPosition && 0 !== thisItemDepth )
+					thisItem.moveHorizontally( 0, thisItemDepth );
+
+				// If prev item is sub item, shift to match depth
+				if ( 0 !== prevItemDepth )
+					thisItem.moveHorizontally( prevItemDepth, thisItemDepth );
+
+				// Does this item have sub items?
+				if ( thisItemChildren ) {
+					var items = thisItem.add( thisItemChildren );
+					// Move the entire block
+					items.detach().insertBefore( menuItems.eq( newItemPosition ) ).updateParentMenuItemDBId();
+				} else {
+					thisItem.detach().insertBefore( menuItems.eq( newItemPosition ) ).updateParentMenuItemDBId();
+				}
+				break;
+			case 'down':
+				// Does this item have sub items?
+				if ( thisItemChildren ) {
+					var items = thisItem.add( thisItemChildren ),
+						nextItem = menuItems.eq( items.length + thisItemPosition ),
+						nextItemChildren = 0 !== nextItem.childMenuItems().length;
+
+					if ( nextItemChildren ) {
+						var newDepth = parseInt( nextItem.menuItemDepth() ) + 1;
+						thisItem.moveHorizontally( newDepth, thisItemDepth );
+					}
+
+					// Have we reached the bottom?
+					if ( menuItemsCount === thisItemPosition + items.length )
+						break;
+
+					items.detach().insertAfter( menuItems.eq( thisItemPosition + items.length ) ).updateParentMenuItemDBId();
+				} else {
+					// If next item has sub items, shift depth
+					if ( 0 !== nextItemChildren.length )
+						thisItem.moveHorizontally( nextItemDepth, thisItemDepth );
+
+					// Have we reached the bottom
+					if ( menuItemsCount === thisItemPosition + 1 )
+						break;
+					thisItem.detach().insertAfter( menuItems.eq( thisItemPosition + 1 ) ).updateParentMenuItemDBId();
+				}
+				break;
+			case 'top':
+				// Already at top
+				if ( 0 === thisItemPosition )
+					break;
+				// Does this item have sub items?
+				if ( thisItemChildren ) {
+					var items = thisItem.add( thisItemChildren );
+					// Move the entire block
+					items.detach().insertBefore( menuItems.eq( 0 ) ).updateParentMenuItemDBId();
+				} else {
+					thisItem.detach().insertBefore( menuItems.eq( 0 ) ).updateParentMenuItemDBId();
+				}
+				break;
+			case 'left':
+				// As far left as possible
+				if ( 0 === thisItemDepth )
+					break;
+				thisItem.shiftHorizontally( -1 );
+				break;
+			case 'right':
+				// Can't be sub item at top
+				if ( 0 === thisItemPosition )
+					break;
+				// Already sub item of prevItem
+				if ( thisItemData['menu-item-parent-id'] === prevItemId )
+					break;
+				thisItem.shiftHorizontally( 1 );
+				break;
+			}
+			$this.focus();
+			api.registerChange();
+			api.refreshKeyboardAccessibility();
+			api.refreshAdvancedAccessibility();
+		},
+
 		initAccessibility : function() {
+			api.refreshKeyboardAccessibility();
+			api.refreshAdvancedAccessibility();
+
+			// Events
+			$( '.menus-move-up' ).on( 'click', function ( e ) {
+				api.moveMenuItem( $( this ).parents( 'li.menu-item' ).find( 'a.item-edit' ), 'up' );
+				e.preventDefault();
+			});
+			$( '.menus-move-down' ).on( 'click', function ( e ) {
+				api.moveMenuItem( $( this ).parents( 'li.menu-item' ).find( 'a.item-edit' ), 'down' );
+				e.preventDefault();
+			});
+			$( '.menus-move-top' ).on( 'click', function ( e ) {
+				api.moveMenuItem( $( this ).parents( 'li.menu-item' ).find( 'a.item-edit' ), 'top' );
+				e.preventDefault();
+			});
+			$( '.menus-move-left' ).on( 'click', function ( e ) {
+				api.moveMenuItem( $( this ).parents( 'li.menu-item' ).find( 'a.item-edit' ), 'left' );
+				e.preventDefault();
+			});
+			$( '.menus-move-right' ).on( 'click', function ( e ) {
+				api.moveMenuItem( $( this ).parents( 'li.menu-item' ).find( 'a.item-edit' ), 'right' );
+				e.preventDefault();
+			});
+		},
+
+		refreshAdvancedAccessibility : function() {
+
+			// Hide all links by default
+			$( '.menu-item-settings .field-move a' ).hide();
+
+			$( '.item-edit' ).each( function() {
+				var $this = $(this),
+					movement = [],
+					availableMovement = '',
+					menuItem = $this.parents( 'li.menu-item' ).first(),
+					depth = menuItem.menuItemDepth(),
+					isPrimaryMenuItem = ( 0 === depth ),
+					itemName = $this.parents( '.menu-item-handle' ).find( '.menu-item-title' ).text(),
+					position = parseInt( menuItem.index() ),
+					prevItemDepth = ( isPrimaryMenuItem ) ? depth : parseInt( depth - 1 ),
+					prevItemNameLeft = menuItem.prevAll('.menu-item-depth-' + prevItemDepth).first().find( '.menu-item-title' ).text(),
+					prevItemNameRight = menuItem.prevAll('.menu-item-depth-' + depth).first().find( '.menu-item-title' ).text(),
+					totalMenuItems = $('#menu-to-edit li').length,
+					hasSameDepthSibling = menuItem.nextAll( '.menu-item-depth-' + depth ).length;
+
+				// Where can they move this menu item?
+				if ( 0 !== position ) {
+					var thisLink = menuItem.find( '.menus-move-up' ),
+						thisLinkText = thisLink.text();
+					thisLink.prop('title', menus.move + ' ' + thisLinkText).show();
+				}
+
+				if ( 0 !== position && isPrimaryMenuItem ) {
+					var thisLink = menuItem.find( '.menus-move-top' ),
+						thisLinkText = thisLink.text();
+					thisLink.prop('title', menus.move + ' ' + thisLinkText).show();
+				}
+
+				if ( position + 1 !== totalMenuItems && 0 !== position ) {
+					var thisLink = menuItem.find( '.menus-move-down' ),
+						thisLinkText = thisLink.text();
+					thisLink.prop('title', menus.move + ' ' + thisLinkText).show();
+				}
+
+				if ( 0 === position && 0 !== hasSameDepthSibling ) {
+					var thisLink = menuItem.find( '.menus-move-down' ),
+						thisLinkText = thisLink.text();
+					thisLink.prop('title', menus.move + ' ' + thisLinkText).show();
+				}
+
+				if ( ! isPrimaryMenuItem ) {
+					var thisLink = menuItem.find( '.menus-move-left' ),
+						thisLinkText = menus.outFrom + ' ' + prevItemNameLeft;
+					thisLink.prop('title', menus.move + ' ' + thisLinkText).html(thisLinkText).show();
+				}
+
+				if ( 0 !== position ) {
+					if ( menuItem.find( '.menu-item-data-parent-id' ).val() !== menuItem.prev().find( '.menu-item-data-db-id' ).val() ) {
+						var thisLink = menuItem.find( '.menus-move-right' ),
+							thisLinkText = menus.under + ' ' + prevItemNameRight;
+						thisLink.prop('title', menus.move + ' ' + thisLinkText).html(thisLinkText).show();
+					}
+				}
+
+				if ( isPrimaryMenuItem ) {
+					var primaryItems = $( '.menu-item-depth-0' ),
+						itemPosition = primaryItems.index( menuItem ) + 1,
+						totalMenuItems = primaryItems.length,
+
+						// String together help text for primary menu items
+						title = itemName + '. ' + menus.menuFocus.replace('%d', itemPosition).replace('%d', totalMenuItems) + '.';
+				} else {
+					var parentItem = menuItem.prevAll( '.menu-item-depth-' + parseInt( depth - 1 ) ).first(),
+						parentItemId = parentItem.find( '.menu-item-data-db-id' ).val(),
+						parentItemName = parentItem.find( '.menu-item-title' ).text(),
+						subItems = $( '.menu-item .menu-item-data-parent-id[value="' + parentItemId + '"]' ),
+						itemPosition = $(subItems.parents('.menu-item').get().reverse()).index( menuItem ) + 1;
+
+						// String together help text for sub menu items
+
+						title = itemName + '. ' + menus.subMenuFocus.replace('%d', itemPosition) + parentItemName + '.';
+				}
+
+				$this.prop('title', title).html( title );
+			});
+		},
+
+		refreshKeyboardAccessibility : function() {
 			$( '.item-edit' ).off( 'focus' ).on( 'focus', function(){
-				$(this).on( 'keydown', function(e){
+				$(this).off( 'keydown' ).on( 'keydown', function(e){
 
 					var $this = $(this);
 
@@ -284,22 +501,8 @@ var wpNavMenu;
 					// Avoid multiple keydown events
 					$this.off('keydown');
 
-					var menuItems = $('#menu-to-edit li');
-						menuItemsCount = menuItems.length,
-						thisItem = $this.parents( 'li.menu-item' ),
-						thisItemChildren = thisItem.childMenuItems(),
-						thisItemData = thisItem.getItemData(),
-						thisItemDepth = parseInt( thisItem.menuItemDepth() ),
-						thisItemPosition = parseInt( thisItem.index() ),
-						nextItem = thisItem.next(),
-						nextItemChildren = nextItem.childMenuItems(),
-						nextItemDepth = parseInt( nextItem.menuItemDepth() ) + 1,
-						prevItem = thisItem.prev(),
-						prevItemDepth = parseInt( prevItem.menuItemDepth() ),
-						prevItemId = prevItem.getItemData()['menu-item-db-id'];
-
 					// Bail if there is only one menu item
-					if ( 1 === menuItemsCount )
+					if ( 1 === $('#menu-to-edit li').length )
 						return;
 
 					// If RTL, swap left/right arrows
@@ -309,80 +512,22 @@ var wpNavMenu;
 
 					switch ( arrows[e.which] ) {
 					case 'up':
-						var newItemPosition = thisItemPosition - 1;
-
-						// Already at top
-						if ( 0 === thisItemPosition )
-							break;
-
-						// If a sub item is moved to top, shift it to 0 depth
-						if ( 0 === newItemPosition && 0 !== thisItemDepth )
-							thisItem.moveHorizontally( 0, thisItemDepth );
-
-						// If prev item is sub item, shift to match depth
-						if ( 0 !== prevItemDepth )
-							thisItem.moveHorizontally( prevItemDepth, thisItemDepth );
-
-						// Does this item have sub items?
-						if ( thisItemChildren ) {
-							var items = thisItem.add( thisItemChildren );
-							// Move the entire block
-							items.detach().insertBefore( menuItems.eq( newItemPosition ) );
-						} else {
-							thisItem.detach().insertBefore( menuItems.eq( newItemPosition ) );
-						}
+						api.moveMenuItem( $this, 'up' );
 						break;
 					case 'down':
-						// Does this item have sub items?
-						if ( thisItemChildren ) {
-							var items = thisItem.add( thisItemChildren ),
-								nextItem = menuItems.eq( items.length + thisItemPosition ),
-								nextItemChildren = 0 !== nextItem.childMenuItems().length;
-
-							if ( nextItemChildren ) {
-								var newDepth = parseInt( nextItem.menuItemDepth() ) + 1;
-								thisItem.moveHorizontally( newDepth, thisItemDepth );
-							}
-
-							// Have we reached the bottom?
-							if ( menuItemsCount === thisItemPosition + items.length )
-								break;
-
-							items.detach().insertAfter( menuItems.eq( thisItemPosition + items.length ) );
-						} else {
-							// If next item has sub items, shift depth
-							if ( 0 !== nextItemChildren.length )
-								thisItem.moveHorizontally( nextItemDepth, thisItemDepth );
-
-							// Have we reached the bottom
-							if ( menuItemsCount === thisItemPosition + 1 )
-								break;
-							thisItem.detach().insertAfter( menuItems.eq( thisItemPosition + 1 ) );
-						}
+						api.moveMenuItem( $this, 'down' );
 						break;
 					case 'left':
-						// As far left as possible
-						if ( 0 === thisItemDepth )
-							break;
-						thisItem.shiftHorizontally( -1 );
+						api.moveMenuItem( $this, 'left' );
 						break;
 					case 'right':
-						// Can't be sub item at top
-						if ( 0 === thisItemPosition )
-							break;
-						// Already sub item of prevItem
-						if ( thisItemData['menu-item-parent-id'] === prevItemId )
-							break;
-						thisItem.shiftHorizontally( 1 );
+						api.moveMenuItem( $this, 'right' );
 						break;
 					}
-					api.registerChange();
 					// Put focus back on same menu item
 					$( '#edit-' + thisItemData['menu-item-db-id'] ).focus();
 					return false;
 				});
-			}).blur(function () {
-				$(this).off( 'keydown' );
 			});
 		},
 
@@ -512,6 +657,9 @@ var wpNavMenu;
 						ui.item[0].style.left = 'auto';
 						ui.item[0].style.right = 0;
 					}
+
+					api.refreshKeyboardAccessibility();
+					api.refreshAdvancedAccessibility();
 				},
 				change: function(e, ui) {
 					// Make sure the placeholder is inside the menu.
@@ -773,12 +921,14 @@ var wpNavMenu;
 		 */
 		addMenuItemToBottom : function( menuMarkup, req ) {
 			$(menuMarkup).hideAdvancedMenuItemFields().appendTo( api.targetList );
-			api.initAccessibility();
+			api.refreshKeyboardAccessibility();
+			api.refreshAdvancedAccessibility();
 		},
 
 		addMenuItemToTop : function( menuMarkup, req ) {
 			$(menuMarkup).hideAdvancedMenuItemFields().prependTo( api.targetList );
-			api.initAccessibility();
+			api.refreshKeyboardAccessibility();
+			api.refreshAdvancedAccessibility();
 		},
 
 		attachUnsavedChangesListener : function() {
diff --git a/wp-admin/nav-menus.php b/wp-admin/nav-menus.php
index 0bb2dc7ee4..334c93635b 100644
--- a/wp-admin/nav-menus.php
+++ b/wp-admin/nav-menus.php
@@ -354,6 +354,16 @@ $add_new_screen = ( isset( $_GET['menu'] ) && 0 == $_GET['menu'] ) ? true : fals
 $page_count = wp_count_posts( 'page' );
 $one_theme_location_no_menus = ( 1 == count( get_registered_nav_menus() ) && ! $add_new_screen && empty( $nav_menus ) && ! empty( $page_count->publish ) ) ? true : false;
 
+$l10n = array(
+	"oneThemeLocationNoMenus" => ( $one_theme_location_no_menus ) ? 'true' : 'false',
+	"move" => __( 'Move' ),
+	"menuFocus" => __( 'Menu item %d of %d' ),
+	"subMenuFocus" => __( 'Sub item number %d under' ),
+	"under" => __( 'Under' ),
+	"outFrom" => __( 'Out from under' )
+);
+wp_localize_script( 'nav-menu', 'menus', $l10n );
+
 // Redirect to add screen if there are no menus and this users has either zero, or more than 1 theme locations
 if ( 0 == $menu_count && ! $add_new_screen && ! $one_theme_location_no_menus )
 	wp_redirect( admin_url( 'nav-menus.php?action=edit&menu=0' ) );
@@ -543,6 +553,7 @@ require_once( './admin-header.php' );
 					<div id="post-body">
 						<div id="post-body-content">
 							<?php if ( ! $add_new_screen ) : ?>
+							<h3><?php _e( 'Menu Structure' ); ?></h3>
 							<?php $starter_copy = ( $one_theme_location_no_menus ) ? __( 'Edit your default menu by adding or removing items. Drag each item into the order you prefer. Click Create Menu to save your changes.' ) : __( 'Drag each item into the order you prefer. Click an item to reveal additional configuration options.' ); ?>
 							<div class="drag-instructions post-body-plain" <?php if ( isset( $menu_items ) && 0 == count( $menu_items ) ) { ?>style="display: none;"<?php } ?>>
 								<p><?php echo $starter_copy; ?></p>
@@ -559,6 +570,7 @@ require_once( './admin-header.php' );
 								<p class="post-body-plain"><?php _e( 'Give your menu a name above, then click Create Menu.' ); ?></p>
 							<?php endif; ?>
 							<div class="menu-settings" <?php if ( $one_theme_location_no_menus ) { ?>style="display: none;"<?php } ?>>
+								<h3><?php _e( 'Menu Settings' ); ?></h3>
 								<?php
 								if ( ! isset( $auto_add ) ) {
 									$auto_add = get_option( 'nav_menu_options' );
@@ -612,5 +624,4 @@ require_once( './admin-header.php' );
 	</div><!-- /#menu-management-liquid -->
 	</div><!-- /#nav-menus-frame -->
 </div><!-- /.wrap-->
-<script type="text/javascript">var oneThemeLocationNoMenus = <?php if ( $one_theme_location_no_menus ) echo 'true'; else echo 'false'; ?>;</script>
 <?php include( './admin-footer.php' ); ?>