Class VirtualRenderer

The class that is responsible for drawing everything you see on the screen!

Related

editor.renderer

Hierarchy (View Summary)

Constructors

constructor

Properties

canvas CHANGE_CURSOR CHANGE_FULL CHANGE_GUTTER CHANGE_H_SCROLL CHANGE_LINES CHANGE_MARKER CHANGE_MARKER_BACK CHANGE_MARKER_FRONT CHANGE_SCROLL CHANGE_SIZE CHANGE_TEXT characterWidth container content cursorPos desiredHeight destroyed? enableKeyboardAccessibility? gutterWidth keyboardFocusClassName? layerConfig lineHeight margin resizing scrollBar scrollBarH scrollBarV scroller scrollLeft scrollMargin scrollTop session showInvisibles? STEPS textarea theme?

Methods

_dispatchEvent _emit _signal addEventListener addGutterDecoration addToken adjustWrapLimit alignCursor animateScrolling attachToShadowRoot destroy freeze getAnimatedScroll getContainerElement getDisplayIndentGuides getFadeFoldWidgets getFirstFullyVisibleRow getFirstVisibleRow getHighlightGutterLine getHighlightIndentGuides getHScrollBarAlwaysVisible getLastFullyVisibleRow getLastVisibleRow getMouseEventTarget getOption getOptions getPrintMarginColumn getScrollBottomRow getScrollLeft getScrollTop getScrollTopRow getShowGutter getShowInvisibles getShowPrintMargin getTextAreaContainer getTheme getVScrollBarAlwaysVisible hideComposition hideCursor hideTokensAfterPosition isScrollableBy off on once pixelToScreenCoordinates removeAllListeners removeDefaultHandler removeEventListener removeExtraToken removeGhostText removeGutterDecoration removeListener screenToTextCoordinates scrollBy scrollCursorIntoView scrollSelectionIntoView scrollTo scrollToLine scrollToRow scrollToX scrollToY setAnimatedScroll setAnnotations setCompositionText setCursorStyle setDefaultHandler setDisplayIndentGuides setFadeFoldWidgets setGhostText setHighlightGutterLine setHighlightIndentGuides setHScrollBarAlwaysVisible setMargin setMouseCursor setOption setOptions setPadding setPrintMarginColumn setScrollMargin setSession setShowGutter setShowInvisibles setShowPrintMargin setStyle setTheme setVScrollBarAlwaysVisible showComposition showCursor textToScreenCoordinates unfreeze unsetStyle updateBackMarkers updateBreakpoints updateCharacterSize updateCursor updateFontSize updateFrontMarkers updateFull updateLines updateText visualizeBlur visualizeFocus

Constructors

constructor

Properties

canvas

canvas: HTMLDivElement

CHANGE_CURSOR

CHANGE_CURSOR: number

CHANGE_FULL

CHANGE_FULL: number

CHANGE_GUTTER

CHANGE_GUTTER: number

CHANGE_H_SCROLL

CHANGE_H_SCROLL: number

CHANGE_LINES

CHANGE_LINES: number

CHANGE_MARKER

CHANGE_MARKER: number

CHANGE_MARKER_BACK

CHANGE_MARKER_BACK: number

CHANGE_MARKER_FRONT

CHANGE_MARKER_FRONT: number

CHANGE_SCROLL

CHANGE_SCROLL: number

CHANGE_SIZE

CHANGE_SIZE: number

CHANGE_TEXT

CHANGE_TEXT: number

characterWidth

characterWidth: number

container

container: HTMLElement

content

content: HTMLElement

cursorPos

cursorPos: { column: number; row: number }

desiredHeight

desiredHeight: any

Optionaldestroyed

destroyed?: boolean

OptionalenableKeyboardAccessibility

enableKeyboardAccessibility?: boolean

gutterWidth

gutterWidth: any

OptionalkeyboardFocusClassName

keyboardFocusClassName?: string

