Stores all the data about [[Editor Editor]] state providing easy way to change editors state.

EditSession can be attached to only one [[Document Document]]. Same Document can be attached to several EditSessions.

Constructors

Properties

Methods

$clipColumnToRow $clipPositionToDocument $clipRangeToDocument $clipRowToDocument $computeWidth $computeWrapSplits $constrainWrapLimit $detectNewLine $getDisplayTokens $getRowCacheIndex $getStringScreenWidth $getUndoSelection $moveLines $onChangeMode $resetRowCache $setFontMetrics $startWorker $stopWorker $updateInternalDataOnChange $updateRowLengthCache $updateWrapData addDynamicMarker addGutterDecoration addMarker adjustWrapLimit clearAnnotations clearBreakpoint clearBreakpoints destroy documentToScreenColumn documentToScreenPosition documentToScreenRow duplicateLines getAWordRange getAnnotations getBreakpoints getDocument getDocumentLastRowColumn getDocumentLastRowColumnPosition getLength getLine getLineWidgetMaxWidth getLines getMarkers getMode getNavigateWithinSoftTabs getNewLineMode getOverwrite getPrecedingCharacter getRowLength getRowLineCount getRowSplitData getRowWrapIndent getScreenLastRowColumn getScreenLength getScreenTabSize getScreenWidth getScrollLeft getScrollTop getSelection getState getTabSize getTabString getTextRange getTokenAt getTokens getUndoManager getUseSoftTabs getUseWorker getUseWrapMode getWordRange getWrapLimit getWrapLimitRange highlight highlightLines indentRows insert isTabStop markUndoGroup moveLinesDown moveLinesUp moveText onChange onChangeFold onReloadTokenizer outdentRows redoChanges remove removeFullLines removeGutterDecoration removeMarker replace resetCaches screenToDocumentColumn screenToDocumentPosition screenToDocumentRow setAnnotations setBreakpoint setBreakpoints setDocument setMode setNavigateWithinSoftTabs setNewLineMode setOverwrite setScrollLeft setScrollTop setTabSize setUndoManager setUndoSelect setUseSoftTabs setUseWorker setUseWrapMode setValue setWrapLimit setWrapLimitRange toJSON toString toggleOverwrite undoChanges fromJSON

