Ticket #47149: 47149.diff

src/js/media/views/focus-manager.js

@@ +1 @@
+var $ = jQuery;
+
 /**
  * wp.media.view.FocusManager
  *
@@ -11 +13 @@
 var FocusManager = wp.media.View.extend(/** @lends wp.media.view.FocusManager.prototype */{
 
         events: {
-                'keydown': 'constrainTabbing'
+                'keydown': 'focusManagementMode'
         },
 
+        initialize: function( options ) {
+                this.mode                    = options.mode || 'constrainTabbing';
+                this.tabsAutomaticActivation = options.tabsAutomaticActivation || false;
+        },
+
         /**
+         * Determines which focus management mode to use.
+         *
+         * @param {object} event jQuery event object.
+         *
+         * @returns {void}
+         */
+        focusManagementMode: function( event ) {
+                if ( this.mode === 'constrainTabbing' ) {
+                        this.constrainTabbing( event );
+                }
+
+                if ( this.mode === 'tabsNavigation' ) {
+                        this.tabsNavigation( event );
+                }
+        },
+
+        /**
          * Gets all the tabbable elements.
+         *
+         * @returns {object} jQuery collection of tabbable elements.
          */
         getTabbables: function() {
                 // Skip the file input added by Plupload.
@@ -24 +50 @@
 
         /**
          * Moves focus to the modal dialog.
+         *
+         * @returns {void}
          */
         focus: function() {
                 this.$( '.media-modal' ).focus();
@@ -30 +58 @@
         },
 
         /**
-         * @param {Object} event
+         * Constrains navigation with the Tab key within the modal.
+         *
+         * @param {object} event jQuery event object.
+         *
+         * @returns {void}
          */
         constrainTabbing: function( event ) {
                 var tabbables;
@@ -50 +82 @@
                         tabbables.last().focus();
                         return false;
                 }
+        },
+
+        // Holds the collection of tabs.
+        tabs: $(),
+
+        /**
+         * Initializes tabs in an ARIA tabbed interface.
+         *
+         * @param {object} event jQuery event object.
+         *
+         * @returns {void}
+         */
+        initializeAriaTabs: function() {
+                this.tabs = this.$( '[role="tab"]' );
+
+                // Set up initial attributes.
+                this.tabs.attr( {
+                        'aria-selected': false,
+                        tabIndex: '-1'
+                } );
+
+                // Set up attributes on the initially active tab.
+                this.tabs.filter( '.active' )
+                        .removeAttr( 'tabindex' )
+                        .attr( 'aria-selected', 'true' );
+        },
+
+        /**
+         * Enables arrows navigation within the ARIA tabbed interface.
+         *
+         * @param {object} event jQuery event object.
+         *
+         * @returns {void}
+         */
+        tabsNavigation: function( event ) {
+                var orientation = 'horizontal',
+                        keys = [ 32, 35, 36, 37, 38, 39, 40 ];
+
+                // Return if not Spacebar, End, Home, or Arrow keys.
+                if ( keys.indexOf( event.which ) === -1 ) {
+                        return;
+                }
+
+                // Determine navigation direction.
+                if ( this.$el.attr( 'aria-orientation' ) === 'vertical' ) {
+                        orientation = 'vertical';
+                }
+
+                // Make Up and Down arrow keys do nothing with horizontal tabs.
+                if ( orientation === 'horizontal' && [ 38, 40 ].indexOf( event.which ) !== -1 ) {
+                        return;
+                }
+
+                // Make Left and Right arrow keys do nothing with vertical tabs.
+                if ( orientation === 'vertical' && [ 37, 39 ].indexOf( event.which ) !== -1 ) {
+                        return;
+                }
+
+                this.switchTabs( event, this.tabs );
+        },
+
+        /**
+         * Switch tabs in the ARIA tabbed interface.
+         *
+         * @param {object} event jQuery event object.
+         *
+         * @returns {void}
+         */
+        switchTabs: function( event ) {
+                var key   = event.which,
+                        index = this.tabs.index( jQuery( event.target ) ),
+                        newIndex;
+
+                switch ( key ) {
+                        // Space bar: Activate current targeted tab.
+                        case 32: {
+                                this.activateTab( this.tabs[ index ] );
+                                break;
+                        }
+                        // End key: Activate last tab.
+                        case 35: {
+                                event.preventDefault();
+                                this.activateTab( this.tabs[ this.tabs.length - 1 ] );
+                                break;
+                        }
+                        // Home key: Activate first tab.
+                        case 36: {
+                                event.preventDefault();
+                                this.activateTab( this.tabs[ 0 ] );
+                                break;
+                        }
+                        // Left and up keys: Activate previous tab.
+                        case 37:
+                        case 38: {
+                                event.preventDefault();
+                                newIndex = ( index - 1 ) < 0 ? this.tabs.length - 1 : index - 1;
+                                this.activateTab( this.tabs[ newIndex ] );
+                                break;
+                        }
+                        // Right and down keys: Activate next tab.
+                        case 39:
+                        case 40: {
+                                event.preventDefault();
+                                newIndex = ( index + 1 ) === this.tabs.length ? 0 : index + 1;
+                                this.activateTab( this.tabs[ newIndex ] );
+                                break;
+                        }
+                }
+        },
+
+        /**
+         * Sets all the tabs to be not focusable and semantically not selected.
+         *
+         * @param {object} tabs The tabs jQuery collection.
+         *
+         * @returns {void}
+         */
+        deactivateTabs: function( tabs ) {
+                tabs
+                        .attr( {
+                                'aria-selected': 'false',
+                                tabIndex: '-1'
+                        } );
+        },
+
+        /**
+         * Sets a single tab to be focusable and semantically selected.
+         *
+         * @param {object} tab  The tab DOM element.
+         *
+         * @returns {void}
+         */
+        activateTab: function( tab ) {
+                if ( ! tab ) {
+                        return;
+                }
+
+                this.deactivateTabs( this.tabs );
+
+                // The tab is a DOM element: no need for jQuery methods.
+                tab.focus();
+
+                // Handle manual activation.
+                if ( ! this.tabsAutomaticActivation ) {
+                        tab.removeAttribute( 'tabindex' );
+                        tab.setAttribute( 'aria-selected', 'true' );
+                        return;
+                }
+
+                // Handle automatic activation.
+                $( tab ).on( 'click', function() {
+                        tab.removeAttribute( 'tabindex' );
+                        tab.setAttribute( 'aria-selected', 'true' );
+                } );
+
+                tab.click();
         }
-
 });
 
 module.exports = FocusManager;

