| OLD | NEW |
| (Empty) |
| 1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. | |
| 2 // Use of this source code is governed by a BSD-style license that can be | |
| 3 // found in the LICENSE file. | |
| 4 | |
| 5 cr.define('options', function() { | |
| 6 const OptionsPage = options.OptionsPage; | |
| 7 | |
| 8 /** | |
| 9 * Encapsulated handling of a search bubble. | |
| 10 * @constructor | |
| 11 */ | |
| 12 function SearchBubble(text) { | |
| 13 var el = cr.doc.createElement('div'); | |
| 14 SearchBubble.decorate(el); | |
| 15 el.textContent = text; | |
| 16 return el; | |
| 17 } | |
| 18 | |
| 19 SearchBubble.decorate = function(el) { | |
| 20 el.__proto__ = SearchBubble.prototype; | |
| 21 el.decorate(); | |
| 22 }; | |
| 23 | |
| 24 SearchBubble.prototype = { | |
| 25 __proto__: HTMLDivElement.prototype, | |
| 26 | |
| 27 decorate: function() { | |
| 28 this.className = 'search-bubble'; | |
| 29 | |
| 30 // We create a timer to periodically update the position of the bubbles. | |
| 31 // While this isn't all that desirable, it's the only sure-fire way of | |
| 32 // making sure the bubbles stay in the correct location as sections | |
| 33 // may dynamically change size at any time. | |
| 34 var self = this; | |
| 35 this.intervalId = setInterval(this.updatePosition.bind(this), 250); | |
| 36 }, | |
| 37 | |
| 38 /** | |
| 39 * Attach the bubble to the element. | |
| 40 */ | |
| 41 attachTo: function(element) { | |
| 42 var parent = element.parentElement; | |
| 43 if (!parent) | |
| 44 return; | |
| 45 if (parent.tagName == 'TD') { | |
| 46 // To make absolute positioning work inside a table cell we need | |
| 47 // to wrap the bubble div into another div with position:relative. | |
| 48 // This only works properly if the element is the first child of the | |
| 49 // table cell which is true for all options pages. | |
| 50 this.wrapper = cr.doc.createElement('div'); | |
| 51 this.wrapper.className = 'search-bubble-wrapper'; | |
| 52 this.wrapper.appendChild(this); | |
| 53 parent.insertBefore(this.wrapper, element); | |
| 54 } else { | |
| 55 parent.insertBefore(this, element); | |
| 56 } | |
| 57 }, | |
| 58 | |
| 59 /** | |
| 60 * Clear the interval timer and remove the element from the page. | |
| 61 */ | |
| 62 dispose: function() { | |
| 63 clearInterval(this.intervalId); | |
| 64 | |
| 65 var child = this.wrapper || this; | |
| 66 var parent = child.parentNode; | |
| 67 if (parent) | |
| 68 parent.removeChild(child); | |
| 69 }, | |
| 70 | |
| 71 /** | |
| 72 * Update the position of the bubble. Called at creation time and then | |
| 73 * periodically while the bubble remains visible. | |
| 74 */ | |
| 75 updatePosition: function() { | |
| 76 // This bubble is 'owned' by the next sibling. | |
| 77 var owner = (this.wrapper || this).nextSibling; | |
| 78 | |
| 79 // If there isn't an offset parent, we have nothing to do. | |
| 80 if (!owner.offsetParent) | |
| 81 return; | |
| 82 | |
| 83 // Position the bubble below the location of the owner. | |
| 84 var left = owner.offsetLeft + owner.offsetWidth / 2 - | |
| 85 this.offsetWidth / 2; | |
| 86 var top = owner.offsetTop + owner.offsetHeight; | |
| 87 | |
| 88 // Update the position in the CSS. Cache the last values for | |
| 89 // best performance. | |
| 90 if (left != this.lastLeft) { | |
| 91 this.style.left = left + 'px'; | |
| 92 this.lastLeft = left; | |
| 93 } | |
| 94 if (top != this.lastTop) { | |
| 95 this.style.top = top + 'px'; | |
| 96 this.lastTop = top; | |
| 97 } | |
| 98 } | |
| 99 } | |
| 100 | |
| 101 /** | |
| 102 * Encapsulated handling of the search page. | |
| 103 * @constructor | |
| 104 */ | |
| 105 function SearchPage() { | |
| 106 OptionsPage.call(this, 'search', templateData.searchPageTabTitle, | |
| 107 'searchPage'); | |
| 108 this.searchActive = false; | |
| 109 } | |
| 110 | |
| 111 cr.addSingletonGetter(SearchPage); | |
| 112 | |
| 113 SearchPage.prototype = { | |
| 114 // Inherit SearchPage from OptionsPage. | |
| 115 __proto__: OptionsPage.prototype, | |
| 116 | |
| 117 /** | |
| 118 * Initialize the page. | |
| 119 */ | |
| 120 initializePage: function() { | |
| 121 // Call base class implementation to start preference initialization. | |
| 122 OptionsPage.prototype.initializePage.call(this); | |
| 123 | |
| 124 var self = this; | |
| 125 | |
| 126 // Create a search field element. | |
| 127 var searchField = document.createElement('input'); | |
| 128 searchField.id = 'search-field'; | |
| 129 searchField.type = 'search'; | |
| 130 searchField.incremental = true; | |
| 131 searchField.placeholder = localStrings.getString('searchPlaceholder'); | |
| 132 this.searchField = searchField; | |
| 133 | |
| 134 // Replace the contents of the navigation tab with the search field. | |
| 135 self.tab.textContent = ''; | |
| 136 self.tab.appendChild(searchField); | |
| 137 self.tab.onclick = self.tab.onkeypress = undefined; | |
| 138 | |
| 139 // Handle search events. (No need to throttle, WebKit's search field | |
| 140 // will do that automatically.) | |
| 141 searchField.onsearch = function(e) { | |
| 142 self.setSearchText_(SearchPage.canonicalizeQuery(this.value)); | |
| 143 }; | |
| 144 | |
| 145 // We update the history stack every time the search field blurs. This way | |
| 146 // we get a history entry for each search, roughly, but not each letter | |
| 147 // typed. | |
| 148 searchField.onblur = function(e) { | |
| 149 var query = SearchPage.canonicalizeQuery(searchField.value); | |
| 150 if (!query) | |
| 151 return; | |
| 152 | |
| 153 // Don't push the same page onto the history stack more than once (if | |
| 154 // the user clicks in the search field and away several times). | |
| 155 var currentHash = location.hash; | |
| 156 var newHash = '#' + escape(query); | |
| 157 if (currentHash == newHash) | |
| 158 return; | |
| 159 | |
| 160 // If there is no hash on the current URL, the history entry has no | |
| 161 // search query. Replace the history entry with no search with an entry | |
| 162 // that does have a search. Otherwise, add it onto the history stack. | |
| 163 var historyFunction = currentHash ? window.history.pushState : | |
| 164 window.history.replaceState; | |
| 165 historyFunction.call( | |
| 166 window.history, | |
| 167 {pageName: self.name}, | |
| 168 self.title, | |
| 169 '/' + self.name + newHash); | |
| 170 }; | |
| 171 | |
| 172 // Install handler for key presses. | |
| 173 document.addEventListener('keydown', | |
| 174 this.keyDownEventHandler_.bind(this)); | |
| 175 | |
| 176 // Focus the search field by default. | |
| 177 searchField.focus(); | |
| 178 }, | |
| 179 | |
| 180 /** | |
| 181 * @inheritDoc | |
| 182 */ | |
| 183 get sticky() { | |
| 184 return true; | |
| 185 }, | |
| 186 | |
| 187 /** | |
| 188 * Called after this page has shown. | |
| 189 */ | |
| 190 didShowPage: function() { | |
| 191 // This method is called by the Options page after all pages have | |
| 192 // had their visibilty attribute set. At this point we can perform the | |
| 193 // search specific DOM manipulation. | |
| 194 this.setSearchActive_(true); | |
| 195 }, | |
| 196 | |
| 197 /** | |
| 198 * Called before this page will be hidden. | |
| 199 */ | |
| 200 willHidePage: function() { | |
| 201 // This method is called by the Options page before all pages have | |
| 202 // their visibilty attribute set. Before that happens, we need to | |
| 203 // undo the search specific DOM manipulation that was performed in | |
| 204 // didShowPage. | |
| 205 this.setSearchActive_(false); | |
| 206 }, | |
| 207 | |
| 208 /** | |
| 209 * Update the UI to reflect whether we are in a search state. | |
| 210 * @param {boolean} active True if we are on the search page. | |
| 211 * @private | |
| 212 */ | |
| 213 setSearchActive_: function(active) { | |
| 214 // It's fine to exit if search wasn't active and we're not going to | |
| 215 // activate it now. | |
| 216 if (!this.searchActive_ && !active) | |
| 217 return; | |
| 218 | |
| 219 this.searchActive_ = active; | |
| 220 | |
| 221 if (active) { | |
| 222 var hash = location.hash; | |
| 223 if (hash) | |
| 224 this.searchField.value = unescape(hash.slice(1)); | |
| 225 } else { | |
| 226 // Just wipe out any active search text since it's no longer relevant. | |
| 227 this.searchField.value = ''; | |
| 228 } | |
| 229 | |
| 230 var pagesToSearch = this.getSearchablePages_(); | |
| 231 for (var key in pagesToSearch) { | |
| 232 var page = pagesToSearch[key]; | |
| 233 | |
| 234 if (!active) | |
| 235 page.visible = false; | |
| 236 | |
| 237 // Update the visible state of all top-level elements that are not | |
| 238 // sections (ie titles, button strips). We do this before changing | |
| 239 // the page visibility to avoid excessive re-draw. | |
| 240 for (var i = 0, childDiv; childDiv = page.pageDiv.children[i]; i++) { | |
| 241 if (active) { | |
| 242 if (childDiv.tagName != 'SECTION') | |
| 243 childDiv.classList.add('search-hidden'); | |
| 244 } else { | |
| 245 childDiv.classList.remove('search-hidden'); | |
| 246 } | |
| 247 } | |
| 248 | |
| 249 if (active) { | |
| 250 // When search is active, remove the 'hidden' tag. This tag may have | |
| 251 // been added by the OptionsPage. | |
| 252 page.pageDiv.classList.remove('hidden'); | |
| 253 } | |
| 254 } | |
| 255 | |
| 256 if (active) { | |
| 257 this.setSearchText_(this.searchField.value); | |
| 258 } else { | |
| 259 // After hiding all page content, remove any search results. | |
| 260 this.unhighlightMatches_(); | |
| 261 this.removeSearchBubbles_(); | |
| 262 } | |
| 263 }, | |
| 264 | |
| 265 /** | |
| 266 * Set the current search criteria. | |
| 267 * @param {string} text Search text. | |
| 268 * @private | |
| 269 */ | |
| 270 setSearchText_: function(text) { | |
| 271 // Toggle the search page if necessary. | |
| 272 if (text.length) { | |
| 273 if (!this.searchActive_) | |
| 274 OptionsPage.navigateToPage(this.name); | |
| 275 } else { | |
| 276 if (this.searchActive_) | |
| 277 OptionsPage.showDefaultPage(); | |
| 278 return; | |
| 279 } | |
| 280 | |
| 281 var foundMatches = false; | |
| 282 var bubbleControls = []; | |
| 283 | |
| 284 // Remove any prior search results. | |
| 285 this.unhighlightMatches_(); | |
| 286 this.removeSearchBubbles_(); | |
| 287 | |
| 288 // Generate search text by applying lowercase and escaping any characters | |
| 289 // that would be problematic for regular expressions. | |
| 290 var searchText = | |
| 291 text.toLowerCase().replace(/[-[\]{}()*+?.,\\^$|#\s]/g, '\\$&'); | |
| 292 | |
| 293 // Generate a regular expression and replace string for hilighting | |
| 294 // search terms. | |
| 295 var regEx = new RegExp('(' + searchText + ')', 'ig'); | |
| 296 var replaceString = '<span class="search-highlighted">$1</span>'; | |
| 297 | |
| 298 // Initialize all sections. If the search string matches a title page, | |
| 299 // show sections for that page. | |
| 300 var page, pageMatch, childDiv, length; | |
| 301 var pagesToSearch = this.getSearchablePages_(); | |
| 302 for (var key in pagesToSearch) { | |
| 303 page = pagesToSearch[key]; | |
| 304 pageMatch = false; | |
| 305 if (searchText.length) { | |
| 306 pageMatch = this.performReplace_(regEx, replaceString, page.tab); | |
| 307 } | |
| 308 if (pageMatch) | |
| 309 foundMatches = true; | |
| 310 for (var i = 0, childDiv; childDiv = page.pageDiv.children[i]; i++) { | |
| 311 if (childDiv.tagName == 'SECTION') { | |
| 312 if (pageMatch) { | |
| 313 childDiv.classList.remove('search-hidden'); | |
| 314 } else { | |
| 315 childDiv.classList.add('search-hidden'); | |
| 316 } | |
| 317 } | |
| 318 } | |
| 319 } | |
| 320 | |
| 321 if (searchText.length) { | |
| 322 // Search all top-level sections for anchored string matches. | |
| 323 for (var key in pagesToSearch) { | |
| 324 page = pagesToSearch[key]; | |
| 325 for (var i = 0, childDiv; childDiv = page.pageDiv.children[i]; i++) { | |
| 326 if (childDiv.tagName == 'SECTION' && | |
| 327 this.performReplace_(regEx, replaceString, childDiv)) { | |
| 328 childDiv.classList.remove('search-hidden'); | |
| 329 foundMatches = true; | |
| 330 } | |
| 331 } | |
| 332 } | |
| 333 | |
| 334 // Search all sub-pages, generating an array of top-level sections that | |
| 335 // we need to make visible. | |
| 336 var subPagesToSearch = this.getSearchableSubPages_(); | |
| 337 var control, node; | |
| 338 for (var key in subPagesToSearch) { | |
| 339 page = subPagesToSearch[key]; | |
| 340 if (this.performReplace_(regEx, replaceString, page.pageDiv)) { | |
| 341 // Reveal the section for this search result. | |
| 342 section = page.associatedSection; | |
| 343 if (section) | |
| 344 section.classList.remove('search-hidden'); | |
| 345 | |
| 346 // Identify any controls that should have bubbles. | |
| 347 var controls = page.associatedControls; | |
| 348 if (controls) { | |
| 349 length = controls.length; | |
| 350 for (var i = 0; i < length; i++) | |
| 351 bubbleControls.push(controls[i]); | |
| 352 } | |
| 353 | |
| 354 foundMatches = true; | |
| 355 } | |
| 356 } | |
| 357 } | |
| 358 | |
| 359 // Configure elements on the search results page based on search results. | |
| 360 if (foundMatches) | |
| 361 $('searchPageNoMatches').classList.add('search-hidden'); | |
| 362 else | |
| 363 $('searchPageNoMatches').classList.remove('search-hidden'); | |
| 364 | |
| 365 // Create search balloons for sub-page results. | |
| 366 length = bubbleControls.length; | |
| 367 for (var i = 0; i < length; i++) | |
| 368 this.createSearchBubble_(bubbleControls[i], text); | |
| 369 }, | |
| 370 | |
| 371 /** | |
| 372 * Performs a string replacement based on a regex and replace string. | |
| 373 * @param {RegEx} regex A regular expression for finding search matches. | |
| 374 * @param {String} replace A string to apply the replace operation. | |
| 375 * @param {Element} element An HTML container element. | |
| 376 * @returns {Boolean} true if the element was changed. | |
| 377 * @private | |
| 378 */ | |
| 379 performReplace_: function(regex, replace, element) { | |
| 380 var found = false; | |
| 381 var div, child, tmp; | |
| 382 | |
| 383 // Walk the tree, searching each TEXT node. | |
| 384 var walker = document.createTreeWalker(element, | |
| 385 NodeFilter.SHOW_TEXT, | |
| 386 null, | |
| 387 false); | |
| 388 var node = walker.nextNode(); | |
| 389 while (node) { | |
| 390 // Perform a search and replace on the text node value. | |
| 391 var newValue = node.nodeValue.replace(regex, replace); | |
| 392 if (newValue != node.nodeValue) { | |
| 393 // The text node has changed so that means we found at least one | |
| 394 // match. | |
| 395 found = true; | |
| 396 | |
| 397 // Create a temporary div element and set the innerHTML to the new | |
| 398 // value. | |
| 399 div = document.createElement('div'); | |
| 400 div.innerHTML = newValue; | |
| 401 | |
| 402 // Insert all the child nodes of the temporary div element into the | |
| 403 // document, before the original node. | |
| 404 child = div.firstChild; | |
| 405 while (child = div.firstChild) { | |
| 406 node.parentNode.insertBefore(child, node); | |
| 407 }; | |
| 408 | |
| 409 // Delete the old text node and advance the walker to the next | |
| 410 // node. | |
| 411 tmp = node; | |
| 412 node = walker.nextNode(); | |
| 413 tmp.parentNode.removeChild(tmp); | |
| 414 } else { | |
| 415 node = walker.nextNode(); | |
| 416 } | |
| 417 } | |
| 418 | |
| 419 return found; | |
| 420 }, | |
| 421 | |
| 422 /** | |
| 423 * Removes all search highlight tags from the document. | |
| 424 * @private | |
| 425 */ | |
| 426 unhighlightMatches_: function() { | |
| 427 // Find all search highlight elements. | |
| 428 var elements = document.querySelectorAll('.search-highlighted'); | |
| 429 | |
| 430 // For each element, remove the highlighting. | |
| 431 var parent, i; | |
| 432 for (var i = 0, node; node = elements[i]; i++) { | |
| 433 parent = node.parentNode; | |
| 434 | |
| 435 // Replace the highlight element with the first child (the text node). | |
| 436 parent.replaceChild(node.firstChild, node); | |
| 437 | |
| 438 // Normalize the parent so that multiple text nodes will be combined. | |
| 439 parent.normalize(); | |
| 440 } | |
| 441 }, | |
| 442 | |
| 443 /** | |
| 444 * Creates a search result bubble attached to an element. | |
| 445 * @param {Element} element An HTML element, usually a button. | |
| 446 * @param {string} text A string to show in the bubble. | |
| 447 * @private | |
| 448 */ | |
| 449 createSearchBubble_: function(element, text) { | |
| 450 // avoid appending multiple bubbles to a button. | |
| 451 var sibling = element.previousElementSibling; | |
| 452 if (sibling && (sibling.classList.contains('search-bubble') || | |
| 453 sibling.classList.contains('search-bubble-wrapper'))) | |
| 454 return; | |
| 455 | |
| 456 var parent = element.parentElement; | |
| 457 if (parent) { | |
| 458 var bubble = new SearchBubble(text); | |
| 459 bubble.attachTo(element); | |
| 460 bubble.updatePosition(); | |
| 461 } | |
| 462 }, | |
| 463 | |
| 464 /** | |
| 465 * Removes all search match bubbles. | |
| 466 * @private | |
| 467 */ | |
| 468 removeSearchBubbles_: function() { | |
| 469 var elements = document.querySelectorAll('.search-bubble'); | |
| 470 var length = elements.length; | |
| 471 for (var i = 0; i < length; i++) | |
| 472 elements[i].dispose(); | |
| 473 }, | |
| 474 | |
| 475 /** | |
| 476 * Builds a list of top-level pages to search. Omits the search page and | |
| 477 * all sub-pages. | |
| 478 * @returns {Array} An array of pages to search. | |
| 479 * @private | |
| 480 */ | |
| 481 getSearchablePages_: function() { | |
| 482 var name, page, pages = []; | |
| 483 for (name in OptionsPage.registeredPages) { | |
| 484 if (name != this.name) { | |
| 485 page = OptionsPage.registeredPages[name]; | |
| 486 if (!page.parentPage) | |
| 487 pages.push(page); | |
| 488 } | |
| 489 } | |
| 490 return pages; | |
| 491 }, | |
| 492 | |
| 493 /** | |
| 494 * Builds a list of sub-pages (and overlay pages) to search. Ignore pages | |
| 495 * that have no associated controls. | |
| 496 * @returns {Array} An array of pages to search. | |
| 497 * @private | |
| 498 */ | |
| 499 getSearchableSubPages_: function() { | |
| 500 var name, pageInfo, page, pages = []; | |
| 501 for (name in OptionsPage.registeredPages) { | |
| 502 page = OptionsPage.registeredPages[name]; | |
| 503 if (page.parentPage && page.associatedSection) | |
| 504 pages.push(page); | |
| 505 } | |
| 506 for (name in OptionsPage.registeredOverlayPages) { | |
| 507 page = OptionsPage.registeredOverlayPages[name]; | |
| 508 if (page.associatedSection && page.pageDiv != undefined) | |
| 509 pages.push(page); | |
| 510 } | |
| 511 return pages; | |
| 512 }, | |
| 513 | |
| 514 /** | |
| 515 * A function to handle key press events. | |
| 516 * @return {Event} a keydown event. | |
| 517 * @private | |
| 518 */ | |
| 519 keyDownEventHandler_: function(event) { | |
| 520 const ESCAPE_KEY_CODE = 27; | |
| 521 const FORWARD_SLASH_KEY_CODE = 191; | |
| 522 | |
| 523 switch(event.keyCode) { | |
| 524 case ESCAPE_KEY_CODE: | |
| 525 if (event.target == this.searchField) { | |
| 526 this.setSearchText_(''); | |
| 527 this.searchField.blur(); | |
| 528 event.stopPropagation(); | |
| 529 event.preventDefault(); | |
| 530 } | |
| 531 break; | |
| 532 case FORWARD_SLASH_KEY_CODE: | |
| 533 if (!/INPUT|SELECT|BUTTON|TEXTAREA/.test(event.target.tagName)) { | |
| 534 this.searchField.focus(); | |
| 535 event.stopPropagation(); | |
| 536 event.preventDefault(); | |
| 537 } | |
| 538 break; | |
| 539 } | |
| 540 }, | |
| 541 }; | |
| 542 | |
| 543 /** | |
| 544 * Standardizes a user-entered text query by removing extra whitespace. | |
| 545 * @param {string} The user-entered text. | |
| 546 * @return {string} The trimmed query. | |
| 547 */ | |
| 548 SearchPage.canonicalizeQuery = function(text) { | |
| 549 // Trim beginning and ending whitespace. | |
| 550 return text.replace(/^\s+|\s+$/g, ''); | |
| 551 }; | |
| 552 | |
| 553 // Export | |
| 554 return { | |
| 555 SearchPage: SearchPage | |
| 556 }; | |
| 557 | |
| 558 }); | |
| OLD | NEW |