layerConfig

layerConfig: {
    characterWidth: number;
    firstRow: number;
    firstRowScreen: number;
    gutterOffset: number;
    height: number;
    lastRow: number;
    lineHeight: number;
    maxHeight: number;
    minHeight: number;
    offset: number;
    padding: number;
    width: number;
}

lineHeight

lineHeight: number

margin

margin: {
    bottom: number;
    h: number;
    left: number;
    right: number;
    top: number;
    v: number;
}

resizing

resizing: number

scrollBar

scrollBar: VScrollBar

scrollBarH

scrollBarH: HScrollbar

scrollBarV

scrollBarV: VScrollbar

scroller

scroller: HTMLElement

scrollLeft

scrollLeft: number

scrollMargin

scrollMargin: {
    bottom: number;
    h: number;
    left: number;
    right: number;
    top: number;
    v: number;
}

scrollTop

scrollTop: number

session

session: EditSession

OptionalshowInvisibles

showInvisibles?: boolean

STEPS

STEPS: number

textarea

textarea: HTMLTextAreaElement

Optionaltheme

theme?: any

Methods

_dispatchEvent

_emit

_signal

addEventListener

addGutterDecoration

  • addGutterDecoration(row: any, className: any): void

  • Deprecated; (moved to [[EditSession]])

    Parameters

    • row: any
    • className: any

    Returns void

    Deprecated

addToken

  • addToken(text: string, type: string, row: number, column?: number): void

  • Parameters

    • text: string
    • type: string
    • row: number
    • Optionalcolumn: number

    Returns void

adjustWrapLimit

  • adjustWrapLimit(): boolean

  • Adjusts the wrap limit, which is the number of characters that can fit within the width of the edit area on screen.

    Returns boolean

alignCursor

animateScrolling

  • animateScrolling(fromValue: any, callback?: any): void

  • Parameters

    • fromValue: any
    • Optionalcallback: any

    Returns void

attachToShadowRoot

destroy

  • destroy(): void

  • Destroys the text and cursor layers for this renderer.

    Returns void

freeze

getAnimatedScroll

  • getAnimatedScroll(): boolean

  • Returns whether an animated scroll happens or not.

    Returns boolean

getContainerElement

  • getContainerElement(): HTMLElement

  • Returns the root element containing this renderer.

    Returns HTMLElement

getDisplayIndentGuides

getFadeFoldWidgets

getFirstFullyVisibleRow

  • getFirstFullyVisibleRow(): number

  • Returns the index of the first fully visible row. "Fully" here means that the characters in the row are not truncated; that the top and the bottom of the row are on the screen.

    Returns number

