Context Navigation

source: ether_iasi/trunk/web/resources/js/library/jquery-ui-1.9.2.custom/development-bundle/ui/jquery.ui.menu.js @ 786

Last change on this file since 786 was 786, checked in by cbipsl, 10 years ago
commit temp bug libraries
File size: 15.8 KB

Line
1	/*!
2	* jQuery UI Menu 1.9.2
3	* http://jqueryui.com
4	*
5	* Copyright 2012 jQuery Foundation and other contributors
6	* Released under the MIT license.
7	* http://jquery.org/license
8	*
9	* http://api.jqueryui.com/menu/
10	*
11	* Depends:
12	* jquery.ui.core.js
13	* jquery.ui.widget.js
14	* jquery.ui.position.js
15	*/
16	(function( $, undefined ) {
17
18	var mouseHandled = false;
19
20	$.widget( "ui.menu", {
21	version: "1.9.2",
22	defaultElement: "<ul>",
23	delay: 300,
24	options: {
25	icons: {
26	submenu: "ui-icon-carat-1-e"
27	},
28	menus: "ul",
29	position: {
30	my: "left top",
31	at: "right top"
32	},
33	role: "menu",
34
35	// callbacks
36	blur: null,
37	focus: null,
38	select: null
39	},
40
41	_create: function() {
42	this.activeMenu = this.element;
43	this.element
44	.uniqueId()
45	.addClass( "ui-menu ui-widget ui-widget-content ui-corner-all" )
46	.toggleClass( "ui-menu-icons", !!this.element.find( ".ui-icon" ).length )
47	.attr({
48	role: this.options.role,
49	tabIndex: 0
50	})
51	// need to catch all clicks on disabled menu
52	// not possible through _on
53	.bind( "click" + this.eventNamespace, $.proxy(function( event ) {
54	if ( this.options.disabled ) {
55	event.preventDefault();
56	}
57	}, this ));
58
59	if ( this.options.disabled ) {
60	this.element
61	.addClass( "ui-state-disabled" )
62	.attr( "aria-disabled", "true" );
63	}
64
65	this._on({
66	// Prevent focus from sticking to links inside menu after clicking
67	// them (focus should always stay on UL during navigation).
68	"mousedown .ui-menu-item > a": function( event ) {
69	event.preventDefault();
70	},
71	"click .ui-state-disabled > a": function( event ) {
72	event.preventDefault();
73	},
74	"click .ui-menu-item:has(a)": function( event ) {
75	var target = $( event.target ).closest( ".ui-menu-item" );
76	if ( !mouseHandled && target.not( ".ui-state-disabled" ).length ) {
77	mouseHandled = true;
78
79	this.select( event );
80	// Open submenu on click
81	if ( target.has( ".ui-menu" ).length ) {
82	this.expand( event );
83	} else if ( !this.element.is( ":focus" ) ) {
84	// Redirect focus to the menu
85	this.element.trigger( "focus", [ true ] );
86
87	// If the active item is on the top level, let it stay active.
88	// Otherwise, blur the active item since it is no longer visible.
89	if ( this.active && this.active.parents( ".ui-menu" ).length === 1 ) {
90	clearTimeout( this.timer );
91	}
92	}
93	}
94	},
95	"mouseenter .ui-menu-item": function( event ) {
96	var target = $( event.currentTarget );
97	// Remove ui-state-active class from siblings of the newly focused menu item
98	// to avoid a jump caused by adjacent elements both having a class with a border
99	target.siblings().children( ".ui-state-active" ).removeClass( "ui-state-active" );
100	this.focus( event, target );
101	},
102	mouseleave: "collapseAll",
103	"mouseleave .ui-menu": "collapseAll",
104	focus: function( event, keepActiveItem ) {
105	// If there's already an active item, keep it active
106	// If not, activate the first item
107	var item = this.active \|\| this.element.children( ".ui-menu-item" ).eq( 0 );
108
109	if ( !keepActiveItem ) {
110	this.focus( event, item );
111	}
112	},
113	blur: function( event ) {
114	this._delay(function() {
115	if ( !$.contains( this.element[0], this.document[0].activeElement ) ) {
116	this.collapseAll( event );
117	}
118	});
119	},
120	keydown: "_keydown"
121	});
122
123	this.refresh();
124
125	// Clicks outside of a menu collapse any open menus
126	this._on( this.document, {
127	click: function( event ) {
128	if ( !$( event.target ).closest( ".ui-menu" ).length ) {
129	this.collapseAll( event );
130	}
131
132	// Reset the mouseHandled flag
133	mouseHandled = false;
134	}
135	});
136	},
137
138	_destroy: function() {
139	// Destroy (sub)menus
140	this.element
141	.removeAttr( "aria-activedescendant" )
142	.find( ".ui-menu" ).andSelf()
143	.removeClass( "ui-menu ui-widget ui-widget-content ui-corner-all ui-menu-icons" )
144	.removeAttr( "role" )
145	.removeAttr( "tabIndex" )
146	.removeAttr( "aria-labelledby" )
147	.removeAttr( "aria-expanded" )
148	.removeAttr( "aria-hidden" )
149	.removeAttr( "aria-disabled" )
150	.removeUniqueId()
151	.show();
152
153	// Destroy menu items
154	this.element.find( ".ui-menu-item" )
155	.removeClass( "ui-menu-item" )
156	.removeAttr( "role" )
157	.removeAttr( "aria-disabled" )
158	.children( "a" )
159	.removeUniqueId()
160	.removeClass( "ui-corner-all ui-state-hover" )
161	.removeAttr( "tabIndex" )
162	.removeAttr( "role" )
163	.removeAttr( "aria-haspopup" )
164	.children().each( function() {
165	var elem = $( this );
166	if ( elem.data( "ui-menu-submenu-carat" ) ) {
167	elem.remove();
168	}
169	});
170
171	// Destroy menu dividers
172	this.element.find( ".ui-menu-divider" ).removeClass( "ui-menu-divider ui-widget-content" );
173	},
174
175	_keydown: function( event ) {
176	var match, prev, character, skip, regex,
177	preventDefault = true;
178
179	function escape( value ) {
180	return value.replace( /[\-\[\]{}()*+?.,\\\^$\|#\s]/g, "\\$&" );
181	}
182
183	switch ( event.keyCode ) {
184	case $.ui.keyCode.PAGE_UP:
185	this.previousPage( event );
186	break;
187	case $.ui.keyCode.PAGE_DOWN:
188	this.nextPage( event );
189	break;
190	case $.ui.keyCode.HOME:
191	this._move( "first", "first", event );
192	break;
193	case $.ui.keyCode.END:
194	this._move( "last", "last", event );
195	break;
196	case $.ui.keyCode.UP:
197	this.previous( event );
198	break;
199	case $.ui.keyCode.DOWN:
200	this.next( event );
201	break;
202	case $.ui.keyCode.LEFT:
203	this.collapse( event );
204	break;
205	case $.ui.keyCode.RIGHT:
206	if ( this.active && !this.active.is( ".ui-state-disabled" ) ) {
207	this.expand( event );
208	}
209	break;
210	case $.ui.keyCode.ENTER:
211	case $.ui.keyCode.SPACE:
212	this._activate( event );
213	break;
214	case $.ui.keyCode.ESCAPE:
215	this.collapse( event );
216	break;
217	default:
218	preventDefault = false;
219	prev = this.previousFilter \|\| "";
220	character = String.fromCharCode( event.keyCode );
221	skip = false;
222
223	clearTimeout( this.filterTimer );
224
225	if ( character === prev ) {
226	skip = true;
227	} else {
228	character = prev + character;
229	}
230
231	regex = new RegExp( "^" + escape( character ), "i" );
232	match = this.activeMenu.children( ".ui-menu-item" ).filter(function() {
233	return regex.test( $( this ).children( "a" ).text() );
234	});
235	match = skip && match.index( this.active.next() ) !== -1 ?
236	this.active.nextAll( ".ui-menu-item" ) :
237	match;
238
239	// If no matches on the current filter, reset to the last character pressed
240	// to move down the menu to the first item that starts with that character
241	if ( !match.length ) {
242	character = String.fromCharCode( event.keyCode );
243	regex = new RegExp( "^" + escape( character ), "i" );
244	match = this.activeMenu.children( ".ui-menu-item" ).filter(function() {
245	return regex.test( $( this ).children( "a" ).text() );
246	});
247	}
248
249	if ( match.length ) {
250	this.focus( event, match );
251	if ( match.length > 1 ) {
252	this.previousFilter = character;
253	this.filterTimer = this._delay(function() {
254	delete this.previousFilter;
255	}, 1000 );
256	} else {
257	delete this.previousFilter;
258	}
259	} else {
260	delete this.previousFilter;
261	}
262	}
263
264	if ( preventDefault ) {
265	event.preventDefault();
266	}
267	},
268
269	_activate: function( event ) {
270	if ( !this.active.is( ".ui-state-disabled" ) ) {
271	if ( this.active.children( "a[aria-haspopup='true']" ).length ) {
272	this.expand( event );
273	} else {
274	this.select( event );
275	}
276	}
277	},
278
279	refresh: function() {
280	var menus,
281	icon = this.options.icons.submenu,
282	submenus = this.element.find( this.options.menus );
283
284	// Initialize nested menus
285	submenus.filter( ":not(.ui-menu)" )
286	.addClass( "ui-menu ui-widget ui-widget-content ui-corner-all" )
287	.hide()
288	.attr({
289	role: this.options.role,
290	"aria-hidden": "true",
291	"aria-expanded": "false"
292	})
293	.each(function() {
294	var menu = $( this ),
295	item = menu.prev( "a" ),
296	submenuCarat = $( "<span>" )
297	.addClass( "ui-menu-icon ui-icon " + icon )
298	.data( "ui-menu-submenu-carat", true );
299
300	item
301	.attr( "aria-haspopup", "true" )
302	.prepend( submenuCarat );
303	menu.attr( "aria-labelledby", item.attr( "id" ) );
304	});
305
306	menus = submenus.add( this.element );
307
308	// Don't refresh list items that are already adapted
309	menus.children( ":not(.ui-menu-item):has(a)" )
310	.addClass( "ui-menu-item" )
311	.attr( "role", "presentation" )
312	.children( "a" )
313	.uniqueId()
314	.addClass( "ui-corner-all" )
315	.attr({
316	tabIndex: -1,
317	role: this._itemRole()
318	});
319
320	// Initialize unlinked menu-items containing spaces and/or dashes only as dividers
321	menus.children( ":not(.ui-menu-item)" ).each(function() {
322	var item = $( this );
323	// hyphen, em dash, en dash
324	if ( !/[^\-ââ\s]/.test( item.text() ) ) {
325	item.addClass( "ui-widget-content ui-menu-divider" );
326	}
327	});
328
329	// Add aria-disabled attribute to any disabled menu item
330	menus.children( ".ui-state-disabled" ).attr( "aria-disabled", "true" );
331
332	// If the active item has been removed, blur the menu
333	if ( this.active && !$.contains( this.element[ 0 ], this.active[ 0 ] ) ) {
334	this.blur();
335	}
336	},
337
338	_itemRole: function() {
339	return {
340	menu: "menuitem",
341	listbox: "option"
342	}[ this.options.role ];
343	},
344
345	focus: function( event, item ) {
346	var nested, focused;
347	this.blur( event, event && event.type === "focus" );
348
349	this._scrollIntoView( item );
350
351	this.active = item.first();
352	focused = this.active.children( "a" ).addClass( "ui-state-focus" );
353	// Only update aria-activedescendant if there's a role
354	// otherwise we assume focus is managed elsewhere
355	if ( this.options.role ) {
356	this.element.attr( "aria-activedescendant", focused.attr( "id" ) );
357	}
358
359	// Highlight active parent menu item, if any
360	this.active
361	.parent()
362	.closest( ".ui-menu-item" )
363	.children( "a:first" )
364	.addClass( "ui-state-active" );
365
366	if ( event && event.type === "keydown" ) {
367	this._close();
368	} else {
369	this.timer = this._delay(function() {
370	this._close();
371	}, this.delay );
372	}
373
374	nested = item.children( ".ui-menu" );
375	if ( nested.length && ( /^mouse/.test( event.type ) ) ) {
376	this._startOpening(nested);
377	}
378	this.activeMenu = item.parent();
379
380	this._trigger( "focus", event, { item: item } );
381	},
382
383	_scrollIntoView: function( item ) {
384	var borderTop, paddingTop, offset, scroll, elementHeight, itemHeight;
385	if ( this._hasScroll() ) {
386	borderTop = parseFloat( $.css( this.activeMenu[0], "borderTopWidth" ) ) \|\| 0;
387	paddingTop = parseFloat( $.css( this.activeMenu[0], "paddingTop" ) ) \|\| 0;
388	offset = item.offset().top - this.activeMenu.offset().top - borderTop - paddingTop;
389	scroll = this.activeMenu.scrollTop();
390	elementHeight = this.activeMenu.height();
391	itemHeight = item.height();
392
393	if ( offset < 0 ) {
394	this.activeMenu.scrollTop( scroll + offset );
395	} else if ( offset + itemHeight > elementHeight ) {
396	this.activeMenu.scrollTop( scroll + offset - elementHeight + itemHeight );
397	}
398	}
399	},
400
401	blur: function( event, fromFocus ) {
402	if ( !fromFocus ) {
403	clearTimeout( this.timer );
404	}
405
406	if ( !this.active ) {
407	return;
408	}
409
410	this.active.children( "a" ).removeClass( "ui-state-focus" );
411	this.active = null;
412
413	this._trigger( "blur", event, { item: this.active } );
414	},
415
416	_startOpening: function( submenu ) {
417	clearTimeout( this.timer );
418
419	// Don't open if already open fixes a Firefox bug that caused a .5 pixel
420	// shift in the submenu position when mousing over the carat icon
421	if ( submenu.attr( "aria-hidden" ) !== "true" ) {
422	return;
423	}
424
425	this.timer = this._delay(function() {
426	this._close();
427	this._open( submenu );
428	}, this.delay );
429	},
430
431	_open: function( submenu ) {
432	var position = $.extend({
433	of: this.active
434	}, this.options.position );
435
436	clearTimeout( this.timer );
437	this.element.find( ".ui-menu" ).not( submenu.parents( ".ui-menu" ) )
438	.hide()
439	.attr( "aria-hidden", "true" );
440
441	submenu
442	.show()
443	.removeAttr( "aria-hidden" )
444	.attr( "aria-expanded", "true" )
445	.position( position );
446	},
447
448	collapseAll: function( event, all ) {
449	clearTimeout( this.timer );
450	this.timer = this._delay(function() {
451	// If we were passed an event, look for the submenu that contains the event
452	var currentMenu = all ? this.element :
453	$( event && event.target ).closest( this.element.find( ".ui-menu" ) );
454
455	// If we found no valid submenu ancestor, use the main menu to close all sub menus anyway
456	if ( !currentMenu.length ) {
457	currentMenu = this.element;
458	}
459
460	this._close( currentMenu );
461
462	this.blur( event );
463	this.activeMenu = currentMenu;
464	}, this.delay );
465	},
466
467	// With no arguments, closes the currently active menu - if nothing is active
468	// it closes all menus. If passed an argument, it will search for menus BELOW
469	_close: function( startMenu ) {
470	if ( !startMenu ) {
471	startMenu = this.active ? this.active.parent() : this.element;
472	}
473
474	startMenu
475	.find( ".ui-menu" )
476	.hide()
477	.attr( "aria-hidden", "true" )
478	.attr( "aria-expanded", "false" )
479	.end()
480	.find( "a.ui-state-active" )
481	.removeClass( "ui-state-active" );
482	},
483
484	collapse: function( event ) {
485	var newItem = this.active &&
486	this.active.parent().closest( ".ui-menu-item", this.element );
487	if ( newItem && newItem.length ) {
488	this._close();
489	this.focus( event, newItem );
490	}
491	},
492
493	expand: function( event ) {
494	var newItem = this.active &&
495	this.active
496	.children( ".ui-menu " )
497	.children( ".ui-menu-item" )
498	.first();
499
500	if ( newItem && newItem.length ) {
501	this._open( newItem.parent() );
502
503	// Delay so Firefox will not hide activedescendant change in expanding submenu from AT
504	this._delay(function() {
505	this.focus( event, newItem );
506	});
507	}
508	},
509
510	next: function( event ) {
511	this._move( "next", "first", event );
512	},
513
514	previous: function( event ) {
515	this._move( "prev", "last", event );
516	},
517
518	isFirstItem: function() {
519	return this.active && !this.active.prevAll( ".ui-menu-item" ).length;
520	},
521
522	isLastItem: function() {
523	return this.active && !this.active.nextAll( ".ui-menu-item" ).length;
524	},
525
526	_move: function( direction, filter, event ) {
527	var next;
528	if ( this.active ) {
529	if ( direction === "first" \|\| direction === "last" ) {
530	next = this.active
531	[ direction === "first" ? "prevAll" : "nextAll" ]( ".ui-menu-item" )
532	.eq( -1 );
533	} else {
534	next = this.active
535	[ direction + "All" ]( ".ui-menu-item" )
536	.eq( 0 );
537	}
538	}
539	if ( !next \|\| !next.length \|\| !this.active ) {
540	next = this.activeMenu.children( ".ui-menu-item" )[ filter ]();
541	}
542
543	this.focus( event, next );
544	},
545
546	nextPage: function( event ) {
547	var item, base, height;
548
549	if ( !this.active ) {
550	this.next( event );
551	return;
552	}
553	if ( this.isLastItem() ) {
554	return;
555	}
556	if ( this._hasScroll() ) {
557	base = this.active.offset().top;
558	height = this.element.height();
559	this.active.nextAll( ".ui-menu-item" ).each(function() {
560	item = $( this );
561	return item.offset().top - base - height < 0;
562	});
563
564	this.focus( event, item );
565	} else {
566	this.focus( event, this.activeMenu.children( ".ui-menu-item" )
567	[ !this.active ? "first" : "last" ]() );
568	}
569	},
570
571	previousPage: function( event ) {
572	var item, base, height;
573	if ( !this.active ) {
574	this.next( event );
575	return;
576	}
577	if ( this.isFirstItem() ) {
578	return;
579	}
580	if ( this._hasScroll() ) {
581	base = this.active.offset().top;
582	height = this.element.height();
583	this.active.prevAll( ".ui-menu-item" ).each(function() {
584	item = $( this );
585	return item.offset().top - base + height > 0;
586	});
587
588	this.focus( event, item );
589	} else {
590	this.focus( event, this.activeMenu.children( ".ui-menu-item" ).first() );
591	}
592	},
593
594	_hasScroll: function() {
595	return this.element.outerHeight() < this.element.prop( "scrollHeight" );
596	},
597
598	select: function( event ) {
599	// TODO: It should never be possible to not have an active item at this
600	// point, but the tests don't trigger mouseenter before click.
601	this.active = this.active \|\| $( event.target ).closest( ".ui-menu-item" );
602	var ui = { item: this.active };
603	if ( !this.active.has( ".ui-menu" ).length ) {
604	this.collapseAll( event, true );
605	}
606	this._trigger( "select", event, ui );
607	}
608	});
609
610	}( jQuery ));

Note: See TracBrowser for help on using the repository browser.

Download in other formats: