EditorManager

window.editorManager or editorManager

The editorManager allows you to interact with the editor instance and listen to app-level editor events. Use it for open files/tabs, multi-pane layout, and the active CodeMirror view.

Core properties

editor

Active CodeMirror EditorView for the focused pane.

Read text:

const text = editorManager.editor.state.doc.toString();

Update text:

const view = editorManager.editor;
view.dispatch({
  changes: { from: 0, to: view.state.doc.length, insert: "new content" },
});

TIP

Prefer acode.require("commands") for command registration/removal in new plugins.
See: Commands API

Compatibility helpers are also available for legacy plugins:

• editor.session (Ace-style session proxy for the active file)
• editor.getValue()
• editor.gotoLine(...)
• editor.insert(text)
• editor.getCursorPosition()
• editor.moveCursorToPosition({ row, column })
• editor.selection.getRange()
• editor.getCopyText()

isCodeMirror: boolean

true on modern Acode builds that use CodeMirror 6.

activeFile: EditorFile | null

Currently focused file/tab.

files: EditorFile[]

All open files across every pane.

container: HTMLElement

Editor container of the active pane. Prefer this over assuming a single global editor DOM node when split panes are open.

header

Editor header tile. You can set subtitle text with editorManager.header.subText = "...".

openFileList: HTMLElement

Open-file tab list (pane-aware when multi-pane layout is active).

isScrolling: boolean

Whether the active editor is currently scrolling.

Opening files

There is no editorManager.addNewFile API. Create tabs with:

const EditorFile = acode.require("EditorFile");

// Preferred
new EditorFile("example.js", {
  text: "console.log('hi')",
  render: true,
});

// Or via acode
acode.newEditorFile("example.js", {
  text: "console.log('hi')",
  render: true,
});

See Editor File for full options (pinned, paneId, custom tabs, etc.).

addFile(file: EditorFile)

Registers an already-constructed EditorFile instance with the manager (used internally and by advanced plugins).

getFile(test, type)

Finds an open file.

• test: id, uri, name, git, or gist key
• type: "uri" | "id" | "name" | "git" | "gist"

switchFile(id: string)

Switches the active tab to the given file id.

hasUnsavedFiles(): number

Returns the number of unsaved files.

Multi-pane layout

Acode supports side-by-side / stacked editor panes. Each pane has its own CodeMirror instance, tab list, and active file.

Properties

Property	Description
activePane	Currently focused pane
panes	Array snapshot of all panes
activePaneTabList	Tab list element for the active pane

Creating and closing panes

// Split active pane to the right
const right = await editorManager.splitPaneRight();

// Split below
const below = await editorManager.splitPaneDown();

// Or with options
const pane = await editorManager.createPane({
  direction: "horizontal", // "horizontal" | "vertical" | "right" | "down" | "below"
  moveFile: editorManager.activeFile, // optional: move current file into the new pane
  createUntitled: true, // default true when moveFile is not set
});

// Close panes
editorManager.closeActivePane();
editorManager.closeEmptyPane(pane);

createPane / splitPane* resolve to the new pane object, or null when there is not enough space.

Focusing panes

editorManager.focusNextPane();
editorManager.focusPreviousPane();
editorManager.focusPaneByDirection("left"); // "left" | "right" | "up" | "down"
editorManager.setActivePane(pane);

Moving files between panes

await editorManager.moveActiveFileToNewPane("vertical");

editorManager.moveFileToPane(file, targetPane, {
  activate: true,
});

editorManager.removeFileFromPane(file);
editorManager.getFilePane(file); // pane hosting the file, or null
editorManager.getPaneFiles(pane); // files in a pane

Pin helpers

Pinned tabs stay grouped at the front of a pane's tab list:

file.setPinnedState(true, { reorder: true });
editorManager.moveFileByPinnedState(file);
editorManager.normalizePinnedTabOrder(pane);

Tab history

editorManager.openPreviousEditorFromHistory();
editorManager.openNextEditorFromHistory();
editorManager.recordHistory(file); // usually automatic on switch

LSP / cache helpers

// Restart language clients for the active editor file
editorManager.restartLsp();

// Flush pending crash-cache writes for open editor files
await editorManager.flushCacheWrites();

Events

on(event, listener) / off(event, listener) / emit(event, ...args)

Event	Description
switch-file	Active file changed
rename-file	File renamed
save-file	File saved
file-loaded	File finished loading
file-content-changed	File content changed
add-folder	Workspace folder added
remove-folder	Workspace folder removed
update-folder	Workspace folder updated
new-file	New file created
init-open-file-list	Open file list initialized
remove-file	File removed
update	Generic update (often with a sub-action)

update listeners may receive a sub-action as the first argument, for example:

• "pin-tab"
• "switch-file"
• "read-only"

editorManager.on("switch-file", () => {
  console.log("user switched file", editorManager.activeFile?.filename);
});

editorManager.on("update", (action, file) => {
  if (action === "pin-tab") {
    console.log("pin state changed", file?.filename, file?.pinned);
  }
});