提交 | 用户 | 时间
|
58d006
|
1 |
/** |
A |
2 |
<b>Scrollbars for sidebar</b>. This approach can <span class="text-danger">only</span> be used on <u>fixed</u> sidebar. |
|
3 |
It doesn't use <u>"overflow:hidden"</u> CSS property and therefore can be used with <u>.hover</u> submenus and minimized sidebar. |
|
4 |
Except when in mobile view and menu toggle button is not in the navbar. |
|
5 |
*/ |
|
6 |
|
|
7 |
(function($ , undefined) { |
|
8 |
//if( !$.fn.ace_scroll ) return; |
|
9 |
|
|
10 |
var old_safari = ace.vars['safari'] && navigator.userAgent.match(/version\/[1-5]/i) |
|
11 |
//NOTE |
|
12 |
//Safari on windows has not been updated for a long time. |
|
13 |
//And it has a problem when sidebar is fixed & scrollable and there is a CSS3 animation inside page content. |
|
14 |
//Very probably windows users of safari have migrated to another browser by now! |
|
15 |
|
|
16 |
var is_element_pos = |
|
17 |
'getComputedStyle' in window ? |
|
18 |
//el.offsetHeight is used to force redraw and recalculate 'el.style.position' esp. for webkit! |
|
19 |
function(el, pos) { el.offsetHeight; return window.getComputedStyle(el).position == pos } |
|
20 |
: |
|
21 |
function(el, pos) { el.offsetHeight; return $(el).css('position') == pos } |
|
22 |
|
|
23 |
|
|
24 |
function Sidebar_Scroll(sidebar , settings) { |
|
25 |
var self = this; |
|
26 |
|
|
27 |
var $window = $(window); |
|
28 |
var $sidebar = $(sidebar), |
|
29 |
$nav = $sidebar.find('.nav-list'), |
|
30 |
$toggle = $sidebar.find('.sidebar-toggle').eq(0), |
|
31 |
$shortcuts = $sidebar.find('.sidebar-shortcuts').eq(0); |
|
32 |
|
|
33 |
var nav = $nav.get(0); |
|
34 |
if(!nav) return; |
|
35 |
|
|
36 |
|
|
37 |
var attrib_values = ace.helper.getAttrSettings(sidebar, $.fn.ace_sidebar_scroll.defaults); |
|
38 |
this.settings = $.extend({}, $.fn.ace_sidebar_scroll.defaults, settings, attrib_values); |
|
39 |
var scroll_to_active = self.settings.scroll_to_active; |
|
40 |
|
|
41 |
|
|
42 |
var ace_sidebar = $sidebar.ace_sidebar('ref'); |
|
43 |
$sidebar.attr('data-sidebar-scroll', 'true'); |
|
44 |
|
|
45 |
|
|
46 |
var scroll_div = null, |
|
47 |
scroll_content = null, |
|
48 |
scroll_content_div = null, |
|
49 |
bar = null, |
|
50 |
track = null, |
|
51 |
ace_scroll = null; |
|
52 |
|
|
53 |
|
|
54 |
this.is_scrolling = false; |
|
55 |
var _initiated = false; |
|
56 |
this.sidebar_fixed = is_element_pos(sidebar, 'fixed'); |
|
57 |
|
|
58 |
var $avail_height, $content_height; |
|
59 |
|
|
60 |
|
|
61 |
var available_height = function() { |
|
62 |
//available window space |
|
63 |
var offset = $nav.parent().offset();//because `$nav.offset()` considers the "scrolled top" amount as well |
|
64 |
if(self.sidebar_fixed) offset.top -= ace.helper.scrollTop(); |
|
65 |
|
|
66 |
return $window.innerHeight() - offset.top - ( self.settings.include_toggle ? 0 : $toggle.outerHeight() ) + 1; |
|
67 |
} |
|
68 |
var content_height = function() { |
|
69 |
return nav.clientHeight;//we don't use nav.scrollHeight here, because hover submenus are considered in calculating scrollHeight despite position=absolute! |
|
70 |
} |
|
71 |
|
|
72 |
|
|
73 |
|
|
74 |
var initiate = function(on_page_load) { |
|
75 |
if( _initiated ) return; |
|
76 |
if( !self.sidebar_fixed ) return;//eligible?? |
|
77 |
//return if we want scrollbars only on "fixed" sidebar and sidebar is not "fixed" yet! |
|
78 |
|
|
79 |
//initiate once |
|
80 |
$nav.wrap('<div class="nav-wrap-up pos-rel" />'); |
|
81 |
$nav.after('<div><div></div></div>'); |
|
82 |
|
|
83 |
$nav.wrap('<div class="nav-wrap" />'); |
|
84 |
if(!self.settings.include_toggle) $toggle.css({'z-index': 1}); |
|
85 |
if(!self.settings.include_shortcuts) $shortcuts.css({'z-index': 99}); |
|
86 |
|
|
87 |
scroll_div = $nav.parent().next() |
|
88 |
.ace_scroll({ |
|
89 |
size: available_height(), |
|
90 |
//reset: true, |
|
91 |
mouseWheelLock: true, |
|
92 |
hoverReset: false, |
|
93 |
dragEvent: true, |
|
94 |
styleClass: self.settings.scroll_style, |
|
95 |
touchDrag: false//disable touch drag event on scrollbars, we'll add a custom one later |
|
96 |
}) |
|
97 |
.closest('.ace-scroll').addClass('nav-scroll'); |
|
98 |
|
|
99 |
ace_scroll = scroll_div.data('ace_scroll'); |
|
100 |
|
|
101 |
scroll_content = scroll_div.find('.scroll-content').eq(0); |
|
102 |
scroll_content_div = scroll_content.find(' > div').eq(0); |
|
103 |
|
|
104 |
track = $(ace_scroll.get_track()); |
|
105 |
bar = track.find('.scroll-bar').eq(0); |
|
106 |
|
|
107 |
if(self.settings.include_shortcuts && $shortcuts.length != 0) { |
|
108 |
$nav.parent().prepend($shortcuts).wrapInner('<div />'); |
|
109 |
$nav = $nav.parent(); |
|
110 |
} |
|
111 |
if(self.settings.include_toggle && $toggle.length != 0) { |
|
112 |
$nav.append($toggle); |
|
113 |
$nav.closest('.nav-wrap').addClass('nav-wrap-t');//it just helps to remove toggle button's top border and restore li:last-child's bottom border |
|
114 |
} |
|
115 |
|
|
116 |
$nav.css({position: 'relative'}); |
|
117 |
if( self.settings.scroll_outside == true ) scroll_div.addClass('scrollout'); |
|
118 |
|
|
119 |
nav = $nav.get(0); |
|
120 |
nav.style.top = 0; |
|
121 |
scroll_content.on('scroll.nav', function() { |
|
122 |
nav.style.top = (-1 * this.scrollTop) + 'px'; |
|
123 |
}); |
|
124 |
|
|
125 |
//mousewheel library available? |
|
126 |
$nav.on(!!$.event.special.mousewheel ? 'mousewheel.ace_scroll' : 'mousewheel.ace_scroll DOMMouseScroll.ace_scroll', function(event){ |
|
127 |
if( !self.is_scrolling || !ace_scroll.is_active() ) { |
|
128 |
return !self.settings.lock_anyway; |
|
129 |
} |
|
130 |
//transfer $nav's mousewheel event to scrollbars |
|
131 |
return scroll_div.trigger(event); |
|
132 |
}); |
|
133 |
|
|
134 |
$nav.on('mouseenter.ace_scroll', function() { |
|
135 |
track.addClass('scroll-hover'); |
|
136 |
}).on('mouseleave.ace_scroll', function() { |
|
137 |
track.removeClass('scroll-hover'); |
|
138 |
}); |
|
139 |
|
|
140 |
|
|
141 |
/** |
|
142 |
$(document.body).on('touchmove.nav', function(event) { |
|
143 |
if( self.is_scrolling && $.contains(sidebar, event.target) ) { |
|
144 |
event.preventDefault(); |
|
145 |
return false; |
|
146 |
} |
|
147 |
}) |
|
148 |
*/ |
|
149 |
|
|
150 |
//you can also use swipe event in a similar way //swipe.nav |
|
151 |
var content = scroll_content.get(0); |
|
152 |
$nav.on('ace_drag.nav', function(event) { |
|
153 |
if( !self.is_scrolling || !ace_scroll.is_active() ) { |
|
154 |
event.retval.cancel = true; |
|
155 |
return; |
|
156 |
} |
|
157 |
|
|
158 |
//if submenu hover is being scrolled let's cancel sidebar scroll! |
|
159 |
if( $(event.target).closest('.can-scroll').length != 0 ) { |
|
160 |
event.retval.cancel = true; |
|
161 |
return; |
|
162 |
} |
|
163 |
|
|
164 |
if(event.direction == 'up' || event.direction == 'down') { |
|
165 |
|
|
166 |
ace_scroll.move_bar(true); |
|
167 |
|
|
168 |
var distance = event.dy; |
|
169 |
|
|
170 |
distance = parseInt(Math.min($avail_height, distance)) |
|
171 |
if(Math.abs(distance) > 2) distance = distance * 2; |
|
172 |
|
|
173 |
if(distance != 0) { |
|
174 |
content.scrollTop = content.scrollTop + distance; |
|
175 |
nav.style.top = (-1 * content.scrollTop) + 'px'; |
|
176 |
} |
|
177 |
} |
|
178 |
}); |
|
179 |
|
|
180 |
|
|
181 |
//for drag only |
|
182 |
if(self.settings.smooth_scroll) { |
|
183 |
$nav |
|
184 |
.on('touchstart.nav MSPointerDown.nav pointerdown.nav', function(event) { |
|
185 |
$nav.css('transition-property', 'none'); |
|
186 |
bar.css('transition-property', 'none'); |
|
187 |
}) |
|
188 |
.on('touchend.nav touchcancel.nav MSPointerUp.nav MSPointerCancel.nav pointerup.nav pointercancel.nav', function(event) { |
|
189 |
$nav.css('transition-property', 'top'); |
|
190 |
bar.css('transition-property', 'top'); |
|
191 |
}); |
|
192 |
} |
|
193 |
|
|
194 |
|
|
195 |
|
|
196 |
if(old_safari && !self.settings.include_toggle) { |
|
197 |
var toggle = $toggle.get(0); |
|
198 |
if(toggle) scroll_content.on('scroll.safari', function() { |
|
199 |
ace.helper.redraw(toggle); |
|
200 |
}); |
|
201 |
} |
|
202 |
|
|
203 |
_initiated = true; |
|
204 |
|
|
205 |
//if the active item is not visible, scroll down so that it becomes visible |
|
206 |
//only the first time, on page load |
|
207 |
if(on_page_load == true) { |
|
208 |
self.reset();//try resetting at first |
|
209 |
|
|
210 |
if( scroll_to_active ) { |
|
211 |
self.scroll_to_active(); |
|
212 |
} |
|
213 |
scroll_to_active = false; |
|
214 |
} |
|
215 |
|
|
216 |
|
|
217 |
|
|
218 |
if( typeof self.settings.smooth_scroll === 'number' && self.settings.smooth_scroll > 0) { |
|
219 |
$nav.css({'transition-property': 'top', 'transition-duration': (self.settings.smooth_scroll / 1000).toFixed(2)+'s'}) |
|
220 |
bar.css({'transition-property': 'top', 'transition-duration': (self.settings.smooth_scroll / 1500).toFixed(2)+'s'}) |
|
221 |
|
|
222 |
scroll_div |
|
223 |
.on('drag.start', function(e) { |
|
224 |
e.stopPropagation(); |
|
225 |
$nav.css('transition-property', 'none') |
|
226 |
}) |
|
227 |
.on('drag.end', function(e) { |
|
228 |
e.stopPropagation(); |
|
229 |
$nav.css('transition-property', 'top') |
|
230 |
}); |
|
231 |
} |
|
232 |
|
|
233 |
if(ace.vars['android']) { |
|
234 |
//force hide address bar, because its changes don't trigger window resize and become kinda ugly |
|
235 |
var val = ace.helper.scrollTop(); |
|
236 |
if(val < 2) { |
|
237 |
window.scrollTo( val, 0 ); |
|
238 |
setTimeout( function() { |
|
239 |
self.reset(); |
|
240 |
}, 20 ); |
|
241 |
} |
|
242 |
|
|
243 |
var last_height = ace.helper.winHeight() , new_height; |
|
244 |
$(window).on('scroll.ace_scroll', function() { |
|
245 |
if(self.is_scrolling && ace_scroll.is_active()) { |
|
246 |
new_height = ace.helper.winHeight(); |
|
247 |
if(new_height != last_height) { |
|
248 |
last_height = new_height; |
|
249 |
self.reset(); |
|
250 |
} |
|
251 |
} |
|
252 |
}); |
|
253 |
} |
|
254 |
} |
|
255 |
|
|
256 |
|
|
257 |
|
|
258 |
|
|
259 |
this.scroll_to_active = function() { |
|
260 |
if( !ace_scroll || !ace_scroll.is_active() ) return; |
|
261 |
try { |
|
262 |
//sometimes there's no active item or not 'offsetTop' property |
|
263 |
var $active; |
|
264 |
|
|
265 |
var vars = ace_sidebar['vars']() |
|
266 |
|
|
267 |
var nav_list = $sidebar.find('.nav-list') |
|
268 |
if(vars['minimized'] && !vars['collapsible']) { |
|
269 |
$active = nav_list.find('> .active') |
|
270 |
} |
|
271 |
else { |
|
272 |
$active = $nav.find('> .active.hover') |
|
273 |
if($active.length == 0) $active = $nav.find('.active:not(.open)') |
|
274 |
} |
|
275 |
|
|
276 |
|
|
277 |
var top = $active.outerHeight(); |
|
278 |
nav_list = nav_list.get(0); |
|
279 |
var active = $active.get(0); |
|
280 |
while(active != nav_list) { |
|
281 |
top += active.offsetTop; |
|
282 |
active = active.parentNode; |
|
283 |
} |
|
284 |
|
|
285 |
var scroll_amount = top - scroll_div.height(); |
|
286 |
if(scroll_amount > 0) { |
|
287 |
nav.style.top = -scroll_amount + 'px'; |
|
288 |
scroll_content.scrollTop(scroll_amount); |
|
289 |
} |
|
290 |
}catch(e){} |
|
291 |
} |
|
292 |
|
|
293 |
|
|
294 |
|
|
295 |
this.reset = function(recalc) { |
|
296 |
if(recalc === true) { |
|
297 |
this.sidebar_fixed = is_element_pos(sidebar, 'fixed'); |
|
298 |
} |
|
299 |
|
|
300 |
if( !this.sidebar_fixed ) { |
|
301 |
this.disable(); |
|
302 |
return;//eligible?? |
|
303 |
} |
|
304 |
|
|
305 |
//return if we want scrollbars only on "fixed" sidebar and sidebar is not "fixed" yet! |
|
306 |
|
|
307 |
if( !_initiated ) initiate(); |
|
308 |
//initiate scrollbars if not yet |
|
309 |
|
|
310 |
var vars = ace_sidebar['vars'](); |
|
311 |
|
|
312 |
|
|
313 |
//enable if: |
|
314 |
//menu is not collapsible mode (responsive navbar-collapse mode which has default browser scrollbar) |
|
315 |
//menu is not horizontal or horizontal but mobile view (which is not navbar-collapse) |
|
316 |
//and available height is less than nav's height |
|
317 |
|
|
318 |
|
|
319 |
var enable_scroll = !vars['collapsible'] && !vars['horizontal'] |
|
320 |
&& ($avail_height = available_height()) < ($content_height = nav.clientHeight); |
|
321 |
//we don't use nav.scrollHeight here, because hover submenus are considered in calculating scrollHeight despite position=absolute! |
|
322 |
|
|
323 |
|
|
324 |
this.is_scrolling = true; |
|
325 |
if( enable_scroll ) { |
|
326 |
scroll_content_div.css({height: $content_height, width: 8}); |
|
327 |
scroll_div.prev().css({'max-height' : $avail_height}) |
|
328 |
ace_scroll.update({size: $avail_height}) |
|
329 |
ace_scroll.enable(); |
|
330 |
ace_scroll.reset(); |
|
331 |
} |
|
332 |
if( !enable_scroll || !ace_scroll.is_active() ) { |
|
333 |
if(this.is_scrolling) this.disable(); |
|
334 |
} |
|
335 |
else { |
|
336 |
$sidebar.addClass('sidebar-scroll'); |
|
337 |
} |
|
338 |
|
|
339 |
//return this.is_scrolling; |
|
340 |
} |
|
341 |
|
|
342 |
|
|
343 |
|
|
344 |
this.disable = function() { |
|
345 |
this.is_scrolling = false; |
|
346 |
if(scroll_div) { |
|
347 |
scroll_div.css({'height' : '', 'max-height' : ''}); |
|
348 |
scroll_content_div.css({height: '', width: ''});//otherwise it will have height and takes up some space even when invisible |
|
349 |
scroll_div.prev().css({'max-height' : ''}) |
|
350 |
ace_scroll.disable(); |
|
351 |
} |
|
352 |
|
|
353 |
if(parseInt(nav.style.top) < 0 && self.settings.smooth_scroll && $.support.transition.end) { |
|
354 |
$nav.one($.support.transition.end, function() { |
|
355 |
$sidebar.removeClass('sidebar-scroll'); |
|
356 |
$nav.off('.trans'); |
|
357 |
}); |
|
358 |
} else { |
|
359 |
$sidebar.removeClass('sidebar-scroll'); |
|
360 |
} |
|
361 |
|
|
362 |
nav.style.top = 0; |
|
363 |
} |
|
364 |
|
|
365 |
this.prehide = function(height_change) { |
|
366 |
if(!this.is_scrolling || ace_sidebar.get('minimized')) return;//when minimized submenu's toggle should have no effect |
|
367 |
|
|
368 |
if(content_height() + height_change < available_height()) { |
|
369 |
this.disable(); |
|
370 |
} |
|
371 |
else if(height_change < 0) { |
|
372 |
//if content height is decreasing |
|
373 |
//let's move nav down while a submenu is being hidden |
|
374 |
var scroll_top = scroll_content.scrollTop() + height_change |
|
375 |
if(scroll_top < 0) return; |
|
376 |
|
|
377 |
nav.style.top = (-1 * scroll_top) + 'px'; |
|
378 |
} |
|
379 |
} |
|
380 |
|
|
381 |
|
|
382 |
this._reset = function(recalc) { |
|
383 |
if(recalc === true) { |
|
384 |
this.sidebar_fixed = is_element_pos(sidebar, 'fixed'); |
|
385 |
} |
|
386 |
|
|
387 |
if(ace.vars['webkit']) |
|
388 |
setTimeout(function() { self.reset() } , 0); |
|
389 |
else this.reset(); |
|
390 |
} |
|
391 |
|
|
392 |
|
|
393 |
this.set_hover = function() { |
|
394 |
if(track) track.addClass('scroll-hover'); |
|
395 |
} |
|
396 |
|
|
397 |
this.get = function(name) { |
|
398 |
if(this.hasOwnProperty(name)) return this[name]; |
|
399 |
} |
|
400 |
this.set = function(name, value) { |
|
401 |
if(this.hasOwnProperty(name)) this[name] = value; |
|
402 |
} |
|
403 |
this.ref = function() { |
|
404 |
//return a reference to self |
|
405 |
return this; |
|
406 |
} |
|
407 |
|
|
408 |
this.updateStyle = function(styleClass) { |
|
409 |
if(ace_scroll == null) return; |
|
410 |
ace_scroll.update({styleClass: styleClass}); |
|
411 |
} |
|
412 |
|
|
413 |
|
|
414 |
//change scrollbar size after a submenu is hidden/shown |
|
415 |
//but don't change if sidebar is minimized |
|
416 |
$sidebar.on('hidden.ace.submenu.sidebar_scroll shown.ace.submenu.sidebar_scroll', '.submenu', function(e) { |
|
417 |
e.stopPropagation(); |
|
418 |
|
|
419 |
if( !ace_sidebar.get('minimized') ) { |
|
420 |
//webkit has a little bit of a glitch!!! |
|
421 |
self._reset(); |
|
422 |
if( e.type == 'shown' ) self.set_hover(); |
|
423 |
} |
|
424 |
}); |
|
425 |
|
|
426 |
|
|
427 |
initiate(true);//true = on_page_load |
|
428 |
} |
|
429 |
|
|
430 |
|
|
431 |
|
|
432 |
//reset on document and window changes |
|
433 |
$(document).on('settings.ace.sidebar_scroll', function(ev, event_name, event_val){ |
|
434 |
$('.sidebar[data-sidebar-scroll=true]').each(function() { |
|
435 |
var $this = $(this); |
|
436 |
var sidebar_scroll = $this.ace_sidebar_scroll('ref'); |
|
437 |
|
|
438 |
if( event_name == 'sidebar_collapsed' && is_element_pos(this, 'fixed') ) { |
|
439 |
if( $this.attr('data-sidebar-hover') == 'true' ) $this.ace_sidebar_hover('reset'); |
|
440 |
sidebar_scroll._reset(); |
|
441 |
} |
|
442 |
else if( event_name === 'sidebar_fixed' || event_name === 'navbar_fixed' ) { |
|
443 |
var is_scrolling = sidebar_scroll.get('is_scrolling'); |
|
444 |
var sidebar_fixed = is_element_pos(this, 'fixed') |
|
445 |
sidebar_scroll.set('sidebar_fixed', sidebar_fixed); |
|
446 |
|
|
447 |
if(sidebar_fixed && !is_scrolling) { |
|
448 |
sidebar_scroll._reset(); |
|
449 |
} |
|
450 |
else if( !sidebar_fixed ) { |
|
451 |
sidebar_scroll.disable(); |
|
452 |
} |
|
453 |
} |
|
454 |
|
|
455 |
}); |
|
456 |
}); |
|
457 |
|
|
458 |
$(window).on('resize.ace.sidebar_scroll', function(){ |
|
459 |
$('.sidebar[data-sidebar-scroll=true]').each(function() { |
|
460 |
var $this = $(this); |
|
461 |
if( $this.attr('data-sidebar-hover') == 'true' ) $this.ace_sidebar_hover('reset'); |
|
462 |
///////////// |
|
463 |
var sidebar_scroll = $(this).ace_sidebar_scroll('ref'); |
|
464 |
|
|
465 |
var sidebar_fixed = is_element_pos(this, 'fixed') |
|
466 |
sidebar_scroll.set('sidebar_fixed', sidebar_fixed); |
|
467 |
sidebar_scroll._reset(); |
|
468 |
}); |
|
469 |
}) |
|
470 |
|
|
471 |
|
|
472 |
|
|
473 |
|
|
474 |
///////////////////////////////////////////// |
|
475 |
if(!$.fn.ace_sidebar_scroll) { |
|
476 |
$.fn.ace_sidebar_scroll = function (option, value) { |
|
477 |
var method_call; |
|
478 |
|
|
479 |
var $set = this.each(function () { |
|
480 |
var $this = $(this); |
|
481 |
var data = $this.data('ace_sidebar_scroll'); |
|
482 |
var options = typeof option === 'object' && option; |
|
483 |
|
|
484 |
if (!data) $this.data('ace_sidebar_scroll', (data = new Sidebar_Scroll(this, options))); |
|
485 |
if (typeof option === 'string' && typeof data[option] === 'function') { |
|
486 |
method_call = data[option](value); |
|
487 |
} |
|
488 |
}); |
|
489 |
|
|
490 |
return (method_call === undefined) ? $set : method_call; |
|
491 |
} |
|
492 |
|
|
493 |
|
|
494 |
$.fn.ace_sidebar_scroll.defaults = { |
|
495 |
'scroll_to_active': true, |
|
496 |
'include_shortcuts': true, |
|
497 |
'include_toggle': false, |
|
498 |
'smooth_scroll': 150, |
|
499 |
'scroll_outside': false, |
|
500 |
'scroll_style': '', |
|
501 |
'lock_anyway': false |
|
502 |
} |
|
503 |
|
|
504 |
} |
|
505 |
|
|
506 |
})(window.jQuery); |