blob: 6630bf93694f157238f732ad02a74bb44ccb1ed8 [file] [log] [blame]
Dirk Dougherty541b4942014-02-14 18:31:53 -08001var classesNav;
2var devdocNav;
3var sidenav;
4var cookie_namespace = 'android_developer';
5var NAV_PREF_TREE = "tree";
6var NAV_PREF_PANELS = "panels";
7var nav_pref;
8var isMobile = false; // true if mobile, so we can adjust some layout
9var mPagePath; // initialized in ready() function
10
11var basePath = getBaseUri(location.pathname);
12var SITE_ROOT = toRoot + basePath.substring(1,basePath.indexOf("/",1));
13var GOOGLE_DATA; // combined data for google service apis, used for search suggest
14
15// Ensure that all ajax getScript() requests allow caching
16$.ajaxSetup({
17 cache: true
18});
19
20/****** ON LOAD SET UP STUFF *********/
21
22var navBarIsFixed = false;
23$(document).ready(function() {
24
25 // load json file for JD doc search suggestions
26 $.getScript(toRoot + 'jd_lists_unified.js');
27 // load json file for Android API search suggestions
28 $.getScript(toRoot + 'reference/lists.js');
29 // load json files for Google services API suggestions
30 $.getScript(toRoot + 'reference/gcm_lists.js', function(data, textStatus, jqxhr) {
31 // once the GCM json (GCM_DATA) is loaded, load the GMS json (GMS_DATA) and merge the data
32 if(jqxhr.status === 200) {
33 $.getScript(toRoot + 'reference/gms_lists.js', function(data, textStatus, jqxhr) {
34 if(jqxhr.status === 200) {
35 // combine GCM and GMS data
36 GOOGLE_DATA = GMS_DATA;
37 var start = GOOGLE_DATA.length;
38 for (var i=0; i<GCM_DATA.length; i++) {
39 GOOGLE_DATA.push({id:start+i, label:GCM_DATA[i].label,
40 link:GCM_DATA[i].link, type:GCM_DATA[i].type});
41 }
42 }
43 });
44 }
45 });
46
47 // setup keyboard listener for search shortcut
48 $('body').keyup(function(event) {
49 if (event.which == 191) {
50 $('#search_autocomplete').focus();
51 }
52 });
53
54 // init the fullscreen toggle click event
55 $('#nav-swap .fullscreen').click(function(){
56 if ($(this).hasClass('disabled')) {
57 toggleFullscreen(true);
58 } else {
59 toggleFullscreen(false);
60 }
61 });
62
63 // initialize the divs with custom scrollbars
64 $('.scroll-pane').jScrollPane( {verticalGutter:0} );
65
66 // add HRs below all H2s (except for a few other h2 variants)
67 $('h2').not('#qv h2').not('#tb h2').not('.sidebox h2').not('#devdoc-nav h2').not('h2.norule').css({marginBottom:0}).after('<hr/>');
68
69 // set up the search close button
70 $('.search .close').click(function() {
71 $searchInput = $('#search_autocomplete');
72 $searchInput.attr('value', '');
73 $(this).addClass("hide");
74 $("#search-container").removeClass('active');
75 $("#search_autocomplete").blur();
76 search_focus_changed($searchInput.get(), false);
77 hideResults();
78 });
79
80 // Set up quicknav
81 var quicknav_open = false;
82 $("#btn-quicknav").click(function() {
83 if (quicknav_open) {
84 $(this).removeClass('active');
85 quicknav_open = false;
86 collapse();
87 } else {
88 $(this).addClass('active');
89 quicknav_open = true;
90 expand();
91 }
92 })
93
94 var expand = function() {
95 $('#header-wrap').addClass('quicknav');
96 $('#quicknav').stop().show().animate({opacity:'1'});
97 }
98
99 var collapse = function() {
100 $('#quicknav').stop().animate({opacity:'0'}, 100, function() {
101 $(this).hide();
102 $('#header-wrap').removeClass('quicknav');
103 });
104 }
105
106
107 //Set up search
108 $("#search_autocomplete").focus(function() {
109 $("#search-container").addClass('active');
110 })
111 $("#search-container").mouseover(function() {
112 $("#search-container").addClass('active');
113 $("#search_autocomplete").focus();
114 })
115 $("#search-container").mouseout(function() {
116 if ($("#search_autocomplete").is(":focus")) return;
117 if ($("#search_autocomplete").val() == '') {
118 setTimeout(function(){
119 $("#search-container").removeClass('active');
120 $("#search_autocomplete").blur();
121 },250);
122 }
123 })
124 $("#search_autocomplete").blur(function() {
125 if ($("#search_autocomplete").val() == '') {
126 $("#search-container").removeClass('active');
127 }
128 })
129
130
131 // prep nav expandos
132 var pagePath = document.location.pathname;
133 // account for intl docs by removing the intl/*/ path
134 if (pagePath.indexOf("/intl/") == 0) {
135 pagePath = pagePath.substr(pagePath.indexOf("/",6)); // start after intl/ to get last /
136 }
137
138 if (pagePath.indexOf(SITE_ROOT) == 0) {
139 if (pagePath == '' || pagePath.charAt(pagePath.length - 1) == '/') {
140 pagePath += 'index.html';
141 }
142 }
143
144 // Need a copy of the pagePath before it gets changed in the next block;
145 // it's needed to perform proper tab highlighting in offline docs (see rootDir below)
146 var pagePathOriginal = pagePath;
147 if (SITE_ROOT.match(/\.\.\//) || SITE_ROOT == '') {
148 // If running locally, SITE_ROOT will be a relative path, so account for that by
149 // finding the relative URL to this page. This will allow us to find links on the page
150 // leading back to this page.
151 var pathParts = pagePath.split('/');
152 var relativePagePathParts = [];
153 var upDirs = (SITE_ROOT.match(/(\.\.\/)+/) || [''])[0].length / 3;
154 for (var i = 0; i < upDirs; i++) {
155 relativePagePathParts.push('..');
156 }
157 for (var i = 0; i < upDirs; i++) {
158 relativePagePathParts.push(pathParts[pathParts.length - (upDirs - i) - 1]);
159 }
160 relativePagePathParts.push(pathParts[pathParts.length - 1]);
161 pagePath = relativePagePathParts.join('/');
162 } else {
163 // Otherwise the page path is already an absolute URL
164 }
165
166 // Highlight the header tabs...
167 // highlight Design tab
168 if ($("body").hasClass("design")) {
169 $("#header li.design a").addClass("selected");
170
171 // highlight Develop tab
172 } else if ($("body").hasClass("develop") || $("body").hasClass("google")) {
173 $("#header li.develop a").addClass("selected");
174 // In Develop docs, also highlight appropriate sub-tab
175 var rootDir = pagePathOriginal.substring(1,pagePathOriginal.indexOf('/', 1));
176 if (rootDir == "training") {
177 $("#nav-x li.training a").addClass("selected");
178 } else if (rootDir == "guide") {
179 $("#nav-x li.guide a").addClass("selected");
180 } else if (rootDir == "reference") {
181 // If the root is reference, but page is also part of Google Services, select Google
182 if ($("body").hasClass("google")) {
183 $("#nav-x li.google a").addClass("selected");
184 } else {
185 $("#nav-x li.reference a").addClass("selected");
186 }
187 } else if ((rootDir == "tools") || (rootDir == "sdk")) {
188 $("#nav-x li.tools a").addClass("selected");
189 } else if ($("body").hasClass("google")) {
190 $("#nav-x li.google a").addClass("selected");
191 } else if ($("body").hasClass("samples")) {
192 $("#nav-x li.samples a").addClass("selected");
193 }
194
195 // highlight Distribute tab
196 } else if ($("body").hasClass("distribute")) {
197 $("#header li.distribute a").addClass("selected");
198 }
199
200 // set global variable so we can highlight the sidenav a bit later (such as for google reference)
201 // and highlight the sidenav
202 mPagePath = pagePath;
203 highlightSidenav();
204
205 // set up prev/next links if they exist
206 var $selNavLink = $('#nav').find('a[href="' + pagePath + '"]');
207 var $selListItem;
208 if ($selNavLink.length) {
209 $selListItem = $selNavLink.closest('li');
210
211 // set up prev links
212 var $prevLink = [];
213 var $prevListItem = $selListItem.prev('li');
214
215 var crossBoundaries = ($("body.design").length > 0) || ($("body.guide").length > 0) ? true :
216false; // navigate across topic boundaries only in design docs
217 if ($prevListItem.length) {
218 if ($prevListItem.hasClass('nav-section')) {
219 // jump to last topic of previous section
220 $prevLink = $prevListItem.find('a:last');
221 } else if (!$selListItem.hasClass('nav-section')) {
222 // jump to previous topic in this section
223 $prevLink = $prevListItem.find('a:eq(0)');
224 }
225 } else {
226 // jump to this section's index page (if it exists)
227 var $parentListItem = $selListItem.parents('li');
228 $prevLink = $selListItem.parents('li').find('a');
229
230 // except if cross boundaries aren't allowed, and we're at the top of a section already
231 // (and there's another parent)
232 if (!crossBoundaries && $parentListItem.hasClass('nav-section')
233 && $selListItem.hasClass('nav-section')) {
234 $prevLink = [];
235 }
236 }
237
238 // set up next links
239 var $nextLink = [];
240 var startClass = false;
241 var training = $(".next-class-link").length; // decides whether to provide "next class" link
242 var isCrossingBoundary = false;
243
244 if ($selListItem.hasClass('nav-section') && $selListItem.children('div.empty').length == 0) {
245 // we're on an index page, jump to the first topic
246 $nextLink = $selListItem.find('ul:eq(0)').find('a:eq(0)');
247
248 // if there aren't any children, go to the next section (required for About pages)
249 if($nextLink.length == 0) {
250 $nextLink = $selListItem.next('li').find('a');
251 } else if ($('.topic-start-link').length) {
252 // as long as there's a child link and there is a "topic start link" (we're on a landing)
253 // then set the landing page "start link" text to be the first doc title
254 $('.topic-start-link').text($nextLink.text().toUpperCase());
255 }
256
257 // If the selected page has a description, then it's a class or article homepage
258 if ($selListItem.find('a[description]').length) {
259 // this means we're on a class landing page
260 startClass = true;
261 }
262 } else {
263 // jump to the next topic in this section (if it exists)
264 $nextLink = $selListItem.next('li').find('a:eq(0)');
265 if ($nextLink.length == 0) {
266 isCrossingBoundary = true;
267 // no more topics in this section, jump to the first topic in the next section
268 $nextLink = $selListItem.parents('li:eq(0)').next('li.nav-section').find('a:eq(0)');
269 if (!$nextLink.length) { // Go up another layer to look for next page (lesson > class > course)
270 $nextLink = $selListItem.parents('li:eq(1)').next('li.nav-section').find('a:eq(0)');
271 if ($nextLink.length == 0) {
272 // if that doesn't work, we're at the end of the list, so disable NEXT link
273 $('.next-page-link').attr('href','').addClass("disabled")
274 .click(function() { return false; });
275 }
276 }
277 }
278 }
279
280 if (startClass) {
281 $('.start-class-link').attr('href', $nextLink.attr('href')).removeClass("hide");
282
283 // if there's no training bar (below the start button),
284 // then we need to add a bottom border to button
285 if (!$("#tb").length) {
286 $('.start-class-link').css({'border-bottom':'1px solid #DADADA'});
287 }
288 } else if (isCrossingBoundary && !$('body.design').length) { // Design always crosses boundaries
289 $('.content-footer.next-class').show();
290 $('.next-page-link').attr('href','')
291 .removeClass("hide").addClass("disabled")
292 .click(function() { return false; });
293 if ($nextLink.length) {
294 $('.next-class-link').attr('href',$nextLink.attr('href'))
295 .removeClass("hide").append($nextLink.html());
296 $('.next-class-link').find('.new').empty();
297 }
298 } else {
299 $('.next-page-link').attr('href', $nextLink.attr('href')).removeClass("hide");
300 }
301
302 if (!startClass && $prevLink.length) {
303 var prevHref = $prevLink.attr('href');
304 if (prevHref == SITE_ROOT + 'index.html') {
305 // Don't show Previous when it leads to the homepage
306 } else {
307 $('.prev-page-link').attr('href', $prevLink.attr('href')).removeClass("hide");
308 }
309 }
310
311 // If this is a training 'article', there should be no prev/next nav
312 // ... if the grandparent is the "nav" ... and it has no child list items...
313 if (training && $selListItem.parents('ul').eq(1).is('[id="nav"]') &&
314 !$selListItem.find('li').length) {
315 $('.next-page-link,.prev-page-link').attr('href','').addClass("disabled")
316 .click(function() { return false; });
317 }
318
319 }
320
321
322
323 // Set up the course landing pages for Training with class names and descriptions
324 if ($('body.trainingcourse').length) {
325 var $classLinks = $selListItem.find('ul li a').not('#nav .nav-section .nav-section ul a');
326 var $classDescriptions = $classLinks.attr('description');
327
328 var $olClasses = $('<ol class="class-list"></ol>');
329 var $liClass;
330 var $imgIcon;
331 var $h2Title;
332 var $pSummary;
333 var $olLessons;
334 var $liLesson;
335 $classLinks.each(function(index) {
336 $liClass = $('<li></li>');
337 $h2Title = $('<a class="title" href="'+$(this).attr('href')+'"><h2>' + $(this).html()+'</h2><span></span></a>');
338 $pSummary = $('<p class="description">' + $(this).attr('description') + '</p>');
339
340 $olLessons = $('<ol class="lesson-list"></ol>');
341
342 $lessons = $(this).closest('li').find('ul li a');
343
344 if ($lessons.length) {
345 $imgIcon = $('<img src="'+toRoot+'assets/images/resource-tutorial.png" '
346 + ' width="64" height="64" alt=""/>');
347 $lessons.each(function(index) {
348 $olLessons.append('<li><a href="'+$(this).attr('href')+'">' + $(this).html()+'</a></li>');
349 });
350 } else {
351 $imgIcon = $('<img src="'+toRoot+'assets/images/resource-article.png" '
352 + ' width="64" height="64" alt=""/>');
353 $pSummary.addClass('article');
354 }
355
356 $liClass.append($h2Title).append($imgIcon).append($pSummary).append($olLessons);
357 $olClasses.append($liClass);
358 });
359 $('.jd-descr').append($olClasses);
360 }
361
362 // Set up expand/collapse behavior
363 initExpandableNavItems("#nav");
364
365
366 $(".scroll-pane").scroll(function(event) {
367 event.preventDefault();
368 return false;
369 });
370
371 /* Resize nav height when window height changes */
372 $(window).resize(function() {
373 if ($('#side-nav').length == 0) return;
374 var stylesheet = $('link[rel="stylesheet"][class="fullscreen"]');
375 setNavBarLeftPos(); // do this even if sidenav isn't fixed because it could become fixed
376 // make sidenav behave when resizing the window and side-scolling is a concern
377 if (navBarIsFixed) {
378 if ((stylesheet.attr("disabled") == "disabled") || stylesheet.length == 0) {
379 updateSideNavPosition();
380 } else {
381 updateSidenavFullscreenWidth();
382 }
383 }
384 resizeNav();
385 });
386
387
388 // Set up fixed navbar
389 var prevScrollLeft = 0; // used to compare current position to previous position of horiz scroll
390 $(window).scroll(function(event) {
391 if ($('#side-nav').length == 0) return;
392 if (event.target.nodeName == "DIV") {
393 // Dump scroll event if the target is a DIV, because that means the event is coming
394 // from a scrollable div and so there's no need to make adjustments to our layout
395 return;
396 }
397 var scrollTop = $(window).scrollTop();
398 var headerHeight = $('#header').outerHeight();
399 var subheaderHeight = $('#nav-x').outerHeight();
400 var searchResultHeight = $('#searchResults').is(":visible") ?
401 $('#searchResults').outerHeight() : 0;
402 var totalHeaderHeight = headerHeight + subheaderHeight + searchResultHeight;
403 // we set the navbar fixed when the scroll position is beyond the height of the site header...
404 var navBarShouldBeFixed = scrollTop > totalHeaderHeight;
405 // ... except if the document content is shorter than the sidenav height.
406 // (this is necessary to avoid crazy behavior on OSX Lion due to overscroll bouncing)
407 if ($("#doc-col").height() < $("#side-nav").height()) {
408 navBarShouldBeFixed = false;
409 }
410
411 var scrollLeft = $(window).scrollLeft();
412 // When the sidenav is fixed and user scrolls horizontally, reposition the sidenav to match
413 if (navBarIsFixed && (scrollLeft != prevScrollLeft)) {
414 updateSideNavPosition();
415 prevScrollLeft = scrollLeft;
416 }
417
418 // Don't continue if the header is sufficently far away
419 // (to avoid intensive resizing that slows scrolling)
420 if (navBarIsFixed && navBarShouldBeFixed) {
421 return;
422 }
423
424 if (navBarIsFixed != navBarShouldBeFixed) {
425 if (navBarShouldBeFixed) {
426 // make it fixed
427 var width = $('#devdoc-nav').width();
428 $('#devdoc-nav')
429 .addClass('fixed')
430 .css({'width':width+'px'})
431 .prependTo('#body-content');
432 // add neato "back to top" button
433 $('#devdoc-nav a.totop').css({'display':'block','width':$("#nav").innerWidth()+'px'});
434
435 // update the sidenaav position for side scrolling
436 updateSideNavPosition();
437 } else {
438 // make it static again
439 $('#devdoc-nav')
440 .removeClass('fixed')
441 .css({'width':'auto','margin':''})
442 .prependTo('#side-nav');
443 $('#devdoc-nav a.totop').hide();
444 }
445 navBarIsFixed = navBarShouldBeFixed;
446 }
447
448 resizeNav(250); // pass true in order to delay the scrollbar re-initialization for performance
449 });
450
451
452 var navBarLeftPos;
453 if ($('#devdoc-nav').length) {
454 setNavBarLeftPos();
455 }
456
457
458 // Set up play-on-hover <video> tags.
459 $('video.play-on-hover').bind('click', function(){
460 $(this).get(0).load(); // in case the video isn't seekable
461 $(this).get(0).play();
462 });
463
464 // Set up tooltips
465 var TOOLTIP_MARGIN = 10;
466 $('acronym,.tooltip-link').each(function() {
467 var $target = $(this);
468 var $tooltip = $('<div>')
469 .addClass('tooltip-box')
470 .append($target.attr('title'))
471 .hide()
472 .appendTo('body');
473 $target.removeAttr('title');
474
475 $target.hover(function() {
476 // in
477 var targetRect = $target.offset();
478 targetRect.width = $target.width();
479 targetRect.height = $target.height();
480
481 $tooltip.css({
482 left: targetRect.left,
483 top: targetRect.top + targetRect.height + TOOLTIP_MARGIN
484 });
485 $tooltip.addClass('below');
486 $tooltip.show();
487 }, function() {
488 // out
489 $tooltip.hide();
490 });
491 });
492
493 // Set up <h2> deeplinks
494 $('h2').click(function() {
495 var id = $(this).attr('id');
496 if (id) {
497 document.location.hash = id;
498 }
499 });
500
501 //Loads the +1 button
502 var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true;
503 po.src = 'https://apis.google.com/js/plusone.js';
504 var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s);
505
506
507 // Revise the sidenav widths to make room for the scrollbar
508 // which avoids the visible width from changing each time the bar appears
509 var $sidenav = $("#side-nav");
510 var sidenav_width = parseInt($sidenav.innerWidth());
511
512 $("#devdoc-nav #nav").css("width", sidenav_width - 4 + "px"); // 4px is scrollbar width
513
514
515 $(".scroll-pane").removeAttr("tabindex"); // get rid of tabindex added by jscroller
516
517 if ($(".scroll-pane").length > 1) {
518 // Check if there's a user preference for the panel heights
519 var cookieHeight = readCookie("reference_height");
520 if (cookieHeight) {
521 restoreHeight(cookieHeight);
522 }
523 }
524
525 resizeNav();
526
527 /* init the language selector based on user cookie for lang */
528 loadLangPref();
529 changeNavLang(getLangPref());
530
531 /* setup event handlers to ensure the overflow menu is visible while picking lang */
532 $("#language select")
533 .mousedown(function() {
534 $("div.morehover").addClass("hover"); })
535 .blur(function() {
536 $("div.morehover").removeClass("hover"); });
537
538 /* some global variable setup */
539 resizePackagesNav = $("#resize-packages-nav");
540 classesNav = $("#classes-nav");
541 devdocNav = $("#devdoc-nav");
542
543 var cookiePath = "";
544 if (location.href.indexOf("/reference/") != -1) {
545 cookiePath = "reference_";
546 } else if (location.href.indexOf("/guide/") != -1) {
547 cookiePath = "guide_";
548 } else if (location.href.indexOf("/tools/") != -1) {
549 cookiePath = "tools_";
550 } else if (location.href.indexOf("/training/") != -1) {
551 cookiePath = "training_";
552 } else if (location.href.indexOf("/design/") != -1) {
553 cookiePath = "design_";
554 } else if (location.href.indexOf("/distribute/") != -1) {
555 cookiePath = "distribute_";
556 }
557
558});
559// END of the onload event
560
561
562function initExpandableNavItems(rootTag) {
563 $(rootTag + ' li.nav-section .nav-section-header').click(function() {
564 var section = $(this).closest('li.nav-section');
565 if (section.hasClass('expanded')) {
566 /* hide me and descendants */
567 section.find('ul').slideUp(250, function() {
568 // remove 'expanded' class from my section and any children
569 section.closest('li').removeClass('expanded');
570 $('li.nav-section', section).removeClass('expanded');
571 resizeNav();
572 });
573 } else {
574 /* show me */
575 // first hide all other siblings
576 var $others = $('li.nav-section.expanded', $(this).closest('ul')).not('.sticky');
577 $others.removeClass('expanded').children('ul').slideUp(250);
578
579 // now expand me
580 section.closest('li').addClass('expanded');
581 section.children('ul').slideDown(250, function() {
582 resizeNav();
583 });
584 }
585 });
586
587 // Stop expand/collapse behavior when clicking on nav section links
588 // (since we're navigating away from the page)
589 // This selector captures the first instance of <a>, but not those with "#" as the href.
590 $('.nav-section-header').find('a:eq(0)').not('a[href="#"]').click(function(evt) {
591 window.location.href = $(this).attr('href');
592 return false;
593 });
594}
595
596/** Highlight the current page in sidenav, expanding children as appropriate */
597function highlightSidenav() {
598 // if something is already highlighted, undo it. This is for dynamic navigation (Samples index)
599 if ($("ul#nav li.selected").length) {
600 unHighlightSidenav();
601 }
602 // look for URL in sidenav, including the hash
603 var $selNavLink = $('#nav').find('a[href="' + mPagePath + location.hash + '"]');
604
605 // If the selNavLink is still empty, look for it without the hash
606 if ($selNavLink.length == 0) {
607 $selNavLink = $('#nav').find('a[href="' + mPagePath + '"]');
608 }
609
610 var $selListItem;
611 if ($selNavLink.length) {
612 // Find this page's <li> in sidenav and set selected
613 $selListItem = $selNavLink.closest('li');
614 $selListItem.addClass('selected');
615
616 // Traverse up the tree and expand all parent nav-sections
617 $selNavLink.parents('li.nav-section').each(function() {
618 $(this).addClass('expanded');
619 $(this).children('ul').show();
620 });
621 }
622}
623
624function unHighlightSidenav() {
625 $("ul#nav li.selected").removeClass("selected");
626 $('ul#nav li.nav-section.expanded').removeClass('expanded').children('ul').hide();
627}
628
629function toggleFullscreen(enable) {
630 var delay = 20;
631 var enabled = true;
632 var stylesheet = $('link[rel="stylesheet"][class="fullscreen"]');
633 if (enable) {
634 // Currently NOT USING fullscreen; enable fullscreen
635 stylesheet.removeAttr('disabled');
636 $('#nav-swap .fullscreen').removeClass('disabled');
637 $('#devdoc-nav').css({left:''});
638 setTimeout(updateSidenavFullscreenWidth,delay); // need to wait a moment for css to switch
639 enabled = true;
640 } else {
641 // Currently USING fullscreen; disable fullscreen
642 stylesheet.attr('disabled', 'disabled');
643 $('#nav-swap .fullscreen').addClass('disabled');
644 setTimeout(updateSidenavFixedWidth,delay); // need to wait a moment for css to switch
645 enabled = false;
646 }
647 writeCookie("fullscreen", enabled, null, null);
648 setNavBarLeftPos();
649 resizeNav(delay);
650 updateSideNavPosition();
651 setTimeout(initSidenavHeightResize,delay);
652}
653
654
655function setNavBarLeftPos() {
656 navBarLeftPos = $('#body-content').offset().left;
657}
658
659
660function updateSideNavPosition() {
661 var newLeft = $(window).scrollLeft() - navBarLeftPos;
662 $('#devdoc-nav').css({left: -newLeft});
663 $('#devdoc-nav .totop').css({left: -(newLeft - parseInt($('#side-nav').css('margin-left')))});
664}
665
666// TODO: use $(document).ready instead
667function addLoadEvent(newfun) {
668 var current = window.onload;
669 if (typeof window.onload != 'function') {
670 window.onload = newfun;
671 } else {
672 window.onload = function() {
673 current();
674 newfun();
675 }
676 }
677}
678
679var agent = navigator['userAgent'].toLowerCase();
680// If a mobile phone, set flag and do mobile setup
681if ((agent.indexOf("mobile") != -1) || // android, iphone, ipod
682 (agent.indexOf("blackberry") != -1) ||
683 (agent.indexOf("webos") != -1) ||
684 (agent.indexOf("mini") != -1)) { // opera mini browsers
685 isMobile = true;
686}
687
688
689$(document).ready(function() {
690 $("pre:not(.no-pretty-print)").addClass("prettyprint");
691 prettyPrint();
692});
693
694
695
696
697/* ######### RESIZE THE SIDENAV HEIGHT ########## */
698
699function resizeNav(delay) {
700 var $nav = $("#devdoc-nav");
701 var $window = $(window);
702 var navHeight;
703
704 // Get the height of entire window and the total header height.
705 // Then figure out based on scroll position whether the header is visible
706 var windowHeight = $window.height();
707 var scrollTop = $window.scrollTop();
708 var headerHeight = $('#header').outerHeight();
709 var subheaderHeight = $('#nav-x').outerHeight();
710 var headerVisible = (scrollTop < (headerHeight + subheaderHeight));
711
712 // get the height of space between nav and top of window.
713 // Could be either margin or top position, depending on whether the nav is fixed.
714 var topMargin = (parseInt($nav.css('margin-top')) || parseInt($nav.css('top'))) + 1;
715 // add 1 for the #side-nav bottom margin
716
717 // Depending on whether the header is visible, set the side nav's height.
718 if (headerVisible) {
719 // The sidenav height grows as the header goes off screen
720 navHeight = windowHeight - (headerHeight + subheaderHeight - scrollTop) - topMargin;
721 } else {
722 // Once header is off screen, the nav height is almost full window height
723 navHeight = windowHeight - topMargin;
724 }
725
726
727
728 $scrollPanes = $(".scroll-pane");
729 if ($scrollPanes.length > 1) {
730 // subtract the height of the api level widget and nav swapper from the available nav height
731 navHeight -= ($('#api-nav-header').outerHeight(true) + $('#nav-swap').outerHeight(true));
732
733 $("#swapper").css({height:navHeight + "px"});
734 if ($("#nav-tree").is(":visible")) {
735 $("#nav-tree").css({height:navHeight});
736 }
737
738 var classesHeight = navHeight - parseInt($("#resize-packages-nav").css("height")) - 10 + "px";
739 //subtract 10px to account for drag bar
740
741 // if the window becomes small enough to make the class panel height 0,
742 // then the package panel should begin to shrink
743 if (parseInt(classesHeight) <= 0) {
744 $("#resize-packages-nav").css({height:navHeight - 10}); //subtract 10px for drag bar
745 $("#packages-nav").css({height:navHeight - 10});
746 }
747
748 $("#classes-nav").css({'height':classesHeight, 'margin-top':'10px'});
749 $("#classes-nav .jspContainer").css({height:classesHeight});
750
751
752 } else {
753 $nav.height(navHeight);
754 }
755
756 if (delay) {
757 updateFromResize = true;
758 delayedReInitScrollbars(delay);
759 } else {
760 reInitScrollbars();
761 }
762
763}
764
765var updateScrollbars = false;
766var updateFromResize = false;
767
768/* Re-initialize the scrollbars to account for changed nav size.
769 * This method postpones the actual update by a 1/4 second in order to optimize the
770 * scroll performance while the header is still visible, because re-initializing the
771 * scroll panes is an intensive process.
772 */
773function delayedReInitScrollbars(delay) {
774 // If we're scheduled for an update, but have received another resize request
775 // before the scheduled resize has occured, just ignore the new request
776 // (and wait for the scheduled one).
777 if (updateScrollbars && updateFromResize) {
778 updateFromResize = false;
779 return;
780 }
781
782 // We're scheduled for an update and the update request came from this method's setTimeout
783 if (updateScrollbars && !updateFromResize) {
784 reInitScrollbars();
785 updateScrollbars = false;
786 } else {
787 updateScrollbars = true;
788 updateFromResize = false;
789 setTimeout('delayedReInitScrollbars()',delay);
790 }
791}
792
793/* Re-initialize the scrollbars to account for changed nav size. */
794function reInitScrollbars() {
795 var pane = $(".scroll-pane").each(function(){
796 var api = $(this).data('jsp');
797 if (!api) { setTimeout(reInitScrollbars,300); return;}
798 api.reinitialise( {verticalGutter:0} );
799 });
800 $(".scroll-pane").removeAttr("tabindex"); // get rid of tabindex added by jscroller
801}
802
803
804/* Resize the height of the nav panels in the reference,
805 * and save the new size to a cookie */
806function saveNavPanels() {
807 var basePath = getBaseUri(location.pathname);
808 var section = basePath.substring(1,basePath.indexOf("/",1));
809 writeCookie("height", resizePackagesNav.css("height"), section, null);
810}
811
812
813
814function restoreHeight(packageHeight) {
815 $("#resize-packages-nav").height(packageHeight);
816 $("#packages-nav").height(packageHeight);
817 // var classesHeight = navHeight - packageHeight;
818 // $("#classes-nav").css({height:classesHeight});
819 // $("#classes-nav .jspContainer").css({height:classesHeight});
820}
821
822
823
824/* ######### END RESIZE THE SIDENAV HEIGHT ########## */
825
826
827
828
829
830/** Scroll the jScrollPane to make the currently selected item visible
831 This is called when the page finished loading. */
832function scrollIntoView(nav) {
833 var $nav = $("#"+nav);
834 var element = $nav.jScrollPane({/* ...settings... */});
835 var api = element.data('jsp');
836
837 if ($nav.is(':visible')) {
838 var $selected = $(".selected", $nav);
839 if ($selected.length == 0) {
840 // If no selected item found, exit
841 return;
842 }
843 // get the selected item's offset from its container nav by measuring the item's offset
844 // relative to the document then subtract the container nav's offset relative to the document
845 var selectedOffset = $selected.offset().top - $nav.offset().top;
846 if (selectedOffset > $nav.height() * .8) { // multiply nav height by .8 so we move up the item
847 // if it's more than 80% down the nav
848 // scroll the item up by an amount equal to 80% the container nav's height
849 api.scrollTo(0, selectedOffset - ($nav.height() * .8), false);
850 }
851 }
852}
853
854
855
856
857
858
859/* Show popup dialogs */
860function showDialog(id) {
861 $dialog = $("#"+id);
862 $dialog.prepend('<div class="box-border"><div class="top"> <div class="left"></div> <div class="right"></div></div><div class="bottom"> <div class="left"></div> <div class="right"></div> </div> </div>');
863 $dialog.wrapInner('<div/>');
864 $dialog.removeClass("hide");
865}
866
867
868
869
870
871/* ######### COOKIES! ########## */
872
873function readCookie(cookie) {
874 var myCookie = cookie_namespace+"_"+cookie+"=";
875 if (document.cookie) {
876 var index = document.cookie.indexOf(myCookie);
877 if (index != -1) {
878 var valStart = index + myCookie.length;
879 var valEnd = document.cookie.indexOf(";", valStart);
880 if (valEnd == -1) {
881 valEnd = document.cookie.length;
882 }
883 var val = document.cookie.substring(valStart, valEnd);
884 return val;
885 }
886 }
887 return 0;
888}
889
890function writeCookie(cookie, val, section, expiration) {
891 if (val==undefined) return;
892 section = section == null ? "_" : "_"+section+"_";
893 if (expiration == null) {
894 var date = new Date();
895 date.setTime(date.getTime()+(10*365*24*60*60*1000)); // default expiration is one week
896 expiration = date.toGMTString();
897 }
898 var cookieValue = cookie_namespace + section + cookie + "=" + val
899 + "; expires=" + expiration+"; path=/";
900 document.cookie = cookieValue;
901}
902
903/* ######### END COOKIES! ########## */
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923/* MISC LIBRARY FUNCTIONS */
924
925
926
927
928
929function toggle(obj, slide) {
930 var ul = $("ul:first", obj);
931 var li = ul.parent();
932 if (li.hasClass("closed")) {
933 if (slide) {
934 ul.slideDown("fast");
935 } else {
936 ul.show();
937 }
938 li.removeClass("closed");
939 li.addClass("open");
940 $(".toggle-img", li).attr("title", "hide pages");
941 } else {
942 ul.slideUp("fast");
943 li.removeClass("open");
944 li.addClass("closed");
945 $(".toggle-img", li).attr("title", "show pages");
946 }
947}
948
949
950function buildToggleLists() {
951 $(".toggle-list").each(
952 function(i) {
953 $("div:first", this).append("<a class='toggle-img' href='#' title='show pages' onClick='toggle(this.parentNode.parentNode, true); return false;'></a>");
954 $(this).addClass("closed");
955 });
956}
957
958
959
960function hideNestedItems(list, toggle) {
961 $list = $(list);
962 // hide nested lists
963 if($list.hasClass('showing')) {
964 $("li ol", $list).hide('fast');
965 $list.removeClass('showing');
966 // show nested lists
967 } else {
968 $("li ol", $list).show('fast');
969 $list.addClass('showing');
970 }
971 $(".more,.less",$(toggle)).toggle();
972}
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001/* REFERENCE NAV SWAP */
1002
1003
1004function getNavPref() {
1005 var v = readCookie('reference_nav');
1006 if (v != NAV_PREF_TREE) {
1007 v = NAV_PREF_PANELS;
1008 }
1009 return v;
1010}
1011
1012function chooseDefaultNav() {
1013 nav_pref = getNavPref();
1014 if (nav_pref == NAV_PREF_TREE) {
1015 $("#nav-panels").toggle();
1016 $("#panel-link").toggle();
1017 $("#nav-tree").toggle();
1018 $("#tree-link").toggle();
1019 }
1020}
1021
1022function swapNav() {
1023 if (nav_pref == NAV_PREF_TREE) {
1024 nav_pref = NAV_PREF_PANELS;
1025 } else {
1026 nav_pref = NAV_PREF_TREE;
1027 init_default_navtree(toRoot);
1028 }
1029 var date = new Date();
1030 date.setTime(date.getTime()+(10*365*24*60*60*1000)); // keep this for 10 years
1031 writeCookie("nav", nav_pref, "reference", date.toGMTString());
1032
1033 $("#nav-panels").toggle();
1034 $("#panel-link").toggle();
1035 $("#nav-tree").toggle();
1036 $("#tree-link").toggle();
1037
1038 resizeNav();
1039
1040 // Gross nasty hack to make tree view show up upon first swap by setting height manually
1041 $("#nav-tree .jspContainer:visible")
1042 .css({'height':$("#nav-tree .jspContainer .jspPane").height() +'px'});
1043 // Another nasty hack to make the scrollbar appear now that we have height
1044 resizeNav();
1045
1046 if ($("#nav-tree").is(':visible')) {
1047 scrollIntoView("nav-tree");
1048 } else {
1049 scrollIntoView("packages-nav");
1050 scrollIntoView("classes-nav");
1051 }
1052}
1053
1054
1055
1056/* ############################################ */
1057/* ########## LOCALIZATION ############ */
1058/* ############################################ */
1059
1060function getBaseUri(uri) {
1061 var intlUrl = (uri.substring(0,6) == "/intl/");
1062 if (intlUrl) {
1063 base = uri.substring(uri.indexOf('intl/')+5,uri.length);
1064 base = base.substring(base.indexOf('/')+1, base.length);
1065 //alert("intl, returning base url: /" + base);
1066 return ("/" + base);
1067 } else {
1068 //alert("not intl, returning uri as found.");
1069 return uri;
1070 }
1071}
1072
1073function requestAppendHL(uri) {
1074//append "?hl=<lang> to an outgoing request (such as to blog)
1075 var lang = getLangPref();
1076 if (lang) {
1077 var q = 'hl=' + lang;
1078 uri += '?' + q;
1079 window.location = uri;
1080 return false;
1081 } else {
1082 return true;
1083 }
1084}
1085
1086
1087function changeNavLang(lang) {
1088 var $links = $("#devdoc-nav,#header,#nav-x,.training-nav-top,.content-footer").find("a["+lang+"-lang]");
1089 $links.each(function(i){ // for each link with a translation
1090 var $link = $(this);
1091 if (lang != "en") { // No need to worry about English, because a language change invokes new request
1092 // put the desired language from the attribute as the text
1093 $link.text($link.attr(lang+"-lang"))
1094 }
1095 });
1096}
1097
1098function changeLangPref(lang, submit) {
1099 var date = new Date();
1100 expires = date.toGMTString(date.setTime(date.getTime()+(10*365*24*60*60*1000)));
1101 // keep this for 50 years
1102 //alert("expires: " + expires)
1103 writeCookie("pref_lang", lang, null, expires);
1104
1105 // ####### TODO: Remove this condition once we're stable on devsite #######
1106 // This condition is only needed if we still need to support legacy GAE server
1107 if (devsite) {
1108 // Switch language when on Devsite server
1109 if (submit) {
1110 $("#setlang").submit();
1111 }
1112 } else {
1113 // Switch language when on legacy GAE server
1114 if (submit) {
1115 window.location = getBaseUri(location.pathname);
1116 }
1117 }
1118}
1119
1120function loadLangPref() {
1121 var lang = readCookie("pref_lang");
1122 if (lang != 0) {
1123 $("#language").find("option[value='"+lang+"']").attr("selected",true);
1124 }
1125}
1126
1127function getLangPref() {
1128 var lang = $("#language").find(":selected").attr("value");
1129 if (!lang) {
1130 lang = readCookie("pref_lang");
1131 }
1132 return (lang != 0) ? lang : 'en';
1133}
1134
1135/* ########## END LOCALIZATION ############ */
1136
1137
1138
1139
1140
1141
1142/* Used to hide and reveal supplemental content, such as long code samples.
1143 See the companion CSS in android-developer-docs.css */
1144function toggleContent(obj) {
1145 var div = $(obj).closest(".toggle-content");
1146 var toggleMe = $(".toggle-content-toggleme:eq(0)",div);
1147 if (div.hasClass("closed")) { // if it's closed, open it
1148 toggleMe.slideDown();
1149 $(".toggle-content-text:eq(0)", obj).toggle();
1150 div.removeClass("closed").addClass("open");
1151 $(".toggle-content-img:eq(0)", div).attr("title", "hide").attr("src", toRoot
1152 + "assets/images/triangle-opened.png");
1153 } else { // if it's open, close it
1154 toggleMe.slideUp('fast', function() { // Wait until the animation is done before closing arrow
1155 $(".toggle-content-text:eq(0)", obj).toggle();
1156 div.removeClass("open").addClass("closed");
1157 div.find(".toggle-content").removeClass("open").addClass("closed")
1158 .find(".toggle-content-toggleme").hide();
1159 $(".toggle-content-img", div).attr("title", "show").attr("src", toRoot
1160 + "assets/images/triangle-closed.png");
1161 });
1162 }
1163 return false;
1164}
1165
1166
1167/* New version of expandable content */
1168function toggleExpandable(link,id) {
1169 if($(id).is(':visible')) {
1170 $(id).slideUp();
1171 $(link).removeClass('expanded');
1172 } else {
1173 $(id).slideDown();
1174 $(link).addClass('expanded');
1175 }
1176}
1177
1178function hideExpandable(ids) {
1179 $(ids).slideUp();
1180 $(ids).prev('h4').find('a.expandable').removeClass('expanded');
1181}
1182
1183
1184
1185
1186
1187/*
1188 * Slideshow 1.0
1189 * Used on /index.html and /develop/index.html for carousel
1190 *
1191 * Sample usage:
1192 * HTML -
1193 * <div class="slideshow-container">
1194 * <a href="" class="slideshow-prev">Prev</a>
1195 * <a href="" class="slideshow-next">Next</a>
1196 * <ul>
1197 * <li class="item"><img src="images/marquee1.jpg"></li>
1198 * <li class="item"><img src="images/marquee2.jpg"></li>
1199 * <li class="item"><img src="images/marquee3.jpg"></li>
1200 * <li class="item"><img src="images/marquee4.jpg"></li>
1201 * </ul>
1202 * </div>
1203 *
1204 * <script type="text/javascript">
1205 * $('.slideshow-container').dacSlideshow({
1206 * auto: true,
1207 * btnPrev: '.slideshow-prev',
1208 * btnNext: '.slideshow-next'
1209 * });
1210 * </script>
1211 *
1212 * Options:
1213 * btnPrev: optional identifier for previous button
1214 * btnNext: optional identifier for next button
1215 * btnPause: optional identifier for pause button
1216 * auto: whether or not to auto-proceed
1217 * speed: animation speed
1218 * autoTime: time between auto-rotation
1219 * easing: easing function for transition
1220 * start: item to select by default
1221 * scroll: direction to scroll in
1222 * pagination: whether or not to include dotted pagination
1223 *
1224 */
1225
1226 (function($) {
1227 $.fn.dacSlideshow = function(o) {
1228
1229 //Options - see above
1230 o = $.extend({
1231 btnPrev: null,
1232 btnNext: null,
1233 btnPause: null,
1234 auto: true,
1235 speed: 500,
1236 autoTime: 12000,
1237 easing: null,
1238 start: 0,
1239 scroll: 1,
1240 pagination: true
1241
1242 }, o || {});
1243
1244 //Set up a carousel for each
1245 return this.each(function() {
1246
1247 var running = false;
1248 var animCss = o.vertical ? "top" : "left";
1249 var sizeCss = o.vertical ? "height" : "width";
1250 var div = $(this);
1251 var ul = $("ul", div);
1252 var tLi = $("li", ul);
1253 var tl = tLi.size();
1254 var timer = null;
1255
1256 var li = $("li", ul);
1257 var itemLength = li.size();
1258 var curr = o.start;
1259
1260 li.css({float: o.vertical ? "none" : "left"});
1261 ul.css({margin: "0", padding: "0", position: "relative", "list-style-type": "none", "z-index": "1"});
1262 div.css({position: "relative", "z-index": "2", left: "0px"});
1263
1264 var liSize = o.vertical ? height(li) : width(li);
1265 var ulSize = liSize * itemLength;
1266 var divSize = liSize;
1267
1268 li.css({width: li.width(), height: li.height()});
1269 ul.css(sizeCss, ulSize+"px").css(animCss, -(curr*liSize));
1270
1271 div.css(sizeCss, divSize+"px");
1272
1273 //Pagination
1274 if (o.pagination) {
1275 var pagination = $("<div class='pagination'></div>");
1276 var pag_ul = $("<ul></ul>");
1277 if (tl > 1) {
1278 for (var i=0;i<tl;i++) {
1279 var li = $("<li>"+i+"</li>");
1280 pag_ul.append(li);
1281 if (i==o.start) li.addClass('active');
1282 li.click(function() {
1283 go(parseInt($(this).text()));
1284 })
1285 }
1286 pagination.append(pag_ul);
1287 div.append(pagination);
1288 }
1289 }
1290
1291 //Previous button
1292 if(o.btnPrev)
1293 $(o.btnPrev).click(function(e) {
1294 e.preventDefault();
1295 return go(curr-o.scroll);
1296 });
1297
1298 //Next button
1299 if(o.btnNext)
1300 $(o.btnNext).click(function(e) {
1301 e.preventDefault();
1302 return go(curr+o.scroll);
1303 });
1304
1305 //Pause button
1306 if(o.btnPause)
1307 $(o.btnPause).click(function(e) {
1308 e.preventDefault();
1309 if ($(this).hasClass('paused')) {
1310 startRotateTimer();
1311 } else {
1312 pauseRotateTimer();
1313 }
1314 });
1315
1316 //Auto rotation
1317 if(o.auto) startRotateTimer();
1318
1319 function startRotateTimer() {
1320 clearInterval(timer);
1321 timer = setInterval(function() {
1322 if (curr == tl-1) {
1323 go(0);
1324 } else {
1325 go(curr+o.scroll);
1326 }
1327 }, o.autoTime);
1328 $(o.btnPause).removeClass('paused');
1329 }
1330
1331 function pauseRotateTimer() {
1332 clearInterval(timer);
1333 $(o.btnPause).addClass('paused');
1334 }
1335
1336 //Go to an item
1337 function go(to) {
1338 if(!running) {
1339
1340 if(to<0) {
1341 to = itemLength-1;
1342 } else if (to>itemLength-1) {
1343 to = 0;
1344 }
1345 curr = to;
1346
1347 running = true;
1348
1349 ul.animate(
1350 animCss == "left" ? { left: -(curr*liSize) } : { top: -(curr*liSize) } , o.speed, o.easing,
1351 function() {
1352 running = false;
1353 }
1354 );
1355
1356 $(o.btnPrev + "," + o.btnNext).removeClass("disabled");
1357 $( (curr-o.scroll<0 && o.btnPrev)
1358 ||
1359 (curr+o.scroll > itemLength && o.btnNext)
1360 ||
1361 []
1362 ).addClass("disabled");
1363
1364
1365 var nav_items = $('li', pagination);
1366 nav_items.removeClass('active');
1367 nav_items.eq(to).addClass('active');
1368
1369
1370 }
1371 if(o.auto) startRotateTimer();
1372 return false;
1373 };
1374 });
1375 };
1376
1377 function css(el, prop) {
1378 return parseInt($.css(el[0], prop)) || 0;
1379 };
1380 function width(el) {
1381 return el[0].offsetWidth + css(el, 'marginLeft') + css(el, 'marginRight');
1382 };
1383 function height(el) {
1384 return el[0].offsetHeight + css(el, 'marginTop') + css(el, 'marginBottom');
1385 };
1386
1387 })(jQuery);
1388
1389
1390/*
1391 * dacSlideshow 1.0
1392 * Used on develop/index.html for side-sliding tabs
1393 *
1394 * Sample usage:
1395 * HTML -
1396 * <div class="slideshow-container">
1397 * <a href="" class="slideshow-prev">Prev</a>
1398 * <a href="" class="slideshow-next">Next</a>
1399 * <ul>
1400 * <li class="item"><img src="images/marquee1.jpg"></li>
1401 * <li class="item"><img src="images/marquee2.jpg"></li>
1402 * <li class="item"><img src="images/marquee3.jpg"></li>
1403 * <li class="item"><img src="images/marquee4.jpg"></li>
1404 * </ul>
1405 * </div>
1406 *
1407 * <script type="text/javascript">
1408 * $('.slideshow-container').dacSlideshow({
1409 * auto: true,
1410 * btnPrev: '.slideshow-prev',
1411 * btnNext: '.slideshow-next'
1412 * });
1413 * </script>
1414 *
1415 * Options:
1416 * btnPrev: optional identifier for previous button
1417 * btnNext: optional identifier for next button
1418 * auto: whether or not to auto-proceed
1419 * speed: animation speed
1420 * autoTime: time between auto-rotation
1421 * easing: easing function for transition
1422 * start: item to select by default
1423 * scroll: direction to scroll in
1424 * pagination: whether or not to include dotted pagination
1425 *
1426 */
1427 (function($) {
1428 $.fn.dacTabbedList = function(o) {
1429
1430 //Options - see above
1431 o = $.extend({
1432 speed : 250,
1433 easing: null,
1434 nav_id: null,
1435 frame_id: null
1436 }, o || {});
1437
1438 //Set up a carousel for each
1439 return this.each(function() {
1440
1441 var curr = 0;
1442 var running = false;
1443 var animCss = "margin-left";
1444 var sizeCss = "width";
1445 var div = $(this);
1446
1447 var nav = $(o.nav_id, div);
1448 var nav_li = $("li", nav);
1449 var nav_size = nav_li.size();
1450 var frame = div.find(o.frame_id);
1451 var content_width = $(frame).find('ul').width();
1452 //Buttons
1453 $(nav_li).click(function(e) {
1454 go($(nav_li).index($(this)));
1455 })
1456
1457 //Go to an item
1458 function go(to) {
1459 if(!running) {
1460 curr = to;
1461 running = true;
1462
1463 frame.animate({ 'margin-left' : -(curr*content_width) }, o.speed, o.easing,
1464 function() {
1465 running = false;
1466 }
1467 );
1468
1469
1470 nav_li.removeClass('active');
1471 nav_li.eq(to).addClass('active');
1472
1473
1474 }
1475 return false;
1476 };
1477 });
1478 };
1479
1480 function css(el, prop) {
1481 return parseInt($.css(el[0], prop)) || 0;
1482 };
1483 function width(el) {
1484 return el[0].offsetWidth + css(el, 'marginLeft') + css(el, 'marginRight');
1485 };
1486 function height(el) {
1487 return el[0].offsetHeight + css(el, 'marginTop') + css(el, 'marginBottom');
1488 };
1489
1490 })(jQuery);
1491
1492
1493
1494
1495
1496/* ######################################################## */
1497/* ################ SEARCH SUGGESTIONS ################## */
1498/* ######################################################## */
1499
1500
1501
1502var gSelectedIndex = -1; // the index position of currently highlighted suggestion
1503var gSelectedColumn = -1; // which column of suggestion lists is currently focused
1504
1505var gMatches = new Array();
1506var gLastText = "";
1507var gInitialized = false;
1508var ROW_COUNT_FRAMEWORK = 20; // max number of results in list
1509var gListLength = 0;
1510
1511
1512var gGoogleMatches = new Array();
1513var ROW_COUNT_GOOGLE = 15; // max number of results in list
1514var gGoogleListLength = 0;
1515
1516var gDocsMatches = new Array();
1517var ROW_COUNT_DOCS = 100; // max number of results in list
1518var gDocsListLength = 0;
1519
1520function onSuggestionClick(link) {
1521 // When user clicks a suggested document, track it
1522 _gaq.push(['_trackEvent', 'Suggestion Click', 'clicked: ' + $(link).text(),
1523 'from: ' + $("#search_autocomplete").val()]);
1524}
1525
1526function set_item_selected($li, selected)
1527{
1528 if (selected) {
1529 $li.attr('class','jd-autocomplete jd-selected');
1530 } else {
1531 $li.attr('class','jd-autocomplete');
1532 }
1533}
1534
1535function set_item_values(toroot, $li, match)
1536{
1537 var $link = $('a',$li);
1538 $link.html(match.__hilabel || match.label);
1539 $link.attr('href',toroot + match.link);
1540}
1541
1542function set_item_values_jd(toroot, $li, match)
1543{
1544 var $link = $('a',$li);
1545 $link.html(match.title);
1546 $link.attr('href',toroot + match.url);
1547}
1548
1549function new_suggestion($list) {
1550 var $li = $("<li class='jd-autocomplete'></li>");
1551 $list.append($li);
1552
1553 $li.mousedown(function() {
1554 window.location = this.firstChild.getAttribute("href");
1555 });
1556 $li.mouseover(function() {
1557 $('.search_filtered_wrapper li').removeClass('jd-selected');
1558 $(this).addClass('jd-selected');
1559 gSelectedColumn = $(".search_filtered:visible").index($(this).closest('.search_filtered'));
1560 gSelectedIndex = $("li", $(".search_filtered:visible")[gSelectedColumn]).index(this);
1561 });
1562 $li.append("<a onclick='onSuggestionClick(this)'></a>");
1563 $li.attr('class','show-item');
1564 return $li;
1565}
1566
1567function sync_selection_table(toroot)
1568{
1569 var $li; //list item jquery object
1570 var i; //list item iterator
1571
1572 // if there are NO results at all, hide all columns
1573 if (!(gMatches.length > 0) && !(gGoogleMatches.length > 0) && !(gDocsMatches.length > 0)) {
1574 $('.suggest-card').hide(300);
1575 return;
1576 }
1577
1578 // if there are api results
1579 if ((gMatches.length > 0) || (gGoogleMatches.length > 0)) {
1580 // reveal suggestion list
1581 $('.suggest-card.dummy').show();
1582 $('.suggest-card.reference').show();
1583 var listIndex = 0; // list index position
1584
1585 // reset the lists
1586 $(".search_filtered_wrapper.reference li").remove();
1587
1588 // ########### ANDROID RESULTS #############
1589 if (gMatches.length > 0) {
1590
1591 // determine android results to show
1592 gListLength = gMatches.length < ROW_COUNT_FRAMEWORK ?
1593 gMatches.length : ROW_COUNT_FRAMEWORK;
1594 for (i=0; i<gListLength; i++) {
1595 var $li = new_suggestion($(".suggest-card.reference ul"));
1596 set_item_values(toroot, $li, gMatches[i]);
1597 set_item_selected($li, i == gSelectedIndex);
1598 }
1599 }
1600
1601 // ########### GOOGLE RESULTS #############
1602 if (gGoogleMatches.length > 0) {
1603 // show header for list
1604 $(".suggest-card.reference ul").append("<li class='header'>in Google Services:</li>");
1605
1606 // determine google results to show
1607 gGoogleListLength = gGoogleMatches.length < ROW_COUNT_GOOGLE ? gGoogleMatches.length : ROW_COUNT_GOOGLE;
1608 for (i=0; i<gGoogleListLength; i++) {
1609 var $li = new_suggestion($(".suggest-card.reference ul"));
1610 set_item_values(toroot, $li, gGoogleMatches[i]);
1611 set_item_selected($li, i == gSelectedIndex);
1612 }
1613 }
1614 } else {
1615 $('.suggest-card.reference').hide();
1616 $('.suggest-card.dummy').hide();
1617 }
1618
1619 // ########### JD DOC RESULTS #############
1620 if (gDocsMatches.length > 0) {
1621 // reset the lists
1622 $(".search_filtered_wrapper.docs li").remove();
1623
1624 // determine google results to show
1625 // NOTE: The order of the conditions below for the sugg.type MUST BE SPECIFIC:
1626 // The order must match the reverse order that each section appears as a card in
1627 // the suggestion UI... this may be only for the "develop" grouped items though.
1628 gDocsListLength = gDocsMatches.length < ROW_COUNT_DOCS ? gDocsMatches.length : ROW_COUNT_DOCS;
1629 for (i=0; i<gDocsListLength; i++) {
1630 var sugg = gDocsMatches[i];
1631 var $li;
1632 if (sugg.type == "design") {
1633 $li = new_suggestion($(".suggest-card.design ul"));
1634 } else
1635 if (sugg.type == "distribute") {
1636 $li = new_suggestion($(".suggest-card.distribute ul"));
1637 } else
1638 if (sugg.type == "samples") {
1639 $li = new_suggestion($(".suggest-card.develop .child-card.samples"));
1640 } else
1641 if (sugg.type == "training") {
1642 $li = new_suggestion($(".suggest-card.develop .child-card.training"));
1643 } else
1644 if (sugg.type == "about"||"guide"||"tools"||"google") {
1645 $li = new_suggestion($(".suggest-card.develop .child-card.guides"));
1646 } else {
1647 continue;
1648 }
1649
1650 set_item_values_jd(toroot, $li, sugg);
1651 set_item_selected($li, i == gSelectedIndex);
1652 }
1653
1654 // add heading and show or hide card
1655 if ($(".suggest-card.design li").length > 0) {
1656 $(".suggest-card.design ul").prepend("<li class='header'>Design:</li>");
1657 $(".suggest-card.design").show(300);
1658 } else {
1659 $('.suggest-card.design').hide(300);
1660 }
1661 if ($(".suggest-card.distribute li").length > 0) {
1662 $(".suggest-card.distribute ul").prepend("<li class='header'>Distribute:</li>");
1663 $(".suggest-card.distribute").show(300);
1664 } else {
1665 $('.suggest-card.distribute').hide(300);
1666 }
1667 if ($(".child-card.guides li").length > 0) {
1668 $(".child-card.guides").prepend("<li class='header'>Guides:</li>");
1669 $(".child-card.guides li").appendTo(".suggest-card.develop ul");
1670 }
1671 if ($(".child-card.training li").length > 0) {
1672 $(".child-card.training").prepend("<li class='header'>Training:</li>");
1673 $(".child-card.training li").appendTo(".suggest-card.develop ul");
1674 }
1675 if ($(".child-card.samples li").length > 0) {
1676 $(".child-card.samples").prepend("<li class='header'>Samples:</li>");
1677 $(".child-card.samples li").appendTo(".suggest-card.develop ul");
1678 }
1679
1680 if ($(".suggest-card.develop li").length > 0) {
1681 $(".suggest-card.develop").show(300);
1682 } else {
1683 $('.suggest-card.develop').hide(300);
1684 }
1685
1686 } else {
1687 $('.search_filtered_wrapper.docs .suggest-card:not(.dummy)').hide(300);
1688 }
1689}
1690
1691/** Called by the search input's onkeydown and onkeyup events.
1692 * Handles navigation with keyboard arrows, Enter key to invoke search,
1693 * otherwise invokes search suggestions on key-up event.
1694 * @param e The JS event
1695 * @param kd True if the event is key-down
1696 * @param toroot A string for the site's root path
1697 * @returns True if the event should bubble up
1698 */
1699function search_changed(e, kd, toroot)
1700{
1701 var currentLang = getLangPref();
1702 var search = document.getElementById("search_autocomplete");
1703 var text = search.value.replace(/(^ +)|( +$)/g, '');
1704 // get the ul hosting the currently selected item
1705 gSelectedColumn = gSelectedColumn >= 0 ? gSelectedColumn : 0;
1706 var $columns = $(".search_filtered_wrapper").find(".search_filtered:visible");
1707 var $selectedUl = $columns[gSelectedColumn];
1708
1709 // show/hide the close button
1710 if (text != '') {
1711 $(".search .close").removeClass("hide");
1712 } else {
1713 $(".search .close").addClass("hide");
1714 }
1715 // 27 = esc
1716 if (e.keyCode == 27) {
1717 // close all search results
1718 if (kd) $('.search .close').trigger('click');
1719 return true;
1720 }
1721 // 13 = enter
1722 else if (e.keyCode == 13) {
1723 if (gSelectedIndex < 0) {
1724 $('.suggest-card').hide();
1725 if ($("#searchResults").is(":hidden") && (search.value != "")) {
1726 // if results aren't showing (and text not empty), return true to allow search to execute
1727 return true;
1728 } else {
1729 // otherwise, results are already showing, so allow ajax to auto refresh the results
1730 // and ignore this Enter press to avoid the reload.
1731 return false;
1732 }
1733 } else if (kd && gSelectedIndex >= 0) {
1734 // click the link corresponding to selected item
1735 $("a",$("li",$selectedUl)[gSelectedIndex]).get()[0].click();
1736 return false;
1737 }
1738 }
1739 // Stop here if Google results are showing
1740 else if ($("#searchResults").is(":visible")) {
1741 return true;
1742 }
1743 // 38 UP ARROW
1744 else if (kd && (e.keyCode == 38)) {
1745 // if the next item is a header, skip it
1746 if ($($("li", $selectedUl)[gSelectedIndex-1]).hasClass("header")) {
1747 gSelectedIndex--;
1748 }
1749 if (gSelectedIndex >= 0) {
1750 $('li', $selectedUl).removeClass('jd-selected');
1751 gSelectedIndex--;
1752 $('li:nth-child('+(gSelectedIndex+1)+')', $selectedUl).addClass('jd-selected');
1753 // If user reaches top, reset selected column
1754 if (gSelectedIndex < 0) {
1755 gSelectedColumn = -1;
1756 }
1757 }
1758 return false;
1759 }
1760 // 40 DOWN ARROW
1761 else if (kd && (e.keyCode == 40)) {
1762 // if the next item is a header, skip it
1763 if ($($("li", $selectedUl)[gSelectedIndex+1]).hasClass("header")) {
1764 gSelectedIndex++;
1765 }
1766 if ((gSelectedIndex < $("li", $selectedUl).length-1) ||
1767 ($($("li", $selectedUl)[gSelectedIndex+1]).hasClass("header"))) {
1768 $('li', $selectedUl).removeClass('jd-selected');
1769 gSelectedIndex++;
1770 $('li:nth-child('+(gSelectedIndex+1)+')', $selectedUl).addClass('jd-selected');
1771 }
1772 return false;
1773 }
1774 // Consider left/right arrow navigation
1775 // NOTE: Order of suggest columns are reverse order (index position 0 is on right)
1776 else if (kd && $columns.length > 1 && gSelectedColumn >= 0) {
1777 // 37 LEFT ARROW
1778 // go left only if current column is not left-most column (last column)
1779 if (e.keyCode == 37 && gSelectedColumn < $columns.length - 1) {
1780 $('li', $selectedUl).removeClass('jd-selected');
1781 gSelectedColumn++;
1782 $selectedUl = $columns[gSelectedColumn];
1783 // keep or reset the selected item to last item as appropriate
1784 gSelectedIndex = gSelectedIndex >
1785 $("li", $selectedUl).length-1 ?
1786 $("li", $selectedUl).length-1 : gSelectedIndex;
1787 // if the corresponding item is a header, move down
1788 if ($($("li", $selectedUl)[gSelectedIndex]).hasClass("header")) {
1789 gSelectedIndex++;
1790 }
1791 // set item selected
1792 $('li:nth-child('+(gSelectedIndex+1)+')', $selectedUl).addClass('jd-selected');
1793 return false;
1794 }
1795 // 39 RIGHT ARROW
1796 // go right only if current column is not the right-most column (first column)
1797 else if (e.keyCode == 39 && gSelectedColumn > 0) {
1798 $('li', $selectedUl).removeClass('jd-selected');
1799 gSelectedColumn--;
1800 $selectedUl = $columns[gSelectedColumn];
1801 // keep or reset the selected item to last item as appropriate
1802 gSelectedIndex = gSelectedIndex >
1803 $("li", $selectedUl).length-1 ?
1804 $("li", $selectedUl).length-1 : gSelectedIndex;
1805 // if the corresponding item is a header, move down
1806 if ($($("li", $selectedUl)[gSelectedIndex]).hasClass("header")) {
1807 gSelectedIndex++;
1808 }
1809 // set item selected
1810 $('li:nth-child('+(gSelectedIndex+1)+')', $selectedUl).addClass('jd-selected');
1811 return false;
1812 }
1813 }
1814
1815 // if key-up event and not arrow down/up/left/right,
1816 // read the search query and add suggestions to gMatches
1817 else if (!kd && (e.keyCode != 40)
1818 && (e.keyCode != 38)
1819 && (e.keyCode != 37)
1820 && (e.keyCode != 39)) {
1821 gSelectedIndex = -1;
1822 gMatches = new Array();
1823 matchedCount = 0;
1824 gGoogleMatches = new Array();
1825 matchedCountGoogle = 0;
1826 gDocsMatches = new Array();
1827 matchedCountDocs = 0;
1828
1829 // Search for Android matches
1830 for (var i=0; i<DATA.length; i++) {
1831 var s = DATA[i];
1832 if (text.length != 0 &&
1833 s.label.toLowerCase().indexOf(text.toLowerCase()) != -1) {
1834 gMatches[matchedCount] = s;
1835 matchedCount++;
1836 }
1837 }
1838 rank_autocomplete_api_results(text, gMatches);
1839 for (var i=0; i<gMatches.length; i++) {
1840 var s = gMatches[i];
1841 }
1842
1843
1844 // Search for Google matches
1845 for (var i=0; i<GOOGLE_DATA.length; i++) {
1846 var s = GOOGLE_DATA[i];
1847 if (text.length != 0 &&
1848 s.label.toLowerCase().indexOf(text.toLowerCase()) != -1) {
1849 gGoogleMatches[matchedCountGoogle] = s;
1850 matchedCountGoogle++;
1851 }
1852 }
1853 rank_autocomplete_api_results(text, gGoogleMatches);
1854 for (var i=0; i<gGoogleMatches.length; i++) {
1855 var s = gGoogleMatches[i];
1856 }
1857
1858 highlight_autocomplete_result_labels(text);
1859
1860
1861
1862 // Search for matching JD docs
1863 if (text.length >= 3) {
1864 // Regex to match only the beginning of a word
1865 var textRegex = new RegExp("\\b" + text.toLowerCase(), "g");
1866
1867
1868 // Search for Training classes
1869 for (var i=0; i<TRAINING_RESOURCES.length; i++) {
1870 // current search comparison, with counters for tag and title,
1871 // used later to improve ranking
1872 var s = TRAINING_RESOURCES[i];
1873 s.matched_tag = 0;
1874 s.matched_title = 0;
1875 var matched = false;
1876
1877 // Check if query matches any tags; work backwards toward 1 to assist ranking
1878 for (var j = s.keywords.length - 1; j >= 0; j--) {
1879 // it matches a tag
1880 if (s.keywords[j].toLowerCase().match(textRegex)) {
1881 matched = true;
1882 s.matched_tag = j + 1; // add 1 to index position
1883 }
1884 }
1885 // Don't consider doc title for lessons (only for class landing pages),
1886 // unless the lesson has a tag that already matches
1887 if ((s.lang == currentLang) &&
1888 (!(s.type == "training" && s.url.indexOf("index.html") == -1) || matched)) {
1889 // it matches the doc title
1890 if (s.title.toLowerCase().match(textRegex)) {
1891 matched = true;
1892 s.matched_title = 1;
1893 }
1894 }
1895 if (matched) {
1896 gDocsMatches[matchedCountDocs] = s;
1897 matchedCountDocs++;
1898 }
1899 }
1900
1901
1902 // Search for API Guides
1903 for (var i=0; i<GUIDE_RESOURCES.length; i++) {
1904 // current search comparison, with counters for tag and title,
1905 // used later to improve ranking
1906 var s = GUIDE_RESOURCES[i];
1907 s.matched_tag = 0;
1908 s.matched_title = 0;
1909 var matched = false;
1910
1911 // Check if query matches any tags; work backwards toward 1 to assist ranking
1912 for (var j = s.keywords.length - 1; j >= 0; j--) {
1913 // it matches a tag
1914 if (s.keywords[j].toLowerCase().match(textRegex)) {
1915 matched = true;
1916 s.matched_tag = j + 1; // add 1 to index position
1917 }
1918 }
1919 // Check if query matches the doc title, but only for current language
1920 if (s.lang == currentLang) {
1921 // if query matches the doc title
1922 if (s.title.toLowerCase().match(textRegex)) {
1923 matched = true;
1924 s.matched_title = 1;
1925 }
1926 }
1927 if (matched) {
1928 gDocsMatches[matchedCountDocs] = s;
1929 matchedCountDocs++;
1930 }
1931 }
1932
1933
1934 // Search for Tools Guides
1935 for (var i=0; i<TOOLS_RESOURCES.length; i++) {
1936 // current search comparison, with counters for tag and title,
1937 // used later to improve ranking
1938 var s = TOOLS_RESOURCES[i];
1939 s.matched_tag = 0;
1940 s.matched_title = 0;
1941 var matched = false;
1942
1943 // Check if query matches any tags; work backwards toward 1 to assist ranking
1944 for (var j = s.keywords.length - 1; j >= 0; j--) {
1945 // it matches a tag
1946 if (s.keywords[j].toLowerCase().match(textRegex)) {
1947 matched = true;
1948 s.matched_tag = j + 1; // add 1 to index position
1949 }
1950 }
1951 // Check if query matches the doc title, but only for current language
1952 if (s.lang == currentLang) {
1953 // if query matches the doc title
1954 if (s.title.toLowerCase().match(textRegex)) {
1955 matched = true;
1956 s.matched_title = 1;
1957 }
1958 }
1959 if (matched) {
1960 gDocsMatches[matchedCountDocs] = s;
1961 matchedCountDocs++;
1962 }
1963 }
1964
1965
1966 // Search for About docs
1967 for (var i=0; i<ABOUT_RESOURCES.length; i++) {
1968 // current search comparison, with counters for tag and title,
1969 // used later to improve ranking
1970 var s = ABOUT_RESOURCES[i];
1971 s.matched_tag = 0;
1972 s.matched_title = 0;
1973 var matched = false;
1974
1975 // Check if query matches any tags; work backwards toward 1 to assist ranking
1976 for (var j = s.keywords.length - 1; j >= 0; j--) {
1977 // it matches a tag
1978 if (s.keywords[j].toLowerCase().match(textRegex)) {
1979 matched = true;
1980 s.matched_tag = j + 1; // add 1 to index position
1981 }
1982 }
1983 // Check if query matches the doc title, but only for current language
1984 if (s.lang == currentLang) {
1985 // if query matches the doc title
1986 if (s.title.toLowerCase().match(textRegex)) {
1987 matched = true;
1988 s.matched_title = 1;
1989 }
1990 }
1991 if (matched) {
1992 gDocsMatches[matchedCountDocs] = s;
1993 matchedCountDocs++;
1994 }
1995 }
1996
1997
1998 // Search for Design guides
1999 for (var i=0; i<DESIGN_RESOURCES.length; i++) {
2000 // current search comparison, with counters for tag and title,
2001 // used later to improve ranking
2002 var s = DESIGN_RESOURCES[i];
2003 s.matched_tag = 0;
2004 s.matched_title = 0;
2005 var matched = false;
2006
2007 // Check if query matches any tags; work backwards toward 1 to assist ranking
2008 for (var j = s.keywords.length - 1; j >= 0; j--) {
2009 // it matches a tag
2010 if (s.keywords[j].toLowerCase().match(textRegex)) {
2011 matched = true;
2012 s.matched_tag = j + 1; // add 1 to index position
2013 }
2014 }
2015 // Check if query matches the doc title, but only for current language
2016 if (s.lang == currentLang) {
2017 // if query matches the doc title
2018 if (s.title.toLowerCase().match(textRegex)) {
2019 matched = true;
2020 s.matched_title = 1;
2021 }
2022 }
2023 if (matched) {
2024 gDocsMatches[matchedCountDocs] = s;
2025 matchedCountDocs++;
2026 }
2027 }
2028
2029
2030 // Search for Distribute guides
2031 for (var i=0; i<DISTRIBUTE_RESOURCES.length; i++) {
2032 // current search comparison, with counters for tag and title,
2033 // used later to improve ranking
2034 var s = DISTRIBUTE_RESOURCES[i];
2035 s.matched_tag = 0;
2036 s.matched_title = 0;
2037 var matched = false;
2038
2039 // Check if query matches any tags; work backwards toward 1 to assist ranking
2040 for (var j = s.keywords.length - 1; j >= 0; j--) {
2041 // it matches a tag
2042 if (s.keywords[j].toLowerCase().match(textRegex)) {
2043 matched = true;
2044 s.matched_tag = j + 1; // add 1 to index position
2045 }
2046 }
2047 // Check if query matches the doc title, but only for current language
2048 if (s.lang == currentLang) {
2049 // if query matches the doc title
2050 if (s.title.toLowerCase().match(textRegex)) {
2051 matched = true;
2052 s.matched_title = 1;
2053 }
2054 }
2055 if (matched) {
2056 gDocsMatches[matchedCountDocs] = s;
2057 matchedCountDocs++;
2058 }
2059 }
2060
2061
2062 // Search for Google guides
2063 for (var i=0; i<GOOGLE_RESOURCES.length; i++) {
2064 // current search comparison, with counters for tag and title,
2065 // used later to improve ranking
2066 var s = GOOGLE_RESOURCES[i];
2067 s.matched_tag = 0;
2068 s.matched_title = 0;
2069 var matched = false;
2070
2071 // Check if query matches any tags; work backwards toward 1 to assist ranking
2072 for (var j = s.keywords.length - 1; j >= 0; j--) {
2073 // it matches a tag
2074 if (s.keywords[j].toLowerCase().match(textRegex)) {
2075 matched = true;
2076 s.matched_tag = j + 1; // add 1 to index position
2077 }
2078 }
2079 // Check if query matches the doc title, but only for current language
2080 if (s.lang == currentLang) {
2081 // if query matches the doc title
2082 if (s.title.toLowerCase().match(textRegex)) {
2083 matched = true;
2084 s.matched_title = 1;
2085 }
2086 }
2087 if (matched) {
2088 gDocsMatches[matchedCountDocs] = s;
2089 matchedCountDocs++;
2090 }
2091 }
2092
2093
2094 // Search for Samples
2095 for (var i=0; i<SAMPLES_RESOURCES.length; i++) {
2096 // current search comparison, with counters for tag and title,
2097 // used later to improve ranking
2098 var s = SAMPLES_RESOURCES[i];
2099 s.matched_tag = 0;
2100 s.matched_title = 0;
2101 var matched = false;
2102 // Check if query matches any tags; work backwards toward 1 to assist ranking
2103 for (var j = s.keywords.length - 1; j >= 0; j--) {
2104 // it matches a tag
2105 if (s.keywords[j].toLowerCase().match(textRegex)) {
2106 matched = true;
2107 s.matched_tag = j + 1; // add 1 to index position
2108 }
2109 }
2110 // Check if query matches the doc title, but only for current language
2111 if (s.lang == currentLang) {
2112 // if query matches the doc title.t
2113 if (s.title.toLowerCase().match(textRegex)) {
2114 matched = true;
2115 s.matched_title = 1;
2116 }
2117 }
2118 if (matched) {
2119 gDocsMatches[matchedCountDocs] = s;
2120 matchedCountDocs++;
2121 }
2122 }
2123
2124 // Rank/sort all the matched pages
2125 rank_autocomplete_doc_results(text, gDocsMatches);
2126 }
2127
2128 // draw the suggestions
2129 sync_selection_table(toroot);
2130 return true; // allow the event to bubble up to the search api
2131 }
2132}
2133
2134/* Order the jd doc result list based on match quality */
2135function rank_autocomplete_doc_results(query, matches) {
2136 query = query || '';
2137 if (!matches || !matches.length)
2138 return;
2139
2140 var _resultScoreFn = function(match) {
2141 var score = 1.0;
2142
2143 // if the query matched a tag
2144 if (match.matched_tag > 0) {
2145 // multiply score by factor relative to position in tags list (max of 3)
2146 score *= 3 / match.matched_tag;
2147
2148 // if it also matched the title
2149 if (match.matched_title > 0) {
2150 score *= 2;
2151 }
2152 } else if (match.matched_title > 0) {
2153 score *= 3;
2154 }
2155
2156 return score;
2157 };
2158
2159 for (var i=0; i<matches.length; i++) {
2160 matches[i].__resultScore = _resultScoreFn(matches[i]);
2161 }
2162
2163 matches.sort(function(a,b){
2164 var n = b.__resultScore - a.__resultScore;
2165 if (n == 0) // lexicographical sort if scores are the same
2166 n = (a.label < b.label) ? -1 : 1;
2167 return n;
2168 });
2169}
2170
2171/* Order the result list based on match quality */
2172function rank_autocomplete_api_results(query, matches) {
2173 query = query || '';
2174 if (!matches || !matches.length)
2175 return;
2176
2177 // helper function that gets the last occurence index of the given regex
2178 // in the given string, or -1 if not found
2179 var _lastSearch = function(s, re) {
2180 if (s == '')
2181 return -1;
2182 var l = -1;
2183 var tmp;
2184 while ((tmp = s.search(re)) >= 0) {
2185 if (l < 0) l = 0;
2186 l += tmp;
2187 s = s.substr(tmp + 1);
2188 }
2189 return l;
2190 };
2191
2192 // helper function that counts the occurrences of a given character in
2193 // a given string
2194 var _countChar = function(s, c) {
2195 var n = 0;
2196 for (var i=0; i<s.length; i++)
2197 if (s.charAt(i) == c) ++n;
2198 return n;
2199 };
2200
2201 var queryLower = query.toLowerCase();
2202 var queryAlnum = (queryLower.match(/\w+/) || [''])[0];
2203 var partPrefixAlnumRE = new RegExp('\\b' + queryAlnum);
2204 var partExactAlnumRE = new RegExp('\\b' + queryAlnum + '\\b');
2205
2206 var _resultScoreFn = function(result) {
2207 // scores are calculated based on exact and prefix matches,
2208 // and then number of path separators (dots) from the last
2209 // match (i.e. favoring classes and deep package names)
2210 var score = 1.0;
2211 var labelLower = result.label.toLowerCase();
2212 var t;
2213 t = _lastSearch(labelLower, partExactAlnumRE);
2214 if (t >= 0) {
2215 // exact part match
2216 var partsAfter = _countChar(labelLower.substr(t + 1), '.');
2217 score *= 200 / (partsAfter + 1);
2218 } else {
2219 t = _lastSearch(labelLower, partPrefixAlnumRE);
2220 if (t >= 0) {
2221 // part prefix match
2222 var partsAfter = _countChar(labelLower.substr(t + 1), '.');
2223 score *= 20 / (partsAfter + 1);
2224 }
2225 }
2226
2227 return score;
2228 };
2229
2230 for (var i=0; i<matches.length; i++) {
2231 // if the API is deprecated, default score is 0; otherwise, perform scoring
2232 if (matches[i].deprecated == "true") {
2233 matches[i].__resultScore = 0;
2234 } else {
2235 matches[i].__resultScore = _resultScoreFn(matches[i]);
2236 }
2237 }
2238
2239 matches.sort(function(a,b){
2240 var n = b.__resultScore - a.__resultScore;
2241 if (n == 0) // lexicographical sort if scores are the same
2242 n = (a.label < b.label) ? -1 : 1;
2243 return n;
2244 });
2245}
2246
2247/* Add emphasis to part of string that matches query */
2248function highlight_autocomplete_result_labels(query) {
2249 query = query || '';
2250 if ((!gMatches || !gMatches.length) && (!gGoogleMatches || !gGoogleMatches.length))
2251 return;
2252
2253 var queryLower = query.toLowerCase();
2254 var queryAlnumDot = (queryLower.match(/[\w\.]+/) || [''])[0];
2255 var queryRE = new RegExp(
2256 '(' + queryAlnumDot.replace(/\./g, '\\.') + ')', 'ig');
2257 for (var i=0; i<gMatches.length; i++) {
2258 gMatches[i].__hilabel = gMatches[i].label.replace(
2259 queryRE, '<b>$1</b>');
2260 }
2261 for (var i=0; i<gGoogleMatches.length; i++) {
2262 gGoogleMatches[i].__hilabel = gGoogleMatches[i].label.replace(
2263 queryRE, '<b>$1</b>');
2264 }
2265}
2266
2267function search_focus_changed(obj, focused)
2268{
2269 if (!focused) {
2270 if(obj.value == ""){
2271 $(".search .close").addClass("hide");
2272 }
2273 $(".suggest-card").hide();
2274 }
2275}
2276
2277function submit_search() {
2278 var query = document.getElementById('search_autocomplete').value;
2279 location.hash = 'q=' + query;
2280 loadSearchResults();
2281 $("#searchResults").slideDown('slow');
2282 return false;
2283}
2284
2285
2286function hideResults() {
2287 $("#searchResults").slideUp();
2288 $(".search .close").addClass("hide");
2289 location.hash = '';
2290
2291 $("#search_autocomplete").val("").blur();
2292
2293 // reset the ajax search callback to nothing, so results don't appear unless ENTER
2294 searchControl.setSearchStartingCallback(this, function(control, searcher, query) {});
2295
2296 // forcefully regain key-up event control (previously jacked by search api)
2297 $("#search_autocomplete").keyup(function(event) {
2298 return search_changed(event, false, toRoot);
2299 });
2300
2301 return false;
2302}
2303
2304
2305
2306/* ########################################################## */
2307/* ################ CUSTOM SEARCH ENGINE ################## */
2308/* ########################################################## */
2309
2310var searchControl;
2311google.load('search', '1', {"callback" : function() {
2312 searchControl = new google.search.SearchControl();
2313 } });
2314
2315function loadSearchResults() {
2316 document.getElementById("search_autocomplete").style.color = "#000";
2317
2318 searchControl = new google.search.SearchControl();
2319
2320 // use our existing search form and use tabs when multiple searchers are used
2321 drawOptions = new google.search.DrawOptions();
2322 drawOptions.setDrawMode(google.search.SearchControl.DRAW_MODE_TABBED);
2323 drawOptions.setInput(document.getElementById("search_autocomplete"));
2324
2325 // configure search result options
2326 searchOptions = new google.search.SearcherOptions();
2327 searchOptions.setExpandMode(GSearchControl.EXPAND_MODE_OPEN);
2328
2329 // configure each of the searchers, for each tab
2330 devSiteSearcher = new google.search.WebSearch();
2331 devSiteSearcher.setUserDefinedLabel("All");
2332 devSiteSearcher.setSiteRestriction("001482626316274216503:zu90b7s047u");
2333
2334 designSearcher = new google.search.WebSearch();
2335 designSearcher.setUserDefinedLabel("Design");
2336 designSearcher.setSiteRestriction("http://developer.android.com/design/");
2337
2338 trainingSearcher = new google.search.WebSearch();
2339 trainingSearcher.setUserDefinedLabel("Training");
2340 trainingSearcher.setSiteRestriction("http://developer.android.com/training/");
2341
2342 guidesSearcher = new google.search.WebSearch();
2343 guidesSearcher.setUserDefinedLabel("Guides");
2344 guidesSearcher.setSiteRestriction("http://developer.android.com/guide/");
2345
2346 referenceSearcher = new google.search.WebSearch();
2347 referenceSearcher.setUserDefinedLabel("Reference");
2348 referenceSearcher.setSiteRestriction("http://developer.android.com/reference/");
2349
2350 googleSearcher = new google.search.WebSearch();
2351 googleSearcher.setUserDefinedLabel("Google Services");
2352 googleSearcher.setSiteRestriction("http://developer.android.com/google/");
2353
2354 blogSearcher = new google.search.WebSearch();
2355 blogSearcher.setUserDefinedLabel("Blog");
2356 blogSearcher.setSiteRestriction("http://android-developers.blogspot.com");
2357
2358 // add each searcher to the search control
2359 searchControl.addSearcher(devSiteSearcher, searchOptions);
2360 searchControl.addSearcher(designSearcher, searchOptions);
2361 searchControl.addSearcher(trainingSearcher, searchOptions);
2362 searchControl.addSearcher(guidesSearcher, searchOptions);
2363 searchControl.addSearcher(referenceSearcher, searchOptions);
2364 searchControl.addSearcher(googleSearcher, searchOptions);
2365 searchControl.addSearcher(blogSearcher, searchOptions);
2366
2367 // configure result options
2368 searchControl.setResultSetSize(google.search.Search.LARGE_RESULTSET);
2369 searchControl.setLinkTarget(google.search.Search.LINK_TARGET_SELF);
2370 searchControl.setTimeoutInterval(google.search.SearchControl.TIMEOUT_SHORT);
2371 searchControl.setNoResultsString(google.search.SearchControl.NO_RESULTS_DEFAULT_STRING);
2372
2373 // upon ajax search, refresh the url and search title
2374 searchControl.setSearchStartingCallback(this, function(control, searcher, query) {
2375 updateResultTitle(query);
2376 var query = document.getElementById('search_autocomplete').value;
2377 location.hash = 'q=' + query;
2378 });
2379
2380 // once search results load, set up click listeners
2381 searchControl.setSearchCompleteCallback(this, function(control, searcher, query) {
2382 addResultClickListeners();
2383 });
2384
2385 // draw the search results box
2386 searchControl.draw(document.getElementById("leftSearchControl"), drawOptions);
2387
2388 // get query and execute the search
2389 searchControl.execute(decodeURI(getQuery(location.hash)));
2390
2391 document.getElementById("search_autocomplete").focus();
2392 addTabListeners();
2393}
2394// End of loadSearchResults
2395
2396
2397google.setOnLoadCallback(function(){
2398 if (location.hash.indexOf("q=") == -1) {
2399 // if there's no query in the url, don't search and make sure results are hidden
2400 $('#searchResults').hide();
2401 return;
2402 } else {
2403 // first time loading search results for this page
2404 $('#searchResults').slideDown('slow');
2405 $(".search .close").removeClass("hide");
2406 loadSearchResults();
2407 }
2408}, true);
2409
2410// when an event on the browser history occurs (back, forward, load) requery hash and do search
2411$(window).hashchange( function(){
2412 // Exit if the hash isn't a search query or there's an error in the query
2413 if ((location.hash.indexOf("q=") == -1) || (query == "undefined")) {
2414 // If the results pane is open, close it.
2415 if (!$("#searchResults").is(":hidden")) {
2416 hideResults();
2417 }
2418 return;
2419 }
2420
2421 // Otherwise, we have a search to do
2422 var query = decodeURI(getQuery(location.hash));
2423 searchControl.execute(query);
2424 $('#searchResults').slideDown('slow');
2425 $("#search_autocomplete").focus();
2426 $(".search .close").removeClass("hide");
2427
2428 updateResultTitle(query);
2429});
2430
2431function updateResultTitle(query) {
2432 $("#searchTitle").html("Results for <em>" + escapeHTML(query) + "</em>");
2433}
2434
2435// forcefully regain key-up event control (previously jacked by search api)
2436$("#search_autocomplete").keyup(function(event) {
2437 return search_changed(event, false, toRoot);
2438});
2439
2440// add event listeners to each tab so we can track the browser history
2441function addTabListeners() {
2442 var tabHeaders = $(".gsc-tabHeader");
2443 for (var i = 0; i < tabHeaders.length; i++) {
2444 $(tabHeaders[i]).attr("id",i).click(function() {
2445 /*
2446 // make a copy of the page numbers for the search left pane
2447 setTimeout(function() {
2448 // remove any residual page numbers
2449 $('#searchResults .gsc-tabsArea .gsc-cursor-box.gs-bidi-start-align').remove();
2450 // move the page numbers to the left position; make a clone,
2451 // because the element is drawn to the DOM only once
2452 // and because we're going to remove it (previous line),
2453 // we need it to be available to move again as the user navigates
2454 $('#searchResults .gsc-webResult .gsc-cursor-box.gs-bidi-start-align:visible')
2455 .clone().appendTo('#searchResults .gsc-tabsArea');
2456 }, 200);
2457 */
2458 });
2459 }
2460 setTimeout(function(){$(tabHeaders[0]).click()},200);
2461}
2462
2463// add analytics tracking events to each result link
2464function addResultClickListeners() {
2465 $("#searchResults a.gs-title").each(function(index, link) {
2466 // When user clicks enter for Google search results, track it
2467 $(link).click(function() {
2468 _gaq.push(['_trackEvent', 'Google Click', 'clicked: ' + $(this).text(),
2469 'from: ' + $("#search_autocomplete").val()]);
2470 });
2471 });
2472}
2473
2474
2475function getQuery(hash) {
2476 var queryParts = hash.split('=');
2477 return queryParts[1];
2478}
2479
2480/* returns the given string with all HTML brackets converted to entities
2481 TODO: move this to the site's JS library */
2482function escapeHTML(string) {
2483 return string.replace(/</g,"&lt;")
2484 .replace(/>/g,"&gt;");
2485}
2486
2487
2488
2489
2490
2491
2492
2493/* ######################################################## */
2494/* ################# JAVADOC REFERENCE ################### */
2495/* ######################################################## */
2496
2497/* Initialize some droiddoc stuff, but only if we're in the reference */
2498if (location.pathname.indexOf("/reference") == 0) {
2499 if(!(location.pathname.indexOf("/reference-gms/packages.html") == 0)
2500 && !(location.pathname.indexOf("/reference-gcm/packages.html") == 0)
2501 && !(location.pathname.indexOf("/reference/com/google") == 0)) {
2502 $(document).ready(function() {
2503 // init available apis based on user pref
2504 changeApiLevel();
2505 initSidenavHeightResize()
2506 });
2507 }
2508}
2509
2510var API_LEVEL_COOKIE = "api_level";
2511var minLevel = 1;
2512var maxLevel = 1;
2513
2514/******* SIDENAV DIMENSIONS ************/
2515
2516 function initSidenavHeightResize() {
2517 // Change the drag bar size to nicely fit the scrollbar positions
2518 var $dragBar = $(".ui-resizable-s");
2519 $dragBar.css({'width': $dragBar.parent().width() - 5 + "px"});
2520
2521 $( "#resize-packages-nav" ).resizable({
2522 containment: "#nav-panels",
2523 handles: "s",
2524 alsoResize: "#packages-nav",
2525 resize: function(event, ui) { resizeNav(); }, /* resize the nav while dragging */
2526 stop: function(event, ui) { saveNavPanels(); } /* once stopped, save the sizes to cookie */
2527 });
2528
2529 }
2530
2531function updateSidenavFixedWidth() {
2532 if (!navBarIsFixed) return;
2533 $('#devdoc-nav').css({
2534 'width' : $('#side-nav').css('width'),
2535 'margin' : $('#side-nav').css('margin')
2536 });
2537 $('#devdoc-nav a.totop').css({'display':'block','width':$("#nav").innerWidth()+'px'});
2538
2539 initSidenavHeightResize();
2540}
2541
2542function updateSidenavFullscreenWidth() {
2543 if (!navBarIsFixed) return;
2544 $('#devdoc-nav').css({
2545 'width' : $('#side-nav').css('width'),
2546 'margin' : $('#side-nav').css('margin')
2547 });
2548 $('#devdoc-nav .totop').css({'left': 'inherit'});
2549
2550 initSidenavHeightResize();
2551}
2552
2553function buildApiLevelSelector() {
2554 maxLevel = SINCE_DATA.length;
2555 var userApiLevel = parseInt(readCookie(API_LEVEL_COOKIE));
2556 userApiLevel = userApiLevel == 0 ? maxLevel : userApiLevel; // If there's no cookie (zero), use the max by default
2557
2558 minLevel = parseInt($("#doc-api-level").attr("class"));
2559 // Handle provisional api levels; the provisional level will always be the highest possible level
2560 // Provisional api levels will also have a length; other stuff that's just missing a level won't,
2561 // so leave those kinds of entities at the default level of 1 (for example, the R.styleable class)
2562 if (isNaN(minLevel) && minLevel.length) {
2563 minLevel = maxLevel;
2564 }
2565 var select = $("#apiLevelSelector").html("").change(changeApiLevel);
2566 for (var i = maxLevel-1; i >= 0; i--) {
2567 var option = $("<option />").attr("value",""+SINCE_DATA[i]).append(""+SINCE_DATA[i]);
2568 // if (SINCE_DATA[i] < minLevel) option.addClass("absent"); // always false for strings (codenames)
2569 select.append(option);
2570 }
2571
2572 // get the DOM element and use setAttribute cuz IE6 fails when using jquery .attr('selected',true)
2573 var selectedLevelItem = $("#apiLevelSelector option[value='"+userApiLevel+"']").get(0);
2574 selectedLevelItem.setAttribute('selected',true);
2575}
2576
2577function changeApiLevel() {
2578 maxLevel = SINCE_DATA.length;
2579 var selectedLevel = maxLevel;
2580
2581 selectedLevel = parseInt($("#apiLevelSelector option:selected").val());
2582 toggleVisisbleApis(selectedLevel, "body");
2583
2584 var date = new Date();
2585 date.setTime(date.getTime()+(10*365*24*60*60*1000)); // keep this for 10 years
2586 var expiration = date.toGMTString();
2587 writeCookie(API_LEVEL_COOKIE, selectedLevel, null, expiration);
2588
2589 if (selectedLevel < minLevel) {
2590 var thing = ($("#jd-header").html().indexOf("package") != -1) ? "package" : "class";
2591 $("#naMessage").show().html("<div><p><strong>This " + thing
2592 + " requires API level " + minLevel + " or higher.</strong></p>"
2593 + "<p>This document is hidden because your selected API level for the documentation is "
2594 + selectedLevel + ". You can change the documentation API level with the selector "
2595 + "above the left navigation.</p>"
2596 + "<p>For more information about specifying the API level your app requires, "
2597 + "read <a href='" + toRoot + "training/basics/supporting-devices/platforms.html'"
2598 + ">Supporting Different Platform Versions</a>.</p>"
2599 + "<input type='button' value='OK, make this page visible' "
2600 + "title='Change the API level to " + minLevel + "' "
2601 + "onclick='$(\"#apiLevelSelector\").val(\"" + minLevel + "\");changeApiLevel();' />"
2602 + "</div>");
2603 } else {
2604 $("#naMessage").hide();
2605 }
2606}
2607
2608function toggleVisisbleApis(selectedLevel, context) {
2609 var apis = $(".api",context);
2610 apis.each(function(i) {
2611 var obj = $(this);
2612 var className = obj.attr("class");
2613 var apiLevelIndex = className.lastIndexOf("-")+1;
2614 var apiLevelEndIndex = className.indexOf(" ", apiLevelIndex);
2615 apiLevelEndIndex = apiLevelEndIndex != -1 ? apiLevelEndIndex : className.length;
2616 var apiLevel = className.substring(apiLevelIndex, apiLevelEndIndex);
2617 if (apiLevel.length == 0) { // for odd cases when the since data is actually missing, just bail
2618 return;
2619 }
2620 apiLevel = parseInt(apiLevel);
2621
2622 // Handle provisional api levels; if this item's level is the provisional one, set it to the max
2623 var selectedLevelNum = parseInt(selectedLevel)
2624 var apiLevelNum = parseInt(apiLevel);
2625 if (isNaN(apiLevelNum)) {
2626 apiLevelNum = maxLevel;
2627 }
2628
2629 // Grey things out that aren't available and give a tooltip title
2630 if (apiLevelNum > selectedLevelNum) {
2631 obj.addClass("absent").attr("title","Requires API Level \""
2632 + apiLevel + "\" or higher. To reveal, change the target API level "
2633 + "above the left navigation.");
2634 }
2635 else obj.removeClass("absent").removeAttr("title");
2636 });
2637}
2638
2639
2640
2641
2642/* ################# SIDENAV TREE VIEW ################### */
2643
2644function new_node(me, mom, text, link, children_data, api_level)
2645{
2646 var node = new Object();
2647 node.children = Array();
2648 node.children_data = children_data;
2649 node.depth = mom.depth + 1;
2650
2651 node.li = document.createElement("li");
2652 mom.get_children_ul().appendChild(node.li);
2653
2654 node.label_div = document.createElement("div");
2655 node.label_div.className = "label";
2656 if (api_level != null) {
2657 $(node.label_div).addClass("api");
2658 $(node.label_div).addClass("api-level-"+api_level);
2659 }
2660 node.li.appendChild(node.label_div);
2661
2662 if (children_data != null) {
2663 node.expand_toggle = document.createElement("a");
2664 node.expand_toggle.href = "javascript:void(0)";
2665 node.expand_toggle.onclick = function() {
2666 if (node.expanded) {
2667 $(node.get_children_ul()).slideUp("fast");
2668 node.plus_img.src = me.toroot + "assets/images/triangle-closed-small.png";
2669 node.expanded = false;
2670 } else {
2671 expand_node(me, node);
2672 }
2673 };
2674 node.label_div.appendChild(node.expand_toggle);
2675
2676 node.plus_img = document.createElement("img");
2677 node.plus_img.src = me.toroot + "assets/images/triangle-closed-small.png";
2678 node.plus_img.className = "plus";
2679 node.plus_img.width = "8";
2680 node.plus_img.border = "0";
2681 node.expand_toggle.appendChild(node.plus_img);
2682
2683 node.expanded = false;
2684 }
2685
2686 var a = document.createElement("a");
2687 node.label_div.appendChild(a);
2688 node.label = document.createTextNode(text);
2689 a.appendChild(node.label);
2690 if (link) {
2691 a.href = me.toroot + link;
2692 } else {
2693 if (children_data != null) {
2694 a.className = "nolink";
2695 a.href = "javascript:void(0)";
2696 a.onclick = node.expand_toggle.onclick;
2697 // This next line shouldn't be necessary. I'll buy a beer for the first
2698 // person who figures out how to remove this line and have the link
2699 // toggle shut on the first try. --joeo@android.com
2700 node.expanded = false;
2701 }
2702 }
2703
2704
2705 node.children_ul = null;
2706 node.get_children_ul = function() {
2707 if (!node.children_ul) {
2708 node.children_ul = document.createElement("ul");
2709 node.children_ul.className = "children_ul";
2710 node.children_ul.style.display = "none";
2711 node.li.appendChild(node.children_ul);
2712 }
2713 return node.children_ul;
2714 };
2715
2716 return node;
2717}
2718
2719
2720
2721
2722function expand_node(me, node)
2723{
2724 if (node.children_data && !node.expanded) {
2725 if (node.children_visited) {
2726 $(node.get_children_ul()).slideDown("fast");
2727 } else {
2728 get_node(me, node);
2729 if ($(node.label_div).hasClass("absent")) {
2730 $(node.get_children_ul()).addClass("absent");
2731 }
2732 $(node.get_children_ul()).slideDown("fast");
2733 }
2734 node.plus_img.src = me.toroot + "assets/images/triangle-opened-small.png";
2735 node.expanded = true;
2736
2737 // perform api level toggling because new nodes are new to the DOM
2738 var selectedLevel = $("#apiLevelSelector option:selected").val();
2739 toggleVisisbleApis(selectedLevel, "#side-nav");
2740 }
2741}
2742
2743function get_node(me, mom)
2744{
2745 mom.children_visited = true;
2746 for (var i in mom.children_data) {
2747 var node_data = mom.children_data[i];
2748 mom.children[i] = new_node(me, mom, node_data[0], node_data[1],
2749 node_data[2], node_data[3]);
2750 }
2751}
2752
2753function this_page_relative(toroot)
2754{
2755 var full = document.location.pathname;
2756 var file = "";
2757 if (toroot.substr(0, 1) == "/") {
2758 if (full.substr(0, toroot.length) == toroot) {
2759 return full.substr(toroot.length);
2760 } else {
2761 // the file isn't under toroot. Fail.
2762 return null;
2763 }
2764 } else {
2765 if (toroot != "./") {
2766 toroot = "./" + toroot;
2767 }
2768 do {
2769 if (toroot.substr(toroot.length-3, 3) == "../" || toroot == "./") {
2770 var pos = full.lastIndexOf("/");
2771 file = full.substr(pos) + file;
2772 full = full.substr(0, pos);
2773 toroot = toroot.substr(0, toroot.length-3);
2774 }
2775 } while (toroot != "" && toroot != "/");
2776 return file.substr(1);
2777 }
2778}
2779
2780function find_page(url, data)
2781{
2782 var nodes = data;
2783 var result = null;
2784 for (var i in nodes) {
2785 var d = nodes[i];
2786 if (d[1] == url) {
2787 return new Array(i);
2788 }
2789 else if (d[2] != null) {
2790 result = find_page(url, d[2]);
2791 if (result != null) {
2792 return (new Array(i).concat(result));
2793 }
2794 }
2795 }
2796 return null;
2797}
2798
2799function init_default_navtree(toroot) {
2800 // load json file for navtree data
2801 $.getScript(toRoot + 'navtree_data.js', function(data, textStatus, jqxhr) {
2802 // when the file is loaded, initialize the tree
2803 if(jqxhr.status === 200) {
2804 init_navtree("tree-list", toroot, NAVTREE_DATA);
2805 }
2806 });
2807
2808 // perform api level toggling because because the whole tree is new to the DOM
2809 var selectedLevel = $("#apiLevelSelector option:selected").val();
2810 toggleVisisbleApis(selectedLevel, "#side-nav");
2811}
2812
2813function init_navtree(navtree_id, toroot, root_nodes)
2814{
2815 var me = new Object();
2816 me.toroot = toroot;
2817 me.node = new Object();
2818
2819 me.node.li = document.getElementById(navtree_id);
2820 me.node.children_data = root_nodes;
2821 me.node.children = new Array();
2822 me.node.children_ul = document.createElement("ul");
2823 me.node.get_children_ul = function() { return me.node.children_ul; };
2824 //me.node.children_ul.className = "children_ul";
2825 me.node.li.appendChild(me.node.children_ul);
2826 me.node.depth = 0;
2827
2828 get_node(me, me.node);
2829
2830 me.this_page = this_page_relative(toroot);
2831 me.breadcrumbs = find_page(me.this_page, root_nodes);
2832 if (me.breadcrumbs != null && me.breadcrumbs.length != 0) {
2833 var mom = me.node;
2834 for (var i in me.breadcrumbs) {
2835 var j = me.breadcrumbs[i];
2836 mom = mom.children[j];
2837 expand_node(me, mom);
2838 }
2839 mom.label_div.className = mom.label_div.className + " selected";
2840 addLoadEvent(function() {
2841 scrollIntoView("nav-tree");
2842 });
2843 }
2844}
2845
2846
2847
2848
2849
2850
2851
2852
2853/* TODO: eliminate redundancy with non-google functions */
2854function init_google_navtree(navtree_id, toroot, root_nodes)
2855{
2856 var me = new Object();
2857 me.toroot = toroot;
2858 me.node = new Object();
2859
2860 me.node.li = document.getElementById(navtree_id);
2861 me.node.children_data = root_nodes;
2862 me.node.children = new Array();
2863 me.node.children_ul = document.createElement("ul");
2864 me.node.get_children_ul = function() { return me.node.children_ul; };
2865 //me.node.children_ul.className = "children_ul";
2866 me.node.li.appendChild(me.node.children_ul);
2867 me.node.depth = 0;
2868
2869 get_google_node(me, me.node);
2870}
2871
2872function new_google_node(me, mom, text, link, children_data, api_level)
2873{
2874 var node = new Object();
2875 var child;
2876 node.children = Array();
2877 node.children_data = children_data;
2878 node.depth = mom.depth + 1;
2879 node.get_children_ul = function() {
2880 if (!node.children_ul) {
2881 node.children_ul = document.createElement("ul");
2882 node.children_ul.className = "tree-list-children";
2883 node.li.appendChild(node.children_ul);
2884 }
2885 return node.children_ul;
2886 };
2887 node.li = document.createElement("li");
2888
2889 mom.get_children_ul().appendChild(node.li);
2890
2891
2892 if(link) {
2893 child = document.createElement("a");
2894
2895 }
2896 else {
2897 child = document.createElement("span");
2898 child.className = "tree-list-subtitle";
2899
2900 }
2901 if (children_data != null) {
2902 node.li.className="nav-section";
2903 node.label_div = document.createElement("div");
2904 node.label_div.className = "nav-section-header-ref";
2905 node.li.appendChild(node.label_div);
2906 get_google_node(me, node);
2907 node.label_div.appendChild(child);
2908 }
2909 else {
2910 node.li.appendChild(child);
2911 }
2912 if(link) {
2913 child.href = me.toroot + link;
2914 }
2915 node.label = document.createTextNode(text);
2916 child.appendChild(node.label);
2917
2918 node.children_ul = null;
2919
2920 return node;
2921}
2922
2923function get_google_node(me, mom)
2924{
2925 mom.children_visited = true;
2926 var linkText;
2927 for (var i in mom.children_data) {
2928 var node_data = mom.children_data[i];
2929 linkText = node_data[0];
2930
2931 if(linkText.match("^"+"com.google.android")=="com.google.android"){
2932 linkText = linkText.substr(19, linkText.length);
2933 }
2934 mom.children[i] = new_google_node(me, mom, linkText, node_data[1],
2935 node_data[2], node_data[3]);
2936 }
2937}
2938
2939
2940
2941
2942
2943
2944/****** NEW version of script to build google and sample navs dynamically ******/
2945// TODO: update Google reference docs to tolerate this new implementation
2946
2947var NODE_NAME = 0;
2948var NODE_HREF = 1;
2949var NODE_GROUP = 2;
2950var NODE_TAGS = 3;
2951var NODE_CHILDREN = 4;
2952
2953function init_google_navtree2(navtree_id, data)
2954{
2955 var $containerUl = $("#"+navtree_id);
2956 for (var i in data) {
2957 var node_data = data[i];
2958 $containerUl.append(new_google_node2(node_data));
2959 }
2960
2961 // Make all third-generation list items 'sticky' to prevent them from collapsing
2962 $containerUl.find('li li li.nav-section').addClass('sticky');
2963
2964 initExpandableNavItems("#"+navtree_id);
2965}
2966
2967function new_google_node2(node_data)
2968{
2969 var linkText = node_data[NODE_NAME];
2970 if(linkText.match("^"+"com.google.android")=="com.google.android"){
2971 linkText = linkText.substr(19, linkText.length);
2972 }
2973 var $li = $('<li>');
2974 var $a;
2975 if (node_data[NODE_HREF] != null) {
2976 $a = $('<a href="' + toRoot + node_data[NODE_HREF] + '" title="' + linkText + '" >'
2977 + linkText + '</a>');
2978 } else {
2979 $a = $('<a href="#" onclick="return false;" title="' + linkText + '" >'
2980 + linkText + '/</a>');
2981 }
2982 var $childUl = $('<ul>');
2983 if (node_data[NODE_CHILDREN] != null) {
2984 $li.addClass("nav-section");
2985 $a = $('<div class="nav-section-header">').append($a);
2986 if (node_data[NODE_HREF] == null) $a.addClass('empty');
2987
2988 for (var i in node_data[NODE_CHILDREN]) {
2989 var child_node_data = node_data[NODE_CHILDREN][i];
2990 $childUl.append(new_google_node2(child_node_data));
2991 }
2992 $li.append($childUl);
2993 }
2994 $li.prepend($a);
2995
2996 return $li;
2997}
2998
2999
3000
3001
3002
3003
3004
3005
3006
3007
3008
3009function showGoogleRefTree() {
3010 init_default_google_navtree(toRoot);
3011 init_default_gcm_navtree(toRoot);
3012}
3013
3014function init_default_google_navtree(toroot) {
3015 // load json file for navtree data
3016 $.getScript(toRoot + 'gms_navtree_data.js', function(data, textStatus, jqxhr) {
3017 // when the file is loaded, initialize the tree
3018 if(jqxhr.status === 200) {
3019 init_google_navtree("gms-tree-list", toroot, GMS_NAVTREE_DATA);
3020 highlightSidenav();
3021 resizeNav();
3022 }
3023 });
3024}
3025
3026function init_default_gcm_navtree(toroot) {
3027 // load json file for navtree data
3028 $.getScript(toRoot + 'gcm_navtree_data.js', function(data, textStatus, jqxhr) {
3029 // when the file is loaded, initialize the tree
3030 if(jqxhr.status === 200) {
3031 init_google_navtree("gcm-tree-list", toroot, GCM_NAVTREE_DATA);
3032 highlightSidenav();
3033 resizeNav();
3034 }
3035 });
3036}
3037
3038function showSamplesRefTree() {
3039 init_default_samples_navtree(toRoot);
3040}
3041
3042function init_default_samples_navtree(toroot) {
3043 // load json file for navtree data
3044 $.getScript(toRoot + 'samples_navtree_data.js', function(data, textStatus, jqxhr) {
3045 // when the file is loaded, initialize the tree
3046 if(jqxhr.status === 200) {
3047 // hack to remove the "about the samples" link then put it back in
3048 // after we nuke the list to remove the dummy static list of samples
3049 var $firstLi = $("#nav.samples-nav > li:first-child").clone();
3050 $("#nav.samples-nav").empty();
3051 $("#nav.samples-nav").append($firstLi);
3052
3053 init_google_navtree2("nav.samples-nav", SAMPLES_NAVTREE_DATA);
3054 highlightSidenav();
3055 resizeNav();
3056 if ($("#jd-content #samples").length) {
3057 showSamples();
3058 }
3059 }
3060 });
3061}
3062
3063/* TOGGLE INHERITED MEMBERS */
3064
3065/* Toggle an inherited class (arrow toggle)
3066 * @param linkObj The link that was clicked.
3067 * @param expand 'true' to ensure it's expanded. 'false' to ensure it's closed.
3068 * 'null' to simply toggle.
3069 */
3070function toggleInherited(linkObj, expand) {
3071 var base = linkObj.getAttribute("id");
3072 var list = document.getElementById(base + "-list");
3073 var summary = document.getElementById(base + "-summary");
3074 var trigger = document.getElementById(base + "-trigger");
3075 var a = $(linkObj);
3076 if ( (expand == null && a.hasClass("closed")) || expand ) {
3077 list.style.display = "none";
3078 summary.style.display = "block";
3079 trigger.src = toRoot + "assets/images/triangle-opened.png";
3080 a.removeClass("closed");
3081 a.addClass("opened");
3082 } else if ( (expand == null && a.hasClass("opened")) || (expand == false) ) {
3083 list.style.display = "block";
3084 summary.style.display = "none";
3085 trigger.src = toRoot + "assets/images/triangle-closed.png";
3086 a.removeClass("opened");
3087 a.addClass("closed");
3088 }
3089 return false;
3090}
3091
3092/* Toggle all inherited classes in a single table (e.g. all inherited methods)
3093 * @param linkObj The link that was clicked.
3094 * @param expand 'true' to ensure it's expanded. 'false' to ensure it's closed.
3095 * 'null' to simply toggle.
3096 */
3097function toggleAllInherited(linkObj, expand) {
3098 var a = $(linkObj);
3099 var table = $(a.parent().parent().parent()); // ugly way to get table/tbody
3100 var expandos = $(".jd-expando-trigger", table);
3101 if ( (expand == null && a.text() == "[Expand]") || expand ) {
3102 expandos.each(function(i) {
3103 toggleInherited(this, true);
3104 });
3105 a.text("[Collapse]");
3106 } else if ( (expand == null && a.text() == "[Collapse]") || (expand == false) ) {
3107 expandos.each(function(i) {
3108 toggleInherited(this, false);
3109 });
3110 a.text("[Expand]");
3111 }
3112 return false;
3113}
3114
3115/* Toggle all inherited members in the class (link in the class title)
3116 */
3117function toggleAllClassInherited() {
3118 var a = $("#toggleAllClassInherited"); // get toggle link from class title
3119 var toggles = $(".toggle-all", $("#body-content"));
3120 if (a.text() == "[Expand All]") {
3121 toggles.each(function(i) {
3122 toggleAllInherited(this, true);
3123 });
3124 a.text("[Collapse All]");
3125 } else {
3126 toggles.each(function(i) {
3127 toggleAllInherited(this, false);
3128 });
3129 a.text("[Expand All]");
3130 }
3131 return false;
3132}
3133
3134/* Expand all inherited members in the class. Used when initiating page search */
3135function ensureAllInheritedExpanded() {
3136 var toggles = $(".toggle-all", $("#body-content"));
3137 toggles.each(function(i) {
3138 toggleAllInherited(this, true);
3139 });
3140 $("#toggleAllClassInherited").text("[Collapse All]");
3141}
3142
3143
3144/* HANDLE KEY EVENTS
3145 * - Listen for Ctrl+F (Cmd on Mac) and expand all inherited members (to aid page search)
3146 */
3147var agent = navigator['userAgent'].toLowerCase();
3148var mac = agent.indexOf("macintosh") != -1;
3149
3150$(document).keydown( function(e) {
3151var control = mac ? e.metaKey && !e.ctrlKey : e.ctrlKey; // get ctrl key
3152 if (control && e.which == 70) { // 70 is "F"
3153 ensureAllInheritedExpanded();
3154 }
3155});
3156
3157
3158
3159
3160
3161
3162/* On-demand functions */
3163
3164/** Move sample code line numbers out of PRE block and into non-copyable column */
3165function initCodeLineNumbers() {
3166 var numbers = $("#codesample-block a.number");
3167 if (numbers.length) {
3168 $("#codesample-line-numbers").removeClass("hidden").append(numbers);
3169 }
3170
3171 $(document).ready(function() {
3172 // select entire line when clicked
3173 $("span.code-line").click(function() {
3174 if (!shifted) {
3175 selectText(this);
3176 }
3177 });
3178 // invoke line link on double click
3179 $(".code-line").dblclick(function() {
3180 document.location.hash = $(this).attr('id');
3181 });
3182 // highlight the line when hovering on the number
3183 $("#codesample-line-numbers a.number").mouseover(function() {
3184 var id = $(this).attr('href');
3185 $(id).css('background','#e7e7e7');
3186 });
3187 $("#codesample-line-numbers a.number").mouseout(function() {
3188 var id = $(this).attr('href');
3189 $(id).css('background','none');
3190 });
3191 });
3192}
3193
3194// create SHIFT key binder to avoid the selectText method when selecting multiple lines
3195var shifted = false;
3196$(document).bind('keyup keydown', function(e){shifted = e.shiftKey; return true;} );
3197
3198// courtesy of jasonedelman.com
3199function selectText(element) {
3200 var doc = document
3201 , range, selection
3202 ;
3203 if (doc.body.createTextRange) { //ms
3204 range = doc.body.createTextRange();
3205 range.moveToElementText(element);
3206 range.select();
3207 } else if (window.getSelection) { //all others
3208 selection = window.getSelection();
3209 range = doc.createRange();
3210 range.selectNodeContents(element);
3211 selection.removeAllRanges();
3212 selection.addRange(range);
3213 }
3214}
3215
3216
3217
3218
3219/** Display links and other information about samples that match the
3220 group specified by the URL */
3221function showSamples() {
3222 var group = $("#samples").attr('class');
3223 $("#samples").html("<p>Here are some samples for <b>" + group + "</b> apps:</p>");
3224
3225 var $ul = $("<ul>");
3226 $selectedLi = $("#nav li.selected");
3227
3228 $selectedLi.children("ul").children("li").each(function() {
3229 var $li = $("<li>").append($(this).find("a").first().clone());
3230 $ul.append($li);
3231 });
3232
3233 $("#samples").append($ul);
3234
3235}