getFirstVisibleRow

  • getFirstVisibleRow(): number

  • [Returns the index of the first visible row.]{: #VirtualRenderer.getFirstVisibleRow}

    Returns number

getHighlightGutterLine

getHighlightIndentGuides

getHScrollBarAlwaysVisible

  • getHScrollBarAlwaysVisible(): boolean

  • Returns whether the horizontal scrollbar is set to be always visible.

    Returns boolean

getLastFullyVisibleRow

  • getLastFullyVisibleRow(): number

  • Returns the index of the last fully visible row. "Fully" here means that the characters in the row are not truncated; that the top and the bottom of the row are on the screen.

    Returns number

getLastVisibleRow

  • getLastVisibleRow(): number

  • [Returns the index of the last visible row.]{: #VirtualRenderer.getLastVisibleRow}

    Returns number

getMouseEventTarget

  • getMouseEventTarget(): HTMLElement

  • Returns the element that the mouse events are attached to

    Returns HTMLElement

getOption

getOptions

getPrintMarginColumn

  • getPrintMarginColumn(): number

  • Returns whether the print margin column is being shown or not.

    Returns number

getScrollBottomRow

  • getScrollBottomRow(): number

  • Returns the last visible row, regardless of whether it's fully visible or not.

    Returns number

getScrollLeft

  • getScrollLeft(): number

  • {:EditSession.getScrollLeft}

    Returns number

    Related

    EditSession.getScrollLeft

getScrollTop

  • getScrollTop(): number

  • {:EditSession.getScrollTop}

    Returns number

    Related

    EditSession.getScrollTop

getScrollTopRow

  • getScrollTopRow(): number

  • Returns the first visible row, regardless of whether it's fully visible or not.

    Returns number

getShowGutter

getShowInvisibles

  • getShowInvisibles(): boolean

  • Returns whether invisible characters are being shown or not.

    Returns boolean

getShowPrintMargin

  • getShowPrintMargin(): boolean

  • Returns whether the print margin is being shown or not.

    Returns boolean

getTextAreaContainer

  • getTextAreaContainer(): HTMLElement

  • Returns the element to which the hidden text area is added.

    Returns HTMLElement

getTheme

  • getTheme(): string

  • [Returns the path of the current theme.]{: #VirtualRenderer.getTheme}

    Returns string

getVScrollBarAlwaysVisible

  • getVScrollBarAlwaysVisible(): boolean

  • Returns whether the horizontal scrollbar is set to be always visible.

    Returns boolean

hideComposition

hideCursor

hideTokensAfterPosition

  • hideTokensAfterPosition(
        row: any,
        column: any,
    ): { type: string; value: string }[]

  • Parameters

    • row: any
    • column: any

    Returns { type: string; value: string }[]

isScrollableBy

  • isScrollableBy(deltaX: number, deltaY: number): boolean

  • Returns true if you can still scroll by either parameter; in other words, you haven't reached the end of the file or line.

    Parameters

    • deltaX: number

      The x value to scroll by

    • deltaY: number

      The y value to scroll by

    Returns boolean

off

on

once

pixelToScreenCoordinates

removeAllListeners

removeDefaultHandler

removeEventListener

removeExtraToken

removeGhostText

removeGutterDecoration

  • removeGutterDecoration(row: any, className: any): void

  • Deprecated; (moved to [[EditSession]])

    Parameters

    • row: any
    • className: any

    Returns void

    Deprecated

removeListener

screenToTextCoordinates

scrollBy

  • scrollBy(deltaX: number, deltaY: number): void

  • Scrolls the editor across both x- and y-axes.

    Parameters

    • deltaX: number

      The x value to scroll by

    • deltaY: number

      The y value to scroll by

    Returns void

scrollCursorIntoView

  • scrollCursorIntoView(
        cursor?: Point,
        offset?: number,
        $viewMargin?: { bottom?: any; top?: any },
    ): void

  • Scrolls the cursor into the first visibile area of the editor

    Parameters

    • Optionalcursor: Point
    • Optionaloffset: number
    • Optional$viewMargin: { bottom?: any; top?: any }

    Returns void

scrollSelectionIntoView

scrollTo

  • scrollTo(x: number, y: number): void

  • Scrolls the editor across both x- and y-axes.

    Parameters

    • x: number

      The x value to scroll to

    • y: number

      The y value to scroll to

    Returns void

scrollToLine

  • scrollToLine(
        line: number,
        center: boolean,
        animate: boolean,
        callback?: () => void,
    ): void

  • Gracefully scrolls the editor to the row indicated.

    Parameters

    • line: number

      A line number

    • center: boolean

      If true, centers the editor the to indicated line

    • animate: boolean

      If true animates scrolling

    • Optionalcallback: () => void

      Function to be called after the animation has finished

    Returns void

scrollToRow

  • scrollToRow(row: number): void

  • Gracefully scrolls from the top of the editor to the row indicated.

    Parameters

    • row: number

      A row id

    Returns void

    Related

    EditSession.setScrollTop

scrollToX

  • scrollToX(scrollLeft: number): void

  • Scrolls the editor across the x-axis to the pixel indicated.

    Parameters

    • scrollLeft: number

      The position to scroll to

    Returns void

scrollToY

  • scrollToY(scrollTop: number): void

  • Scrolls the editor to the y pixel indicated.

    Parameters

    • scrollTop: number

      The position to scroll to

    Returns void

setAnimatedScroll

  • setAnimatedScroll(shouldAnimate: boolean): void

  • Identifies whether you want to have an animated scroll or not.

    Parameters

    • shouldAnimate: boolean

      Set to true to show animated scrolls

    Returns void

setAnnotations

setCompositionText

  • setCompositionText(text: string): void

  • Parameters

    • text: string

      A string of text to use

      Sets the inner text of the current composition to text.

    Returns void

setCursorStyle

setDefaultHandler

setDisplayIndentGuides

  • setDisplayIndentGuides(display: boolean): void

  • Parameters

    • display: boolean

    Returns void

setFadeFoldWidgets

  • setFadeFoldWidgets(show: boolean): void

  • Parameters

    • show: boolean

    Returns void

setGhostText

setHighlightGutterLine

  • setHighlightGutterLine(shouldHighlight: boolean): void

  • Parameters

    • shouldHighlight: boolean

    Returns void

setHighlightIndentGuides

  • setHighlightIndentGuides(highlight: boolean): void

  • Parameters

    • highlight: boolean

    Returns void

setHScrollBarAlwaysVisible

  • setHScrollBarAlwaysVisible(alwaysVisible: boolean): void

  • Identifies whether you want to show the horizontal scrollbar or not.

    Parameters

    • alwaysVisible: boolean

      Set to true to make the horizontal scroll bar visible

    Returns void

setMargin

  • setMargin(top?: number, bottom?: number, left?: number, right?: number): void

  • Parameters

    • Optionaltop: number
    • Optionalbottom: number
    • Optionalleft: number
    • Optionalright: number

    Returns void

setMouseCursor

  • setMouseCursor(cursorStyle: string): void

  • Parameters

    • cursorStyle: string

      A css cursor style

    Returns void

setOption

setOptions

setPadding

  • setPadding(padding: number): void

  • Sets the padding for all the layers.

    Parameters

    • padding: number

      A new padding value (in pixels)

    Returns void

setPrintMarginColumn

  • setPrintMarginColumn(printMarginColumn: number): void

  • Identifies whether you want to show the print margin column or not.

    Parameters

    • printMarginColumn: number

      Set to true to show the print margin column

    Returns void

setScrollMargin

  • setScrollMargin(
        top?: number,
        bottom?: number,
        left?: number,
        right?: number,
    ): void

  • Parameters

    • Optionaltop: number
    • Optionalbottom: number
    • Optionalleft: number
    • Optionalright: number

    Returns void

setSession

  • setSession(session: EditSession): void

  • Associates the renderer with an [[EditSession EditSession]].

    Parameters

    Returns void

setShowGutter

  • setShowGutter(show: boolean): void

  • Identifies whether you want to show the gutter or not.

    Parameters

    • show: boolean

      Set to true to show the gutter

    Returns void

setShowInvisibles

  • setShowInvisibles(showInvisibles: boolean): void

  • Identifies whether you want to show invisible characters or not.

    Parameters

    • showInvisibles: boolean

      Set to true to show invisibles

    Returns void

setShowPrintMargin

  • setShowPrintMargin(showPrintMargin: boolean): void

  • Identifies whether you want to show the print margin or not.

    Parameters

    • showPrintMargin: boolean

      Set to true to show the print margin

    Returns void

setStyle

  • setStyle(style: string, include?: boolean): void

  • [Adds a new class, style, to the editor.]{: #VirtualRenderer.setStyle}

    Parameters

    • style: string

      A class name

    • Optionalinclude: boolean

    Returns void

setTheme

  • setTheme(theme?: string | Theme, cb?: () => void): void

  • [Sets a new theme for the editor. theme should exist, and be a directory path, like ace/theme/textmate.]{: #VirtualRenderer.setTheme}

    Parameters

    • Optionaltheme: string | Theme

      The path to a theme

    • Optionalcb: () => void

      optional callback

    Returns void

setVScrollBarAlwaysVisible

  • setVScrollBarAlwaysVisible(alwaysVisible: boolean): void

  • Identifies whether you want to show the horizontal scrollbar or not.

    Parameters

    • alwaysVisible: boolean

      Set to true to make the horizontal scroll bar visible

    Returns void

showComposition

showCursor

textToScreenCoordinates

  • textToScreenCoordinates(
        row: number,
        column: number,
    ): { pageX: number; pageY: number }

  • Returns an object containing the pageX and pageY coordinates of the document position.

    Parameters

    • row: number

      The document row position

    • column: number

      The document column position

    Returns { pageX: number; pageY: number }

unfreeze

unsetStyle

  • unsetStyle(style: string): void

  • [Removes the class style from the editor.]{: #VirtualRenderer.unsetStyle}

    Parameters

    • style: string

      A class name

    Returns void

updateBackMarkers

updateBreakpoints

updateCharacterSize

updateCursor

updateFontSize

updateFrontMarkers

updateFull

  • updateFull(force?: boolean): void

  • Triggers a full update of all the layers, for all the rows.

    Parameters

    • Optionalforce: boolean

      If true, forces the changes through

    Returns void

updateLines

  • updateLines(firstRow: number, lastRow: number, force?: boolean): void

  • Triggers a partial update of the text, from the range given by the two parameters.

    Parameters

    • firstRow: number

      The first row to update

    • lastRow: number

      The last row to update

    • Optionalforce: boolean

    Returns void

updateText

visualizeBlur

visualizeFocus

Settings

Member Visibility

On This Page

Constructors
Properties
Methods
_dispatchEvent_emit_signaladdEventListeneraddGutterDecorationaddTokenadjustWrapLimitalignCursoranimateScrollingattachToShadowRootdestroyfreezegetAnimatedScrollgetContainerElementgetDisplayIndentGuidesgetFadeFoldWidgetsgetFirstFullyVisibleRowgetFirstVisibleRowgetHighlightGutterLinegetHighlightIndentGuidesgetHScrollBarAlwaysVisiblegetLastFullyVisibleRowgetLastVisibleRowgetMouseEventTargetgetOptiongetOptionsgetPrintMarginColumngetScrollBottomRowgetScrollLeftgetScrollTopgetScrollTopRowgetShowGuttergetShowInvisiblesgetShowPrintMargingetTextAreaContainergetThemegetVScrollBarAlwaysVisiblehideCompositionhideCursorhideTokensAfterPositionisScrollableByoffononcepixelToScreenCoordinatesremoveAllListenersremoveDefaultHandlerremoveEventListenerremoveExtraTokenremoveGhostTextremoveGutterDecorationremoveListenerscreenToTextCoordinatesscrollByscrollCursorIntoViewscrollSelectionIntoViewscrollToscrollToLinescrollToRowscrollToXscrollToYsetAnimatedScrollsetAnnotationssetCompositionTextsetCursorStylesetDefaultHandlersetDisplayIndentGuidessetFadeFoldWidgetssetGhostTextsetHighlightGutterLinesetHighlightIndentGuidessetHScrollBarAlwaysVisiblesetMarginsetMouseCursorsetOptionsetOptionssetPaddingsetPrintMarginColumnsetScrollMarginsetSessionsetShowGuttersetShowInvisiblessetShowPrintMarginsetStylesetThemesetVScrollBarAlwaysVisibleshowCompositionshowCursortextToScreenCoordinatesunfreezeunsetStyleupdateBackMarkersupdateBreakpointsupdateCharacterSizeupdateCursorupdateFontSizeupdateFrontMarkersupdateFullupdateLinesupdateTextvisualizeBlurvisualizeFocus