| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957 |
- /* ***** BEGIN LICENSE BLOCK *****
- * Distributed under the BSD license:
- *
- * Copyright (c) 2010, Ajax.org B.V.
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions are met:
- * * Redistributions of source code must retain the above copyright
- * notice, this list of conditions and the following disclaimer.
- * * Redistributions in binary form must reproduce the above copyright
- * notice, this list of conditions and the following disclaimer in the
- * documentation and/or other materials provided with the distribution.
- * * Neither the name of Ajax.org B.V. nor the
- * names of its contributors may be used to endorse or promote products
- * derived from this software without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
- * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
- * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL AJAX.ORG B.V. BE LIABLE FOR ANY
- * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
- * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
- * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
- * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
- * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
- * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * ***** END LICENSE BLOCK ***** */
- define(function(require, exports, module) {
- "use strict";
- var oop = require("./lib/oop");
- var lang = require("./lib/lang");
- var EventEmitter = require("./lib/event_emitter").EventEmitter;
- var Range = require("./range").Range;
- /**
- * Contains the cursor position and the text selection of an edit session.
- *
- * The row/columns used in the selection are in document coordinates representing the coordinates as they appear in the document before applying soft wrap and folding.
- * @class Selection
- **/
- /**
- * Emitted when the cursor position changes.
- * @event changeCursor
- *
- **/
- /**
- * Emitted when the cursor selection changes.
- *
- * @event changeSelection
- **/
- /**
- * Creates a new `Selection` object.
- * @param {EditSession} session The session to use
- *
- * @constructor
- **/
- var Selection = function(session) {
- this.session = session;
- this.doc = session.getDocument();
- this.clearSelection();
- this.lead = this.selectionLead = this.doc.createAnchor(0, 0);
- this.anchor = this.selectionAnchor = this.doc.createAnchor(0, 0);
- var self = this;
- this.lead.on("change", function(e) {
- self._emit("changeCursor");
- if (!self.$isEmpty)
- self._emit("changeSelection");
- if (!self.$keepDesiredColumnOnChange && e.old.column != e.value.column)
- self.$desiredColumn = null;
- });
- this.selectionAnchor.on("change", function() {
- if (!self.$isEmpty)
- self._emit("changeSelection");
- });
- };
- (function() {
- oop.implement(this, EventEmitter);
- /**
- *
- * Returns `true` if the selection is empty.
- * @returns {Boolean}
- **/
- this.isEmpty = function() {
- return (this.$isEmpty || (
- this.anchor.row == this.lead.row &&
- this.anchor.column == this.lead.column
- ));
- };
- /**
- * Returns `true` if the selection is a multi-line.
- * @returns {Boolean}
- **/
- this.isMultiLine = function() {
- if (this.isEmpty()) {
- return false;
- }
- return this.getRange().isMultiLine();
- };
- /**
- * Returns an object containing the `row` and `column` current position of the cursor.
- * @returns {Object}
- **/
- this.getCursor = function() {
- return this.lead.getPosition();
- };
- /**
- * Sets the row and column position of the anchor. This function also emits the `'changeSelection'` event.
- * @param {Number} row The new row
- * @param {Number} column The new column
- *
- *
- **/
- this.setSelectionAnchor = function(row, column) {
- this.anchor.setPosition(row, column);
- if (this.$isEmpty) {
- this.$isEmpty = false;
- this._emit("changeSelection");
- }
- };
- /**
- * Returns an object containing the `row` and `column` of the calling selection anchor.
- *
- * @returns {Object}
- * @related Anchor.getPosition
- **/
- this.getSelectionAnchor = function() {
- if (this.$isEmpty)
- return this.getSelectionLead();
- else
- return this.anchor.getPosition();
- };
- /**
- *
- * Returns an object containing the `row` and `column` of the calling selection lead.
- * @returns {Object}
- **/
- this.getSelectionLead = function() {
- return this.lead.getPosition();
- };
- /**
- * Shifts the selection up (or down, if [[Selection.isBackwards `isBackwards()`]] is true) the given number of columns.
- * @param {Number} columns The number of columns to shift by
- *
- *
- *
- **/
- this.shiftSelection = function(columns) {
- if (this.$isEmpty) {
- this.moveCursorTo(this.lead.row, this.lead.column + columns);
- return;
- }
- var anchor = this.getSelectionAnchor();
- var lead = this.getSelectionLead();
- var isBackwards = this.isBackwards();
- if (!isBackwards || anchor.column !== 0)
- this.setSelectionAnchor(anchor.row, anchor.column + columns);
- if (isBackwards || lead.column !== 0) {
- this.$moveSelection(function() {
- this.moveCursorTo(lead.row, lead.column + columns);
- });
- }
- };
- /**
- * Returns `true` if the selection is going backwards in the document.
- * @returns {Boolean}
- **/
- this.isBackwards = function() {
- var anchor = this.anchor;
- var lead = this.lead;
- return (anchor.row > lead.row || (anchor.row == lead.row && anchor.column > lead.column));
- };
- /**
- * [Returns the [[Range]] for the selected text.]{: #Selection.getRange}
- * @returns {Range}
- **/
- this.getRange = function() {
- var anchor = this.anchor;
- var lead = this.lead;
- if (this.isEmpty())
- return Range.fromPoints(lead, lead);
- if (this.isBackwards()) {
- return Range.fromPoints(lead, anchor);
- }
- else {
- return Range.fromPoints(anchor, lead);
- }
- };
- /**
- * [Empties the selection (by de-selecting it). This function also emits the `'changeSelection'` event.]{: #Selection.clearSelection}
- **/
- this.clearSelection = function() {
- if (!this.$isEmpty) {
- this.$isEmpty = true;
- this._emit("changeSelection");
- }
- };
- /**
- * Selects all the text in the document.
- **/
- this.selectAll = function() {
- var lastRow = this.doc.getLength() - 1;
- this.setSelectionAnchor(0, 0);
- this.moveCursorTo(lastRow, this.doc.getLine(lastRow).length);
- };
- /**
- * Sets the selection to the provided range.
- * @param {Range} range The range of text to select
- * @param {Boolean} reverse Indicates if the range should go backwards (`true`) or not
- *
- *
- * @method setSelectionRange
- * @alias setRange
- **/
- this.setRange =
- this.setSelectionRange = function(range, reverse) {
- if (reverse) {
- this.setSelectionAnchor(range.end.row, range.end.column);
- this.selectTo(range.start.row, range.start.column);
- } else {
- this.setSelectionAnchor(range.start.row, range.start.column);
- this.selectTo(range.end.row, range.end.column);
- }
- if (this.getRange().isEmpty())
- this.$isEmpty = true;
- this.$desiredColumn = null;
- };
- this.$moveSelection = function(mover) {
- var lead = this.lead;
- if (this.$isEmpty)
- this.setSelectionAnchor(lead.row, lead.column);
- mover.call(this);
- };
- /**
- * Moves the selection cursor to the indicated row and column.
- * @param {Number} row The row to select to
- * @param {Number} column The column to select to
- *
- *
- *
- **/
- this.selectTo = function(row, column) {
- this.$moveSelection(function() {
- this.moveCursorTo(row, column);
- });
- };
- /**
- * Moves the selection cursor to the row and column indicated by `pos`.
- * @param {Object} pos An object containing the row and column
- *
- *
- *
- **/
- this.selectToPosition = function(pos) {
- this.$moveSelection(function() {
- this.moveCursorToPosition(pos);
- });
- };
- /**
- * Moves the selection cursor to the indicated row and column.
- * @param {Number} row The row to select to
- * @param {Number} column The column to select to
- *
- **/
- this.moveTo = function(row, column) {
- this.clearSelection();
- this.moveCursorTo(row, column);
- };
- /**
- * Moves the selection cursor to the row and column indicated by `pos`.
- * @param {Object} pos An object containing the row and column
- **/
- this.moveToPosition = function(pos) {
- this.clearSelection();
- this.moveCursorToPosition(pos);
- };
- /**
- *
- * Moves the selection up one row.
- **/
- this.selectUp = function() {
- this.$moveSelection(this.moveCursorUp);
- };
- /**
- *
- * Moves the selection down one row.
- **/
- this.selectDown = function() {
- this.$moveSelection(this.moveCursorDown);
- };
- /**
- *
- *
- * Moves the selection right one column.
- **/
- this.selectRight = function() {
- this.$moveSelection(this.moveCursorRight);
- };
- /**
- *
- * Moves the selection left one column.
- **/
- this.selectLeft = function() {
- this.$moveSelection(this.moveCursorLeft);
- };
- /**
- *
- * Moves the selection to the beginning of the current line.
- **/
- this.selectLineStart = function() {
- this.$moveSelection(this.moveCursorLineStart);
- };
- /**
- *
- * Moves the selection to the end of the current line.
- **/
- this.selectLineEnd = function() {
- this.$moveSelection(this.moveCursorLineEnd);
- };
- /**
- *
- * Moves the selection to the end of the file.
- **/
- this.selectFileEnd = function() {
- this.$moveSelection(this.moveCursorFileEnd);
- };
- /**
- *
- * Moves the selection to the start of the file.
- **/
- this.selectFileStart = function() {
- this.$moveSelection(this.moveCursorFileStart);
- };
- /**
- *
- * Moves the selection to the first word on the right.
- **/
- this.selectWordRight = function() {
- this.$moveSelection(this.moveCursorWordRight);
- };
- /**
- *
- * Moves the selection to the first word on the left.
- **/
- this.selectWordLeft = function() {
- this.$moveSelection(this.moveCursorWordLeft);
- };
- /**
- * Moves the selection to highlight the entire word.
- * @related EditSession.getWordRange
- **/
- this.getWordRange = function(row, column) {
- if (typeof column == "undefined") {
- var cursor = row || this.lead;
- row = cursor.row;
- column = cursor.column;
- }
- return this.session.getWordRange(row, column);
- };
- /**
- *
- * Selects an entire word boundary.
- **/
- this.selectWord = function() {
- this.setSelectionRange(this.getWordRange());
- };
- /**
- * Selects a word, including its right whitespace.
- * @related EditSession.getAWordRange
- **/
- this.selectAWord = function() {
- var cursor = this.getCursor();
- var range = this.session.getAWordRange(cursor.row, cursor.column);
- this.setSelectionRange(range);
- };
- this.getLineRange = function(row, excludeLastChar) {
- var rowStart = typeof row == "number" ? row : this.lead.row;
- var rowEnd;
- var foldLine = this.session.getFoldLine(rowStart);
- if (foldLine) {
- rowStart = foldLine.start.row;
- rowEnd = foldLine.end.row;
- } else {
- rowEnd = rowStart;
- }
- if (excludeLastChar === true)
- return new Range(rowStart, 0, rowEnd, this.session.getLine(rowEnd).length);
- else
- return new Range(rowStart, 0, rowEnd + 1, 0);
- };
- /**
- * Selects the entire line.
- **/
- this.selectLine = function() {
- this.setSelectionRange(this.getLineRange());
- };
- /**
- *
- * Moves the cursor up one row.
- **/
- this.moveCursorUp = function() {
- this.moveCursorBy(-1, 0);
- };
- /**
- *
- * Moves the cursor down one row.
- **/
- this.moveCursorDown = function() {
- this.moveCursorBy(1, 0);
- };
- /**
- *
- * Moves the cursor left one column.
- **/
- this.moveCursorLeft = function() {
- var cursor = this.lead.getPosition(),
- fold;
- if (fold = this.session.getFoldAt(cursor.row, cursor.column, -1)) {
- this.moveCursorTo(fold.start.row, fold.start.column);
- } else if (cursor.column === 0) {
- // cursor is a line (start
- if (cursor.row > 0) {
- this.moveCursorTo(cursor.row - 1, this.doc.getLine(cursor.row - 1).length);
- }
- }
- else {
- var tabSize = this.session.getTabSize();
- if (this.session.isTabStop(cursor) && this.doc.getLine(cursor.row).slice(cursor.column-tabSize, cursor.column).split(" ").length-1 == tabSize)
- this.moveCursorBy(0, -tabSize);
- else
- this.moveCursorBy(0, -1);
- }
- };
- /**
- *
- * Moves the cursor right one column.
- **/
- this.moveCursorRight = function() {
- var cursor = this.lead.getPosition(),
- fold;
- if (fold = this.session.getFoldAt(cursor.row, cursor.column, 1)) {
- this.moveCursorTo(fold.end.row, fold.end.column);
- }
- else if (this.lead.column == this.doc.getLine(this.lead.row).length) {
- if (this.lead.row < this.doc.getLength() - 1) {
- this.moveCursorTo(this.lead.row + 1, 0);
- }
- }
- else {
- var tabSize = this.session.getTabSize();
- var cursor = this.lead;
- if (this.session.isTabStop(cursor) && this.doc.getLine(cursor.row).slice(cursor.column, cursor.column+tabSize).split(" ").length-1 == tabSize)
- this.moveCursorBy(0, tabSize);
- else
- this.moveCursorBy(0, 1);
- }
- };
- /**
- *
- * Moves the cursor to the start of the line.
- **/
- this.moveCursorLineStart = function() {
- var row = this.lead.row;
- var column = this.lead.column;
- var screenRow = this.session.documentToScreenRow(row, column);
- // Determ the doc-position of the first character at the screen line.
- var firstColumnPosition = this.session.screenToDocumentPosition(screenRow, 0);
- // Determ the line
- var beforeCursor = this.session.getDisplayLine(
- row, null, firstColumnPosition.row,
- firstColumnPosition.column
- );
- var leadingSpace = beforeCursor.match(/^\s*/);
- // TODO find better way for emacs mode to override selection behaviors
- if (leadingSpace[0].length != column && !this.session.$useEmacsStyleLineStart)
- firstColumnPosition.column += leadingSpace[0].length;
- this.moveCursorToPosition(firstColumnPosition);
- };
- /**
- *
- * Moves the cursor to the end of the line.
- **/
- this.moveCursorLineEnd = function() {
- var lead = this.lead;
- var lineEnd = this.session.getDocumentLastRowColumnPosition(lead.row, lead.column);
- if (this.lead.column == lineEnd.column) {
- var line = this.session.getLine(lineEnd.row);
- if (lineEnd.column == line.length) {
- var textEnd = line.search(/\s+$/);
- if (textEnd > 0)
- lineEnd.column = textEnd;
- }
- }
- this.moveCursorTo(lineEnd.row, lineEnd.column);
- };
- /**
- *
- * Moves the cursor to the end of the file.
- **/
- this.moveCursorFileEnd = function() {
- var row = this.doc.getLength() - 1;
- var column = this.doc.getLine(row).length;
- this.moveCursorTo(row, column);
- };
- /**
- *
- * Moves the cursor to the start of the file.
- **/
- this.moveCursorFileStart = function() {
- this.moveCursorTo(0, 0);
- };
- /**
- *
- * Moves the cursor to the word on the right.
- **/
- this.moveCursorLongWordRight = function() {
- var row = this.lead.row;
- var column = this.lead.column;
- var line = this.doc.getLine(row);
- var rightOfCursor = line.substring(column);
- var match;
- this.session.nonTokenRe.lastIndex = 0;
- this.session.tokenRe.lastIndex = 0;
- // skip folds
- var fold = this.session.getFoldAt(row, column, 1);
- if (fold) {
- this.moveCursorTo(fold.end.row, fold.end.column);
- return;
- }
- // first skip space
- if (match = this.session.nonTokenRe.exec(rightOfCursor)) {
- column += this.session.nonTokenRe.lastIndex;
- this.session.nonTokenRe.lastIndex = 0;
- rightOfCursor = line.substring(column);
- }
- // if at line end proceed with next line
- if (column >= line.length) {
- this.moveCursorTo(row, line.length);
- this.moveCursorRight();
- if (row < this.doc.getLength() - 1)
- this.moveCursorWordRight();
- return;
- }
- // advance to the end of the next token
- if (match = this.session.tokenRe.exec(rightOfCursor)) {
- column += this.session.tokenRe.lastIndex;
- this.session.tokenRe.lastIndex = 0;
- }
- this.moveCursorTo(row, column);
- };
- /**
- *
- * Moves the cursor to the word on the left.
- **/
- this.moveCursorLongWordLeft = function() {
- var row = this.lead.row;
- var column = this.lead.column;
- // skip folds
- var fold;
- if (fold = this.session.getFoldAt(row, column, -1)) {
- this.moveCursorTo(fold.start.row, fold.start.column);
- return;
- }
- var str = this.session.getFoldStringAt(row, column, -1);
- if (str == null) {
- str = this.doc.getLine(row).substring(0, column);
- }
- var leftOfCursor = lang.stringReverse(str);
- var match;
- this.session.nonTokenRe.lastIndex = 0;
- this.session.tokenRe.lastIndex = 0;
- // skip whitespace
- if (match = this.session.nonTokenRe.exec(leftOfCursor)) {
- column -= this.session.nonTokenRe.lastIndex;
- leftOfCursor = leftOfCursor.slice(this.session.nonTokenRe.lastIndex);
- this.session.nonTokenRe.lastIndex = 0;
- }
- // if at begin of the line proceed in line above
- if (column <= 0) {
- this.moveCursorTo(row, 0);
- this.moveCursorLeft();
- if (row > 0)
- this.moveCursorWordLeft();
- return;
- }
- // move to the begin of the word
- if (match = this.session.tokenRe.exec(leftOfCursor)) {
- column -= this.session.tokenRe.lastIndex;
- this.session.tokenRe.lastIndex = 0;
- }
- this.moveCursorTo(row, column);
- };
- this.$shortWordEndIndex = function(rightOfCursor) {
- var match, index = 0, ch;
- var whitespaceRe = /\s/;
- var tokenRe = this.session.tokenRe;
- tokenRe.lastIndex = 0;
- if (match = this.session.tokenRe.exec(rightOfCursor)) {
- index = this.session.tokenRe.lastIndex;
- } else {
- while ((ch = rightOfCursor[index]) && whitespaceRe.test(ch))
- index ++;
- if (index < 1) {
- tokenRe.lastIndex = 0;
- while ((ch = rightOfCursor[index]) && !tokenRe.test(ch)) {
- tokenRe.lastIndex = 0;
- index ++;
- if (whitespaceRe.test(ch)) {
- if (index > 2) {
- index--;
- break;
- } else {
- while ((ch = rightOfCursor[index]) && whitespaceRe.test(ch))
- index ++;
- if (index > 2)
- break;
- }
- }
- }
- }
- }
- tokenRe.lastIndex = 0;
- return index;
- };
- this.moveCursorShortWordRight = function() {
- var row = this.lead.row;
- var column = this.lead.column;
- var line = this.doc.getLine(row);
- var rightOfCursor = line.substring(column);
- var fold = this.session.getFoldAt(row, column, 1);
- if (fold)
- return this.moveCursorTo(fold.end.row, fold.end.column);
- if (column == line.length) {
- var l = this.doc.getLength();
- do {
- row++;
- rightOfCursor = this.doc.getLine(row);
- } while (row < l && /^\s*$/.test(rightOfCursor));
- if (!/^\s+/.test(rightOfCursor))
- rightOfCursor = "";
- column = 0;
- }
- var index = this.$shortWordEndIndex(rightOfCursor);
- this.moveCursorTo(row, column + index);
- };
- this.moveCursorShortWordLeft = function() {
- var row = this.lead.row;
- var column = this.lead.column;
- var fold;
- if (fold = this.session.getFoldAt(row, column, -1))
- return this.moveCursorTo(fold.start.row, fold.start.column);
- var line = this.session.getLine(row).substring(0, column);
- if (column === 0) {
- do {
- row--;
- line = this.doc.getLine(row);
- } while (row > 0 && /^\s*$/.test(line));
- column = line.length;
- if (!/\s+$/.test(line))
- line = "";
- }
- var leftOfCursor = lang.stringReverse(line);
- var index = this.$shortWordEndIndex(leftOfCursor);
- return this.moveCursorTo(row, column - index);
- };
- this.moveCursorWordRight = function() {
- if (this.session.$selectLongWords)
- this.moveCursorLongWordRight();
- else
- this.moveCursorShortWordRight();
- };
- this.moveCursorWordLeft = function() {
- if (this.session.$selectLongWords)
- this.moveCursorLongWordLeft();
- else
- this.moveCursorShortWordLeft();
- };
- /**
- * Moves the cursor to position indicated by the parameters. Negative numbers move the cursor backwards in the document.
- * @param {Number} rows The number of rows to move by
- * @param {Number} chars The number of characters to move by
- *
- *
- * @related EditSession.documentToScreenPosition
- **/
- this.moveCursorBy = function(rows, chars) {
- var screenPos = this.session.documentToScreenPosition(
- this.lead.row,
- this.lead.column
- );
- if (chars === 0) {
- if (this.$desiredColumn)
- screenPos.column = this.$desiredColumn;
- else
- this.$desiredColumn = screenPos.column;
- }
- var docPos = this.session.screenToDocumentPosition(screenPos.row + rows, screenPos.column);
-
- if (rows !== 0 && chars === 0 && docPos.row === this.lead.row && docPos.column === this.lead.column) {
- if (this.session.lineWidgets && this.session.lineWidgets[docPos.row]) {
- if (docPos.row > 0 || rows > 0)
- docPos.row++;
- }
- }
- // move the cursor and update the desired column
- this.moveCursorTo(docPos.row, docPos.column + chars, chars === 0);
- };
- /**
- * Moves the selection to the position indicated by its `row` and `column`.
- * @param {Object} position The position to move to
- *
- *
- **/
- this.moveCursorToPosition = function(position) {
- this.moveCursorTo(position.row, position.column);
- };
- /**
- * Moves the cursor to the row and column provided. [If `preventUpdateDesiredColumn` is `true`, then the cursor stays in the same column position as its original point.]{: #preventUpdateBoolDesc}
- * @param {Number} row The row to move to
- * @param {Number} column The column to move to
- * @param {Boolean} keepDesiredColumn [If `true`, the cursor move does not respect the previous column]{: #preventUpdateBool}
- *
- *
- **/
- this.moveCursorTo = function(row, column, keepDesiredColumn) {
- // Ensure the row/column is not inside of a fold.
- var fold = this.session.getFoldAt(row, column, 1);
- if (fold) {
- row = fold.start.row;
- column = fold.start.column;
- }
- this.$keepDesiredColumnOnChange = true;
- this.lead.setPosition(row, column);
- this.$keepDesiredColumnOnChange = false;
- if (!keepDesiredColumn)
- this.$desiredColumn = null;
- };
- /**
- * Moves the cursor to the screen position indicated by row and column. {:preventUpdateBoolDesc}
- * @param {Number} row The row to move to
- * @param {Number} column The column to move to
- * @param {Boolean} keepDesiredColumn {:preventUpdateBool}
- *
- *
- **/
- this.moveCursorToScreen = function(row, column, keepDesiredColumn) {
- var pos = this.session.screenToDocumentPosition(row, column);
- this.moveCursorTo(pos.row, pos.column, keepDesiredColumn);
- };
- // remove listeners from document
- this.detach = function() {
- this.lead.detach();
- this.anchor.detach();
- this.session = this.doc = null;
- };
- this.fromOrientedRange = function(range) {
- this.setSelectionRange(range, range.cursor == range.start);
- this.$desiredColumn = range.desiredColumn || this.$desiredColumn;
- };
- this.toOrientedRange = function(range) {
- var r = this.getRange();
- if (range) {
- range.start.column = r.start.column;
- range.start.row = r.start.row;
- range.end.column = r.end.column;
- range.end.row = r.end.row;
- } else {
- range = r;
- }
- range.cursor = this.isBackwards() ? range.start : range.end;
- range.desiredColumn = this.$desiredColumn;
- return range;
- };
- /**
- * Saves the current cursor position and calls `func` that can change the cursor
- * postion. The result is the range of the starting and eventual cursor position.
- * Will reset the cursor position.
- * @param {Function} The callback that should change the cursor position
- * @returns {Range}
- *
- **/
- this.getRangeOfMovements = function(func) {
- var start = this.getCursor();
- try {
- func.call(null, this);
- var end = this.getCursor();
- return Range.fromPoints(start,end);
- } catch(e) {
- return Range.fromPoints(start,start);
- } finally {
- this.moveCursorToPosition(start);
- }
- };
- this.toJSON = function() {
- if (this.rangeCount) {
- var data = this.ranges.map(function(r) {
- var r1 = r.clone();
- r1.isBackwards = r.cursor == r.start;
- return r1;
- });
- } else {
- var data = this.getRange();
- data.isBackwards = this.isBackwards();
- }
- return data;
- };
- this.fromJSON = function(data) {
- if (data.start == undefined) {
- if (this.rangeList) {
- this.toSingleRange(data[0]);
- for (var i = data.length; i--; ) {
- var r = Range.fromPoints(data[i].start, data[i].end);
- if (data[i].isBackwards)
- r.cursor = r.start;
- this.addRange(r, true);
- }
- return;
- } else
- data = data[0];
- }
- if (this.rangeList)
- this.toSingleRange(data);
- this.setSelectionRange(data, data.isBackwards);
- };
- this.isEqual = function(data) {
- if ((data.length || this.rangeCount) && data.length != this.rangeCount)
- return false;
- if (!data.length || !this.ranges)
- return this.getRange().isEqual(data);
- for (var i = this.ranges.length; i--; ) {
- if (!this.ranges[i].isEqual(data[i]))
- return false;
- }
- return true;
- };
- }).call(Selection.prototype);
- exports.Selection = Selection;
- });
|