Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(574)

Side by Side Diff: chrome/browser/resources/options/search_page.js

Issue 7003007: Apply content-security-policy to the HTML options page. This is a (Closed) Base URL: svn://svn.chromium.org/chrome/trunk/src/
Patch Set: '' Created 9 years, 7 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch | Annotate | Revision Log
OLDNEW
(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 });
OLDNEW

Powered by Google App Engine
This is Rietveld 408576698