Class FileEditorAdapter

Hierarchy

Constructors

constructor

Properties

_activeEditorChanged _adapterConnected _disposed _docRegistry _editorAdded _editorRemoved _readyDelegate _virtualEditor editor options widget

Accessors

activeEditor activeEditorChanged adapterConnected ceEditor connectionManager disposed documentPath editorAdded editorRemoved editors hasMultipleEditors isConnected isDisposed language languageFileExtension mimeType path ready trans updateFinished virtualDocument widgetId wrapperElement

Methods

connectDocument createVirtualDocument disconnect dispose documentChanged getEditorIndex getEditorIndexAt getEditorWrapper initOnceReady initVirtual onConnected onConnectionClosed onForeignDocumentOpened onSaveState reloadConnection updateDocuments

Constructors

constructor

Properties

Protected _activeEditorChanged

_activeEditorChanged: Signal<WidgetLSPAdapter<IDocumentWidget<FileEditor, DocumentRegistry.IModel>>, IEditorChangedData>

Signal emitted when the active editor have changed.

Protected _adapterConnected

_adapterConnected: Signal<WidgetLSPAdapter<IDocumentWidget<FileEditor, DocumentRegistry.IModel>>, IDocumentConnectionData>

Signal emitted when the adapter is connected.

Protected _disposed

_disposed: Signal<WidgetLSPAdapter<IDocumentWidget<FileEditor, DocumentRegistry.IModel>>, void>

Signal emitted when the adapter is disposed.

Private Readonly _docRegistry

_docRegistry: DocumentRegistry

The document registry instance.

Protected _editorAdded

_editorAdded: Signal<WidgetLSPAdapter<IDocumentWidget<FileEditor, DocumentRegistry.IModel>>, IEditorChangedData>

Signal emitted when an editor is changed.

Protected _editorRemoved

_editorRemoved: Signal<WidgetLSPAdapter<IDocumentWidget<FileEditor, DocumentRegistry.IModel>>, IEditorChangedData>

Signal emitted when an editor is removed.

Private _readyDelegate

_readyDelegate: PromiseDelegate<void> = ...

Private Readonly _virtualEditor

_virtualEditor: IEditor

Readonly editor

editor: FileEditor

The wrapped FileEditor widget.

Protected options

options: IAdapterOptions

widget

widget: IDocumentWidget<FileEditor, DocumentRegistry.IModel>

Accessors

activeEditor

activeEditorChanged

  • get activeEditorChanged(): ISignal<WidgetLSPAdapter<T>, IEditorChangedData>

  • Signal emitted when the active editor have changed.

    Returns ISignal<WidgetLSPAdapter<T>, IEditorChangedData>

adapterConnected

  • get adapterConnected(): ISignal<WidgetLSPAdapter<T>, IDocumentConnectionData>

  • Signal emitted when the adapter is connected.

    Returns ISignal<WidgetLSPAdapter<T>, IDocumentConnectionData>

ceEditor

connectionManager

  • get connectionManager(): ILSPDocumentConnectionManager

  • The LSP document and connection manager instance.

    Returns ILSPDocumentConnectionManager

disposed

  • get disposed(): ISignal<WidgetLSPAdapter<T>, void>

  • Signal emitted when the adapter is disposed.

    Returns ISignal<WidgetLSPAdapter<T>, void>

documentPath

editorAdded

  • get editorAdded(): ISignal<WidgetLSPAdapter<T>, IEditorChangedData>

  • Signal emitted when the an editor is changed.

    Returns ISignal<WidgetLSPAdapter<T>, IEditorChangedData>

editorRemoved

  • get editorRemoved(): ISignal<WidgetLSPAdapter<T>, IEditorChangedData>

  • Signal emitted when the an editor is removed.

    Returns ISignal<WidgetLSPAdapter<T>, IEditorChangedData>

editors

hasMultipleEditors

  • get hasMultipleEditors(): boolean

  • Check if the document contains multiple editors

    Returns boolean

