OLD | NEW |
1 // Copyright 2014 The Chromium Authors. All rights reserved. | 1 // Copyright 2014 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 | 5 |
6 /** | 6 /** |
7 * @fileoverview A DOM traversal interface for moving a selection around a | 7 * @fileoverview A DOM traversal interface for moving a selection around a |
8 * webpage. Provides multiple granularities: | 8 * webpage. Provides multiple granularities: |
9 * 1. Move by paragraph. | 9 * 1. Move by paragraph. |
10 * 2. Move by sentence. | 10 * 2. Move by sentence. |
(...skipping 100 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
111 * @type {string} | 111 * @type {string} |
112 * @const | 112 * @const |
113 */ | 113 */ |
114 cvox.TraverseContent.kParagraph = 'paragraph'; | 114 cvox.TraverseContent.kParagraph = 'paragraph'; |
115 | 115 |
116 /** | 116 /** |
117 * A constant array of all granularities. | 117 * A constant array of all granularities. |
118 * @type {Array<string>} | 118 * @type {Array<string>} |
119 * @const | 119 * @const |
120 */ | 120 */ |
121 cvox.TraverseContent.kAllGrains = | 121 cvox.TraverseContent.kAllGrains = [ |
122 [cvox.TraverseContent.kParagraph, | 122 cvox.TraverseContent.kParagraph, cvox.TraverseContent.kSentence, |
123 cvox.TraverseContent.kSentence, | 123 cvox.TraverseContent.kLine, cvox.TraverseContent.kWord, |
124 cvox.TraverseContent.kLine, | 124 cvox.TraverseContent.kCharacter |
125 cvox.TraverseContent.kWord, | 125 ]; |
126 cvox.TraverseContent.kCharacter]; | |
127 | 126 |
128 /** | 127 /** |
129 * Set the current position to match the current WebKit selection. | 128 * Set the current position to match the current WebKit selection. |
130 */ | 129 */ |
131 cvox.TraverseContent.prototype.syncToSelection = function() { | 130 cvox.TraverseContent.prototype.syncToSelection = function() { |
132 this.normalizeSelection(); | 131 this.normalizeSelection(); |
133 | 132 |
134 var selection = window.getSelection(); | 133 var selection = window.getSelection(); |
135 if (!selection || !selection.anchorNode || !selection.focusNode) { | 134 if (!selection || !selection.anchorNode || !selection.focusNode) { |
136 return; | 135 return; |
(...skipping 239 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
376 | 375 |
377 /** | 376 /** |
378 * Get the tag names that should break a sentence or line. Currently | 377 * Get the tag names that should break a sentence or line. Currently |
379 * just an anchor 'A' should break a sentence or line if the breakAtLinks | 378 * just an anchor 'A' should break a sentence or line if the breakAtLinks |
380 * flag is true, but in the future we might have other rules for breaking. | 379 * flag is true, but in the future we might have other rules for breaking. |
381 * | 380 * |
382 * @return {Object} An associative array mapping a tag name to true if | 381 * @return {Object} An associative array mapping a tag name to true if |
383 * it should break a sentence or line. | 382 * it should break a sentence or line. |
384 */ | 383 */ |
385 cvox.TraverseContent.prototype.getBreakTags = function() { | 384 cvox.TraverseContent.prototype.getBreakTags = function() { |
386 return { | 385 return {'A': this.breakAtLinks, 'BR': true, 'HR': true}; |
387 'A': this.breakAtLinks, | |
388 'BR': true, | |
389 'HR': true | |
390 }; | |
391 }; | 386 }; |
392 | 387 |
393 /** | 388 /** |
394 * Selects the next element of the document or within the provided DOM object. | 389 * Selects the next element of the document or within the provided DOM object. |
395 * Scrolls the window as appropriate. | 390 * Scrolls the window as appropriate. |
396 * | 391 * |
397 * @param {string} grain specifies "sentence", "word", "character", | 392 * @param {string} grain specifies "sentence", "word", "character", |
398 * or "paragraph" granularity. | 393 * or "paragraph" granularity. |
399 * @param {Node=} domObj a DOM node (optional). | 394 * @param {Node=} domObj a DOM node (optional). |
400 * @return {?string} Either: | 395 * @return {?string} Either: |
401 * 1) The new selected text. | 396 * 1) The new selected text. |
402 * 2) null if the end of the domObj has been reached. | 397 * 2) null if the end of the domObj has been reached. |
403 */ | 398 */ |
404 cvox.TraverseContent.prototype.nextElement = function(grain, domObj) { | 399 cvox.TraverseContent.prototype.nextElement = function(grain, domObj) { |
405 if (domObj != null) { | 400 if (domObj != null) { |
406 this.currentDomObj = domObj; | 401 this.currentDomObj = domObj; |
407 } | 402 } |
408 | 403 |
409 var result = this.moveNext(grain); | 404 var result = this.moveNext(grain); |
410 if (result != null && | 405 if (result != null && |
411 (!cvox.DomUtil.isDescendantOfNode( | 406 (!cvox.DomUtil.isDescendantOfNode( |
412 this.startCursor_.node, this.currentDomObj) || | 407 this.startCursor_.node, this.currentDomObj) || |
413 !cvox.DomUtil.isDescendantOfNode( | 408 !cvox.DomUtil.isDescendantOfNode( |
414 this.endCursor_.node, this.currentDomObj))) { | 409 this.endCursor_.node, this.currentDomObj))) { |
415 return null; | 410 return null; |
416 } | 411 } |
417 | 412 |
418 return result; | 413 return result; |
419 }; | 414 }; |
420 | 415 |
421 | 416 |
422 /** | 417 /** |
423 * Selects the previous element of the document or within the provided DOM | 418 * Selects the previous element of the document or within the provided DOM |
424 * object. Scrolls the window as appropriate. | 419 * object. Scrolls the window as appropriate. |
425 * | 420 * |
426 * @param {string} grain specifies "sentence", "word", "character", | 421 * @param {string} grain specifies "sentence", "word", "character", |
427 * or "paragraph" granularity. | 422 * or "paragraph" granularity. |
428 * @param {Node=} domObj a DOM node (optional). | 423 * @param {Node=} domObj a DOM node (optional). |
429 * @return {?string} Either: | 424 * @return {?string} Either: |
430 * 1) The new selected text. | 425 * 1) The new selected text. |
431 * 2) null if the beginning of the domObj has been reached. | 426 * 2) null if the beginning of the domObj has been reached. |
432 */ | 427 */ |
433 cvox.TraverseContent.prototype.prevElement = function(grain, domObj) { | 428 cvox.TraverseContent.prototype.prevElement = function(grain, domObj) { |
434 if (domObj != null) { | 429 if (domObj != null) { |
435 this.currentDomObj = domObj; | 430 this.currentDomObj = domObj; |
436 } | 431 } |
437 | 432 |
438 var result = this.movePrev(grain); | 433 var result = this.movePrev(grain); |
439 if (result != null && | 434 if (result != null && |
440 (!cvox.DomUtil.isDescendantOfNode( | 435 (!cvox.DomUtil.isDescendantOfNode( |
441 this.startCursor_.node, this.currentDomObj) || | 436 this.startCursor_.node, this.currentDomObj) || |
442 !cvox.DomUtil.isDescendantOfNode( | 437 !cvox.DomUtil.isDescendantOfNode( |
443 this.endCursor_.node, this.currentDomObj))) { | 438 this.endCursor_.node, this.currentDomObj))) { |
444 return null; | 439 return null; |
445 } | 440 } |
446 | 441 |
447 return result; | 442 return result; |
448 }; | 443 }; |
449 | 444 |
450 /** | 445 /** |
451 * Make sure that exactly one item is selected. If there's no selection, | 446 * Make sure that exactly one item is selected. If there's no selection, |
(...skipping 21 matching lines...) Expand all Loading... |
473 | 468 |
474 /** | 469 /** |
475 * Resets the selection. | 470 * Resets the selection. |
476 * | 471 * |
477 * @param {Node=} domObj a DOM node. Optional. | 472 * @param {Node=} domObj a DOM node. Optional. |
478 * | 473 * |
479 */ | 474 */ |
480 cvox.TraverseContent.prototype.reset = function(domObj) { | 475 cvox.TraverseContent.prototype.reset = function(domObj) { |
481 window.getSelection().removeAllRanges(); | 476 window.getSelection().removeAllRanges(); |
482 }; | 477 }; |
OLD | NEW |