src/js/media/views/frame/post.js

@@ -257 +257 @@
         mainMenu: function( view ) {
                 view.set({
                         'library-separator': new wp.media.View({
-                                className: 'separator',
-                                priority: 100
+                                className:  'separator',
+                                priority:   100,
+                                attributes: {
+                                        role: 'presentation'
+                                }
                         })
                 });
         },

src/js/media/views/media-frame.js

@@ -110 +110 @@
          */
         createMenu: function( menu ) {
                 menu.view = new wp.media.view.Menu({
-                        controller: this
+                        controller: this,
+
+                        attributes: {
+                                role:               'tablist',
+                                'aria-orientation': 'vertical'
+                        }
                 });
         },
 

src/js/media/views/menu-item.js

@@ -11 +11 @@
  * @augments Backbone.View
  */
 MenuItem = wp.media.View.extend(/** @lends wp.media.view.MenuItem.prototype */{
-        tagName:   'a',
+        tagName:   'button',
         className: 'media-menu-item',
 
         attributes: {
-                href: '#'
+                type: 'button',
+                role: 'tab'
         },
 
         events: {
                 'click': '_click'
         },
+
         /**
-         * @param {Object} event
+         * Allows to override the click event.
          */
-        _click: function( event ) {
+        _click: function() {
                 var clickOverride = this.options.click;
 
-                if ( event ) {
-                        event.preventDefault();
-                }
-
                 if ( clickOverride ) {
                         clickOverride.call( this );
                 } else {
@@ -43 +41 @@
 
                 if ( state ) {
                         this.controller.setState( state );
+                        // Toggle the menu visibility in the responsive view.
                         this.views.parent.$el.removeClass( 'visible' ); // TODO: or hide on any click, see below
                 }
         },
+
         /**
          * @returns {wp.media.view.MenuItem} returns itself to allow chaining
          */

src/js/media/views/menu.js

@@ -20 +20 @@
         ItemView:  MenuItem,
         region:    'menu',
 
-        /* TODO: alternatively hide on any click anywhere
-        events: {
-                'click': 'click'
+        attributes: {
+                role:               'tablist',
+                'aria-orientation': 'horizontal'
         },
 
-        click: function() {
-                this.$el.removeClass( 'visible' );
+        initialize: function() {
+                this._views = {};
+
+                this.set( _.extend( {}, this._views, this.options.views ), { silent: true });
+                delete this.options.views;
+
+                if ( ! this.options.silent ) {
+                        this.render();
+                }
+
+                // Initialize the Focus Manager.
+                this.focusManager = new wp.media.view.FocusManager( {
+                        el:   this.el,
+                        mode: 'tabsNavigation'
+                } );
         },
-        */
 
         /**
          * @param {Object} options
@@ -47 +59 @@
                  */
                 PriorityList.prototype.ready.apply( this, arguments );
                 this.visibility();
+
+                // Set up aria tabs initial attributes.
+                this.focusManager.initializeAriaTabs();
         },
 
         set: function() {
@@ -87 +102 @@
 
                 this.deselect();
                 view.$el.addClass('active');
+
+                // Set up again the aria tabs initial attributes after the menu updates.
+                this.focusManager.initializeAriaTabs();
         },
 
         deselect: function() {

src/js/media/views/router.js

@@ -20 +20 @@
         ItemView:  wp.media.view.RouterItem,
         region:    'router',
 
+        attributes: {
+                role:               'tablist',
+                'aria-orientation': 'horizontal'
+        },
+
         initialize: function() {
                 this.controller.on( 'content:render', this.update, this );
                 // Call 'initialize' directly on the parent class.

src/wp-includes/css/media-views.css

@@ -553 +553 @@
         user-select: none;
 }
 
-.media-menu > a {
+.media-menu .media-menu-item {
         display: block;
         position: relative;
         padding: 8px 20px;
@@ -564 +564 @@
         text-decoration: none;
 }
 
-.media-menu > a:hover {
+.media-menu .media-menu-item:hover {
         color: #0073aa;
         background: rgba(0, 0, 0, 0.04);
 }
 
-.media-menu > a:active {
+.media-menu .media-menu-item:active {
         outline: none;
 }
 
@@ -600 +600 @@
         user-select: none;
 }
 
-.media-router a {
+.media-router .media-menu-item {
         transition: none;
 }
 
-.media-router > a {
+.media-router .media-menu-item {
         position: relative;
         float: left;
         padding: 8px 10px 9px;
@@ -615 +615 @@
         text-decoration: none;
 }
 
-.media-router > a:last-child {
+.media-router .media-menu-item:last-child {
         border-right: 0;
 }
 
-.media-router > a:active {
+.media-router .media-menu-item:active {
         outline: none;
 }
 
@@ -629 +629 @@
 }
 
 .media-router .active,
-.media-router > a.active:last-child {
+.media-router .media-menu-item.active:last-child {
         margin: -1px -1px 0;
         background: #fff;
         border: 1px solid #ddd;