Constructors

  • Sets up a new EditSession and associates it with the given Document and Mode.

    Parameters

    • Optional text: string | Document

      [If text is a Document, it associates the EditSession with it. Otherwise, a new Document is created, with the initial text]{: #textParam}

    • Optional mode: SyntaxMode

      [The initial language mode to use for the document]{: #modeParam}

    Returns EditSession

Properties

$annotations: Annotation[]
$autoNewLine: string
$backMarkers: {}

Type declaration

    $bidiHandler: BidiHandler
    $breakpoints: any[]
    $decorations: any[]
    $defaultUndoManager: {
        add: (() => void);
        addSelection: (() => void);
        addSession: (() => void);
        hasRedo: (() => void);
        hasUndo: (() => void);
        redo: (() => void);
        reset: (() => void);
        startNewGroup: (() => void);
        undo: (() => void);
    }

    Type declaration

    • add: (() => void)
        • (): void
        • Returns void

    • addSelection: (() => void)
        • (): void
        • Returns void

    • addSession: (() => void)
        • (): void
        • Returns void

    • hasRedo: (() => void)
        • (): void
        • Returns void

    • hasUndo: (() => void)
        • (): void
        • Returns void

    • redo: (() => void)
        • (): void
        • Returns void

    • reset: (() => void)
        • (): void
        • Returns void

    • startNewGroup: (() => void)
        • (): void
        • Returns void

    • undo: (() => void)
        • (): void
        • Returns void

    $docRowCache: number[]
    $foldData: FoldLine[]
    $fromUndo: boolean
    $frontMarkers: {}

    Type declaration

      $informUndoManager: {
          schedule: { (timeout: any): void; delay(timeout: any): void; schedule: ...; call(): void; cancel(): void; isPending(): any; };
          call(): void;
          cancel(): void;
          delay(timeout): void;
          isPending(): any;
          (timeout): void;
      }

      Type declaration

        • (timeout): void
        • Parameters

          • timeout: any

          Returns void

      • schedule: { (timeout: any): void; delay(timeout: any): void; schedule: ...; call(): void; cancel(): void; isPending(): any; }
      • call:function
      • cancel:function
      • delay:function
      • isPending:function
      $markerId: number
      $mode: any
      $modeId: any
      $modes: {}

      Type declaration

        $modified: boolean
        $onChange: any
        $overwrite: boolean
        $rowLengthCache: any[]
        $screenRowCache: number[]
        $scrollLeft: any
        $scrollTop: any
        $searchHighlight: MarkerLike
        $syncInformUndoManager: (() => void) | (() => void)

        Type declaration

          • (): void
          • Returns void

        Type declaration

          • (): void
          • Returns void

        $undoManager: UndoManager
        $undoSelect: boolean
        $updating: boolean
        $useWrapMode: any
        $worker: any
        $wrapData: any[]
        $wrapLimit: any
        $wrapLimitRange: any
        bgTokenizer: BackgroundTokenizer
        destroyed: boolean
        doc: Document
        getValue: (() => string)

        Returns the current [[Document Document]] as a string.

        Type declaration

          • (): string
          • Returns the current [[Document Document]] as a string.

            Returns string

            Method

            getValue

            Alias

            EditSession.toString

        Method

        getValue

        Returns

        Alias

        EditSession.toString

        id: string
        isFullWidth: ((c) => boolean)

        Type declaration

          • (c): boolean
          • Parameters

            • c: any

            Returns boolean

        lineWidgetWidth: number
        lineWidgets: LineWidget[]
        mergeUndoDeltas: boolean
        nonTokenRe: RegExp
        screenWidth: any
        selection: Selection
        tokenRe: RegExp
        $uid: number

        Methods

        • Parameters

          • row: number
          • column: number

          Returns number

        • Parameters

          • row: number
          • column: number

          Returns Point

        • Parameters

          • tokens: number[]
          • wrapLimit: number
          • tabSize: number

          Returns any[]

        • Parameters

          • wrapLimit: number
          • Optional min: number
          • Optional max: number

          Returns number

        • If text contains either the newline (\n) or carriage-return ('\r') characters, $autoNewLine stores that value.

          Parameters

          • text: string

            A block of text

          Returns void

        • Given a string, returns an array of the display characters, including tabs and spaces.

          Parameters

          • str: string

            The string to check

          • Optional offset: number

            The value to start at

          Returns number[]

        • Parameters

          • cacheArray: any
          • val: any

          Returns number

        • Calculates the width of the string str on the screen while assuming that the string starts at the first column on the screen.

          Parameters

          • str: string

            The string to calculate the screen width of

          • Optional maxScreenColumn: number
          • Optional screenColumn: number

          Returns number[]

          Returns an int[] array with two elements:
          The first position indicates the number of columns for str on screen.
          The second value contains the position of the document column that this function read until.

        • Parameters

          • deltas: Delta[]
          • Optional isUndo: boolean

          Returns Range

        • Parameters

          • firstRow: number
          • lastRow: number
          • Optional dir: any

          Returns number

        • Parameters

          • mode: any
          • Optional $isPlaceholder: any

          Returns void

        • Parameters

          • docRow: number

            The row to work with

          Returns void

        • Parameters

          • firstRow: number
          • lastRow: number

          Returns void

        • Parameters

          • firstRow: number
          • lastRow: number

          Returns void

        • Adds a dynamic marker to the session.

          Parameters

          • marker: MarkerLike

            object with update method

          • Optional inFront: boolean

            Set to true to establish a front marker

          Returns MarkerLike

          The added marker

        • Adds className to the row, to be used for CSS stylings and whatnot.

          Parameters

          • row: number

            The row number

          • className: string

            The class to add

          Returns void

        • Adds a new marker to the given Range. If inFront is true, a front marker is defined, and the 'changeFrontMarker' event fires; otherwise, the 'changeBackMarker' event fires.

          Parameters

          • range: Range

            Define the range of the marker

          • clazz: string

            Set the CSS class for the marker

          • Optional type: "line" | "text" | MarkerRenderer | "fullLine" | "screenLine"

            Identify the renderer type of the marker. If string provided, corresponding built-in renderer is used. Supported string types are "fullLine", "screenLine", "text" or "line". If a Function is provided, that Function is used as renderer.

          • Optional inFront: boolean

            Set to true to establish a front marker

          Returns number

          The new marker id

        • This should generally only be called by the renderer when a resize is detected.

          Parameters

          • desiredLimit: number

            The new wrap limit

          • Optional $printMargin: any

          Returns boolean

        • Clears all the annotations for this session. This function also triggers the 'changeAnnotation' event.

          Returns void

        • Removes a breakpoint on the row number given by row. This function also emits the 'changeBreakpoint' event.

          Parameters

          • row: number

            A row index

          Returns void

        • Removes all breakpoints on the rows. This function also emits the 'changeBreakpoint' event.

          Returns void

        • For the given document row and column, returns the screen column.

          Parameters

          • row: number | Point
          • Optional docColumn: number

          Returns number

        • Converts document coordinates to screen coordinates. {:conversionConsiderations}

          Parameters

          • docRow: number | Point

            The document row to check

          • Optional docColumn: number

            The document column to check

          Returns Point

          The object returned by this method has two properties: row and column.

          Related

          EditSession.screenToDocumentPosition

        • For the given document row and column, returns the screen row.

          Parameters

          • docRow: number | Point
          • Optional docColumn: number

          Returns number

        • Duplicates all the text between firstRow and lastRow.

          Parameters

          • firstRow: number

            The starting row to duplicate

          • lastRow: number

            The final row to duplicate

          Returns number

          Returns the number of new rows added; in other words, lastRow - firstRow + 1.

        • Gets the range of a word, including its right whitespace.

          Parameters

          • row: number

            The row number to start from

          • column: number

            The column number to start from

          Returns Range

        • Returns the annotations for the EditSession.

          Returns Annotation[]

        • Returns an array of strings, indicating the breakpoint class (if any) applied to each row.

          Returns string[]

        • Returns the Document associated with this session.

          Returns Document

        • For the given document row and column, this returns the column position of the last screen row.

          Parameters

          • docRow: number
          • docColumn: number

          Returns number

        • For the given document row and column, this returns the document position of the last row.

          Parameters

          • docRow: number
          • docColumn: number

          Returns Point

        • Returns a verbatim copy of the given line as it is in the document

          Parameters

          • row: number

            The row to retrieve from

          Returns string

        • Returns an array of strings of the rows between firstRow and lastRow. This function is inclusive of lastRow.

          Parameters

          • firstRow: number

            The first row index to retrieve

          • lastRow: number

            The final row index to retrieve

          Returns string[]

        • Returns an object containing all of the markers, either front or back.

          Parameters

          • Optional inFront: boolean

            If true, indicates you only want front markers; false indicates only back markers

          Returns {
              [id: number]: Ace.MarkerLike;
          }

          • [id: number]: Ace.MarkerLike
        • Returns the current text mode.

          Returns SyntaxMode

          The current text mode

        • Returns true if keyboard navigation moves the cursor within soft tabs, false if it moves the cursor over soft tabs.

          Returns boolean

        • Returns the current new line mode.

          Returns NewLineMode

          Related

          Document.getNewLineMode

        • Returns true if overwrites are enabled; false otherwise.

          Returns boolean

        • Returns string

          the last character preceding the cursor in the editor

        • Returns number of screenrows in a wrapped line.

          Parameters

          • row: number

            The row number to check

          Returns number

        • For the given row, this returns the split data.

          Parameters

          • row: number

          Returns string

        • Returns the position (on screen) for the last character in the provided screen row.

          Parameters

          • screenRow: number

            The screen row to check

          Returns number

          Related

          EditSession.documentToScreenColumn

        • The distance to the next tab stop at the specified screen column.

          Parameters

          • screenColumn: number

            The screen column to check

          Returns number

        • [Returns the value of the distance between the left of the editor and the leftmost part of the visible content.]{: #EditSession.getScrollLeft}

          Returns number

        • [Returns the value of the distance between the top of the editor and the topmost part of the visible content.]{: #EditSession.getScrollTop}

          Returns number

        • {:BackgroundTokenizer.getState}

          Parameters

          • row: number

            The row to start at

          Returns string

          Related

          BackgroundTokenizer.getState

        • Returns the current value for tabs. If the user is using soft tabs, this will be a series of spaces (defined by [[EditSession.getTabSize getTabSize()]]); otherwise it's simply '\t'.

          Returns string

        • {:Document.getTextRange.desc}

          Parameters

          • Optional range: IRange

            The range to work with

          Returns string

        • Returns an object indicating the token at the current row. The object has two properties: index and start.

          Parameters

          • row: number

            The row number to retrieve from

          • column: number

            The column number to retrieve from

          Returns Token

        • Starts tokenizing at the row indicated. Returns a list of objects of the tokenized rows.

          Parameters

          • row: number

            The row to start at

          Returns Token[]

        • Returns true if soft tabs are being used, false otherwise.

          Returns boolean

        • Returns true if wrap mode is being used; false otherwise.

          Returns boolean

        • Given a starting row and column, this method returns the Range of the first word boundary it finds.

          Parameters

          • row: number

            The row to start at

          • column: number

            The column to start at

          Returns Range

        • Returns the value of wrap limit.

          Returns number

          The wrap limit.

        • Returns an object that defines the minimum and maximum of the wrap limit; it looks something like this:

          { min: wrapLimitRange_min, max: wrapLimitRange_max }
          

          Returns {
              max: number;
              min: number;
          }

          • max: number
          • min: number
        • experimental

          Parameters

          • startRow: number
          • endRow: number
          • clazz: string
          • Optional inFront: boolean

          Returns Range

        • Indents all the rows, from startRow to endRow (inclusive), by prefixing each row with the token in indentString.

          If indentString contains the '\t' character, it's replaced by whatever is defined by [[EditSession.getTabString getTabString()]].

          Parameters

          • startRow: number

            Starting row

          • endRow: number

            Ending row

          • indentString: string

            The indent token

          Returns void

        • Inserts a block of text and the indicated position.

          Parameters

          • position: Point

            The position {row, column} to start inserting at

          • text: string

            A chunk of text to insert

          Returns Point

          The position of the last line of text. If the length of text is 0, this function simply returns position.

        • Returns true if the character at the position is a soft tab.

          Parameters

          • position: Point

            The position to check

          Returns boolean

        • Shifts all the lines in the document down one, starting from firstRow and ending at lastRow.

          Parameters

          • firstRow: number

            The starting row to move down

          • lastRow: number

            The final row to move down

          Returns number

          If firstRow is less-than or equal to 0, this function returns 0. Otherwise, on success, it returns -1.

        • Shifts all the lines in the document up one, starting from firstRow and ending at lastRow.

          Parameters

          • firstRow: number

            The starting row to move up

          • lastRow: number

            The final row to move up

          Returns number

          If firstRow is less-than or equal to 0, this function returns 0. Otherwise, on success, it returns -1.

        • Moves a range of text from the given range to the given position. toPosition is an object that looks like this:

            { row: newRowLocation, column: newColumnLocation }
          

          Parameters

          • fromRange: Range

            The range of text you want moved within the document

          • toPosition: Point

            The location (row and column) where you want to move the text to

          • Optional copy: boolean

          Returns Range

          The new range where the text was moved to.

        • Reloads all the tokens on the current session. This function calls [[BackgroundTokenizer.start BackgroundTokenizer.start ()]] to all the rows; it also emits the 'tokenizerUpdate' event.

          Parameters

          • e: any

          Returns void

        • Outdents all the rows defined by the start and end properties of range.

          Parameters

          • range: Range

            A range of rows

          Returns void

        • Re-implements a previously undone change to your document.

          Parameters

          • deltas: Delta[]

            An array of previous changes

          • Optional dontSelect: boolean

            {:dontSelect}

          Returns void

        • Removes the range from the document.

          Parameters

          • range: IRange

            A specified Range to remove

          Returns Point

          The new start property of the range, which contains startRow and startColumn. If range is empty, this function returns the unmodified value of range.start.

        • Removes a range of full lines. This method also triggers the 'change' event.

          Parameters

          • firstRow: number

            The first row to be removed

          • lastRow: number

            The last row to be removed

          Returns string[]

          Returns all the removed lines.

          Related

          Document.removeFullLines

        • Removes className from the row.

          Parameters

          • row: number

            The row number

          • className: string

            The class to add

          Returns void

        • Removes the marker with the specified ID. If this marker was in front, the 'changeFrontMarker' event is emitted. If the marker was in the back, the 'changeBackMarker' event is emitted.

          Parameters

          • markerId: number

            A number representing a marker

          Returns void

        • Replaces a range in the document with the new text.

          Parameters

          • range: IRange

            A specified Range to replace

          • text: string

            The new text to use as a replacement

          Returns Point

          An object containing the final row and column, like this:

          {row: endRow, column: 0}
          

          If the text and range are empty, this function returns an object containing the current range.start value. If the text is the exact same as what currently exists, this function returns an object containing the current range.end value.

          Related

          Document.replace

        • Parameters

          • screenRow: number
          • screenColumn: number

          Returns number

        • Converts characters coordinates on the screen to characters coordinates within the document. [This takes into account code folding, word wrap, tab size, and any other visual modifications.]{: #conversionConsiderations}

          Parameters

          • screenRow: number

            The screen row to check

          • screenColumn: number

            The screen column to check

          • Optional offsetX: number

            screen character x-offset [optional]

          Returns Point

          The object returned has two properties: row and column.

          Related

          EditSession.documentToScreenPosition

        • Parameters

          • screenRow: number
          • screenColumn: number

          Returns number

        • Sets annotations for the EditSession. This functions emits the 'changeAnnotation' event.

          Parameters

          • annotations: Annotation[]

            A list of annotations

          Returns void

        • Sets a breakpoint on the row number given by row. This function also emits the 'changeBreakpoint' event.

          Parameters

          • row: number

            A row index

          • className: string

            Class of the breakpoint

          Returns void

        • Sets a breakpoint on every row number given by rows. This function also emites the 'changeBreakpoint' event.

          Parameters

          • rows: number[]

            An array of row indices

          Returns void

        • Sets the EditSession to point to a new Document. If a BackgroundTokenizer exists, it also points to doc.

          Parameters

          • doc: Document

            The new Document to use

          Returns void

        • Sets a new text mode for the EditSession. This method also emits the 'changeMode' event. If a [[BackgroundTokenizer BackgroundTokenizer]] is set, the 'tokenizerUpdate' event is also emitted.

          Parameters

          • mode: string | SyntaxMode

            Set a new text mode

          • Optional cb: (() => void)

            optional callback

              • (): void
              • Returns void

          Returns void

        • Set whether keyboard navigation of soft tabs moves the cursor within the soft tab, rather than over

          Parameters

          • navigateWithinSoftTabs: boolean

            Value indicating whether or not to navigate within soft tabs

          Returns void

        • {:Document.setNewLineMode.desc}

          Parameters

          • newLineMode: NewLineMode

            {:Document.setNewLineMode.param}

          Returns void

          Related

          Document.setNewLineMode

        • Pass in true to enable overwrites in your session, or false to disable.

          If overwrites is enabled, any text you enter will type over any text after it. If the value of overwrite changes, this function also emits the changeOverwrite event.

          Parameters

          • overwrite: boolean

            Defines whether or not to set overwrites

          Returns void

        • [Sets the value of the distance between the left of the editor and the leftmost part of the visible content.]{: #EditSession.setScrollLeft}

          Parameters

          • scrollLeft: number

          Returns void

        • This function sets the scroll top value. It also emits the 'changeScrollTop' event.

          Parameters

          • scrollTop: number

            The new scroll top value

          Returns void

        • Set the number of spaces that define a soft tab; for example, passing in 4 transforms the soft tabs to be equivalent to four spaces. This function also emits the changeTabSize event.

          Parameters

          • tabSize: number

            The new tab size

          Returns void

        • Enables or disables highlighting of the range where an undo occurred.

          Parameters

          • enable: boolean

            If true, selects the range of the reinserted change

          Returns void

        • Pass true to enable the use of soft tabs. Soft tabs means you're using spaces instead of the tab character ('\t').

          Parameters

          • val: boolean

            Value indicating whether or not to use soft tabs

          Returns void

        • Identifies if you want to use a worker for the EditSession.

          Parameters

          • useWorker: boolean

            Set to true to use a worker

          Returns void

        • Sets whether or not line wrapping is enabled. If useWrapMode is different than the current value, the 'changeWrapMode' event is emitted.

          Parameters

          • useWrapMode: boolean

            Enable (or disable) wrap mode

          Returns void

        • Sets the session text.

          Parameters

          • text: string

            The new text to place

          Returns void

        • Sets the line length for soft wrap in the editor. Lines will break at a minimum of the given length minus 20 chars and at a maximum of the given number of chars.

          Parameters

          • limit: number

            The maximum line length in chars, for soft wrapping lines.

          Returns void

        • Sets the boundaries of wrap. Either value can be null to have an unconstrained wrap, or, they can be the same number to pin the limit. If the wrap limits for min or max are different, this method also emits the 'changeWrapMode' event.

          Parameters

          • min: number

            The minimum wrap value (the left side wrap)

          • max: number

            The maximum wrap value (the right side wrap)

          Returns void

        • Returns the current [[Document Document]] as a string.

          Returns string

          Method

          toString

          Alias

          EditSession.getValue

        • Sets the value of overwrite to the opposite of whatever it currently is.

          Returns void

        • Reverts previous changes to your document.

          Parameters

          • deltas: Delta[]

            An array of previous changes

          • Optional dontSelect: boolean

            [If true, doesn't select the range of where the change occured]{: #dontSelect}

          Returns void

        • Returns a new instance of EditSession with state from JSON.

          Parameters

          • session: any

            The EditSession state.

          Returns EditSession

          Method

          fromJSON

        Generated using TypeDoc