isConnected

  • get isConnected(): boolean

  • The virtual document is connected or not

    Returns boolean

isDisposed

  • get isDisposed(): boolean

  • Check if the adapter is disposed

    Returns boolean

language

  • get language(): string

  • Get the language identifier of the document

    Returns string

languageFileExtension

mimeType

path

ready

trans

updateFinished

  • get updateFinished(): Promise<void>

  • Promise that resolves once the document is updated

    Returns Promise<void>

virtualDocument

  • get virtualDocument(): null | VirtualDocument

  • Internal virtual document of the adapter.

    Returns null | VirtualDocument

widgetId

  • get widgetId(): string

  • Get the ID of the internal widget.

    Returns string

wrapperElement

Methods

Protected connectDocument

  • connectDocument(virtualDocument, sendOpen?): Promise<void>

  • Opens a connection for the document. The connection may or may not be initialized, yet, and depending on when this is called, the client may not be fully connected.

    Parameters

    • virtualDocument: VirtualDocument

      a VirtualDocument

    • Optional sendOpen: boolean

      whether to open the document immediately

    Returns Promise<void>

createVirtualDocument

disconnect

  • disconnect(): void

  • Disconnect virtual document from the language server.

    Returns void

dispose

documentChanged

  • documentChanged(virtualDocument, document, isInit?): void

  • Callback called on the document changed event.

    Parameters

    • virtualDocument: VirtualDocument
    • document: VirtualDocument
    • Optional isInit: boolean

    Returns void

getEditorIndex

getEditorIndexAt

  • getEditorIndexAt(position): number

  • Get the index of editor from the cursor position in the virtual document. Since there is only one editor, this method always return 0

    Parameters

    • position: IVirtualPosition

      the position of cursor in the virtual document.

    Returns number

    • index of the virtual editor

    Deprecated

    This is error-prone and will be removed in JupyterLab 5.0, use getEditorIndex() with virtualDocument.getEditorAtVirtualLine(position) instead.

getEditorWrapper

Protected initOnceReady

Protected initVirtual

  • initVirtual(): void

  • Create the virtual document using current path and language.

    Returns void

Protected onConnected

  • onConnected(data): Promise<void>

  • Connect the virtual document with the language server.

    Parameters

    • data: IDocumentConnectionData

    Returns Promise<void>

onConnectionClosed

  • onConnectionClosed(_, __namedParameters): void

  • Callback on connection closed event.

    Parameters

    • _: ILSPDocumentConnectionManager
    • __namedParameters: IDocumentConnectionData

    Returns void

Protected onForeignDocumentOpened

  • onForeignDocumentOpened(host, context): Promise<void>

  • Handler for opening a document contained in a parent document. The assumption is that the editor already exists for this, and as such the document should be queued for immediate opening.

    Parameters

    • host: VirtualDocument

      the VirtualDocument that contains the VirtualDocument in another language

    • context: IForeignContext

      information about the foreign VirtualDocument

    Returns Promise<void>

Protected onSaveState

Protected reloadConnection

  • reloadConnection(): void

  • Returns void

updateDocuments

  • updateDocuments(): Promise<void>

  • Update the virtual document.

    Returns Promise<void>

Settings

Member Visibility

Theme

On This Page

constructor_activeEditorChanged_adapterConnected_disposed_docRegistry_editorAdded_editorRemoved_readyDelegate_virtualEditoreditoroptionswidgetactiveEditoractiveEditorChangedadapterConnectedceEditorconnectionManagerdisposeddocumentPatheditorAddededitorRemovededitorshasMultipleEditorsisConnectedisDisposedlanguagelanguageFileExtensionmimeTypepathreadytransupdateFinishedvirtualDocumentwidgetIdwrapperElementconnectDocumentcreateVirtualDocumentdisconnectdisposedocumentChangedgetEditorIndexgetEditorIndexAtgetEditorWrapperinitOnceReadyinitVirtualonConnectedonConnectionClosedonForeignDocumentOpenedonSaveStatereloadConnectionupdateDocuments