mirror of
https://github.com/jquery/jquery-ui.git
synced 2024-11-21 11:04:24 +00:00
300 lines
8.3 KiB
JavaScript
300 lines
8.3 KiB
JavaScript
/*
|
|
* jQuery UI Menubar @VERSION
|
|
*
|
|
* Copyright 2011, AUTHORS.txt (http://jqueryui.com/about)
|
|
* Dual licensed under the MIT or GPL Version 2 licenses.
|
|
* http://jquery.org/license
|
|
*
|
|
* http://docs.jquery.com/UI/Menubar
|
|
*
|
|
* Depends:
|
|
* jquery.ui.core.js
|
|
* jquery.ui.widget.js
|
|
* jquery.ui.position.js
|
|
* jquery.ui.menu.js
|
|
*/
|
|
(function( $ ) {
|
|
|
|
// TODO when mixing clicking menus and keyboard navigation, focus handling is broken
|
|
// there has to be just one item that has tabindex
|
|
$.widget( "ui.menubar", {
|
|
version: "@VERSION",
|
|
options: {
|
|
autoExpand: false,
|
|
buttons: false,
|
|
menuIcon: false,
|
|
position: {
|
|
my: "left top",
|
|
at: "left bottom"
|
|
}
|
|
},
|
|
_create: function() {
|
|
var that = this;
|
|
var items = this.items = this.element.children( "li" )
|
|
.addClass( "ui-menubar-item" )
|
|
.attr( "role", "presentation" )
|
|
.children( "button, a" );
|
|
// let only the first item receive focus
|
|
items.slice(1).attr( "tabIndex", -1 );
|
|
|
|
this.element
|
|
.addClass( "ui-menubar ui-widget-header ui-helper-clearfix" )
|
|
.attr( "role", "menubar" );
|
|
this._focusable( items );
|
|
this._hoverable( items );
|
|
items.next( "ul" )
|
|
.menu({
|
|
position: {
|
|
within: this.options.position.within
|
|
},
|
|
select: function( event, ui ) {
|
|
ui.item.parents( "ul.ui-menu:last" ).hide();
|
|
that._close();
|
|
// TODO what is this targetting? there's probably a better way to access it
|
|
$(event.target).prev().focus();
|
|
that._trigger( "select", event, ui );
|
|
}
|
|
})
|
|
.hide()
|
|
.attr({
|
|
"aria-hidden": "true",
|
|
"aria-expanded": "false"
|
|
})
|
|
.bind( "keydown.menubar", function( event ) {
|
|
var menu = $( this );
|
|
if ( menu.is( ":hidden" ) )
|
|
return;
|
|
switch ( event.keyCode ) {
|
|
case $.ui.keyCode.LEFT:
|
|
that._left( event );
|
|
event.preventDefault();
|
|
break;
|
|
case $.ui.keyCode.RIGHT:
|
|
that._right( event );
|
|
event.preventDefault();
|
|
break;
|
|
};
|
|
});
|
|
items.each(function() {
|
|
var input = $(this),
|
|
// TODO menu var is only used on two places, doesn't quite justify the .each
|
|
menu = input.next( "ul" );
|
|
|
|
input.bind( "click.menubar focus.menubar mouseenter.menubar", function( event ) {
|
|
// ignore triggered focus event
|
|
if ( event.type == "focus" && !event.originalEvent ) {
|
|
return;
|
|
}
|
|
event.preventDefault();
|
|
// TODO can we simplify or extractthis check? especially the last two expressions
|
|
// there's a similar active[0] == menu[0] check in _open
|
|
if ( event.type == "click" && menu.is( ":visible" ) && that.active && that.active[0] == menu[0] ) {
|
|
that._close();
|
|
return;
|
|
}
|
|
if ( ( that.open && event.type == "mouseenter" ) || event.type == "click" || that.options.autoExpand ) {
|
|
if( that.options.autoExpand ) {
|
|
clearTimeout( that.closeTimer );
|
|
}
|
|
|
|
that._open( event, menu );
|
|
}
|
|
})
|
|
.bind( "keydown", function( event ) {
|
|
switch ( event.keyCode ) {
|
|
case $.ui.keyCode.SPACE:
|
|
case $.ui.keyCode.UP:
|
|
case $.ui.keyCode.DOWN:
|
|
that._open( event, $( this ).next() );
|
|
event.preventDefault();
|
|
break;
|
|
case $.ui.keyCode.LEFT:
|
|
that._prev( event, $( this ) );
|
|
event.preventDefault();
|
|
break;
|
|
case $.ui.keyCode.RIGHT:
|
|
that._next( event, $( this ) );
|
|
event.preventDefault();
|
|
break;
|
|
}
|
|
})
|
|
.addClass( "ui-button ui-widget ui-button-text-only ui-menubar-link" )
|
|
.attr( "role", "menuitem" )
|
|
.attr( "aria-haspopup", "true" )
|
|
.wrapInner( "<span class='ui-button-text'></span>" );
|
|
|
|
// TODO review if these options are a good choice, maybe they can be merged
|
|
if ( that.options.menuIcon ) {
|
|
input.addClass( "ui-state-default" ).append( "<span class='ui-button-icon-secondary ui-icon ui-icon-triangle-1-s'></span>" );
|
|
input.removeClass( "ui-button-text-only" ).addClass( "ui-button-text-icon-secondary" );
|
|
}
|
|
|
|
if ( !that.options.buttons ) {
|
|
// TODO ui-menubar-link is added above, not needed here?
|
|
input.addClass( "ui-menubar-link" ).removeClass( "ui-state-default" );
|
|
};
|
|
|
|
});
|
|
that._bind( {
|
|
keydown: function( event ) {
|
|
if ( event.keyCode == $.ui.keyCode.ESCAPE && that.active && that.active.menu( "collapse", event ) !== true ) {
|
|
var active = that.active;
|
|
that.active.blur();
|
|
that._close( event );
|
|
active.prev().focus();
|
|
}
|
|
},
|
|
focusin: function( event ) {
|
|
clearTimeout( that.closeTimer );
|
|
},
|
|
focusout: function( event ) {
|
|
that.closeTimer = setTimeout( function() {
|
|
that._close( event );
|
|
}, 150);
|
|
},
|
|
"mouseleave .ui-menubar-item": function( event ) {
|
|
if ( that.options.autoExpand ) {
|
|
that.closeTimer = setTimeout( function() {
|
|
that._close( event );
|
|
}, 150);
|
|
}
|
|
},
|
|
"mouseenter .ui-menubar-item": function( event ) {
|
|
clearTimeout( that.closeTimer );
|
|
}
|
|
});
|
|
},
|
|
|
|
_destroy : function() {
|
|
var items = this.element.children( "li" )
|
|
.removeClass( "ui-menubar-item" )
|
|
.removeAttr( "role" )
|
|
.children( "button, a" );
|
|
|
|
this.element
|
|
.removeClass( "ui-menubar ui-widget-header ui-helper-clearfix" )
|
|
.removeAttr( "role" )
|
|
.unbind( ".menubar" );
|
|
|
|
items
|
|
.unbind( ".menubar" )
|
|
.removeClass( "ui-button ui-widget ui-button-text-only ui-menubar-link ui-state-default" )
|
|
.removeAttr( "role" )
|
|
.removeAttr( "aria-haspopup" )
|
|
// TODO unwrap?
|
|
.children( "span.ui-button-text" ).each(function( i, e ) {
|
|
var item = $( this );
|
|
item.parent().html( item.html() );
|
|
})
|
|
.end()
|
|
.children( ".ui-icon" ).remove();
|
|
|
|
this.element.find( ":ui-menu" )
|
|
.menu( "destroy" )
|
|
.show()
|
|
.removeAttr( "aria-hidden" )
|
|
.removeAttr( "aria-expanded" )
|
|
.removeAttr( "tabindex" )
|
|
.unbind( ".menubar" );
|
|
},
|
|
|
|
_close: function() {
|
|
if ( !this.active || !this.active.length )
|
|
return;
|
|
this.active
|
|
.menu( "collapseAll" )
|
|
.hide()
|
|
.attr({
|
|
"aria-hidden": "true",
|
|
"aria-expanded": "false"
|
|
});
|
|
this.active
|
|
.prev()
|
|
.removeClass( "ui-state-active" )
|
|
.removeAttr( "tabIndex" );
|
|
this.active = null;
|
|
this.open = false;
|
|
},
|
|
|
|
_open: function( event, menu ) {
|
|
// on a single-button menubar, ignore reopening the same menu
|
|
if ( this.active && this.active[0] == menu[0] ) {
|
|
return;
|
|
}
|
|
// TODO refactor, almost the same as _close above, but don't remove tabIndex
|
|
if ( this.active ) {
|
|
this.active
|
|
.menu( "collapseAll" )
|
|
.hide()
|
|
.attr({
|
|
"aria-hidden": "true",
|
|
"aria-expanded": "false"
|
|
});
|
|
this.active
|
|
.prev()
|
|
.removeClass( "ui-state-active" );
|
|
}
|
|
// set tabIndex -1 to have the button skipped on shift-tab when menu is open (it gets focus)
|
|
var button = menu.prev().addClass( "ui-state-active" ).attr( "tabIndex", -1 );
|
|
this.active = menu
|
|
.show()
|
|
.position( $.extend({
|
|
of: button
|
|
}, this.options.position ) )
|
|
.removeAttr( "aria-hidden" )
|
|
.attr( "aria-expanded", "true" )
|
|
.menu("focus", event, menu.children( "li" ).first() )
|
|
// TODO need a comment here why both events are triggered
|
|
.focus()
|
|
.focusin();
|
|
this.open = true;
|
|
},
|
|
|
|
// TODO refactor this and the next three methods
|
|
_prev: function( event, button ) {
|
|
button.attr( "tabIndex", -1 );
|
|
var prev = button.parent().prevAll( "li" ).children( ".ui-button" ).eq( 0 );
|
|
if ( prev.length ) {
|
|
prev.removeAttr( "tabIndex" )[0].focus();
|
|
} else {
|
|
var lastItem = this.element.children( "li:last" ).children( ".ui-button:last" );
|
|
lastItem.removeAttr( "tabIndex" )[0].focus();
|
|
}
|
|
},
|
|
|
|
_next: function( event, button ) {
|
|
button.attr( "tabIndex", -1 );
|
|
var next = button.parent().nextAll( "li" ).children( ".ui-button" ).eq( 0 );
|
|
if ( next.length ) {
|
|
next.removeAttr( "tabIndex")[0].focus();
|
|
} else {
|
|
var firstItem = this.element.children( "li:first" ).children( ".ui-button:first" );
|
|
firstItem.removeAttr( "tabIndex" )[0].focus();
|
|
}
|
|
},
|
|
|
|
// TODO rename to parent
|
|
_left: function( event ) {
|
|
var prev = this.active.parent().prevAll( "li:eq(0)" ).children( ".ui-menu" ).eq( 0 );
|
|
if ( prev.length ) {
|
|
this._open( event, prev );
|
|
} else {
|
|
var lastItem = this.element.children( "li:last" ).children( ".ui-menu:first" );
|
|
this._open( event, lastItem );
|
|
}
|
|
},
|
|
|
|
// TODO rename to child (or something like that)
|
|
_right: function( event ) {
|
|
var next = this.active.parent().nextAll( "li:eq(0)" ).children( ".ui-menu" ).eq( 0 );
|
|
if ( next.length ) {
|
|
this._open( event, next );
|
|
} else {
|
|
var firstItem = this.element.children( "li:first" ).children( ".ui-menu:first" );
|
|
this._open( event, firstItem );
|
|
}
|
|
}
|
|
});
|
|
|
|
}( jQuery ));
|