silverbullet/website/API/editor.md

3.4 KiB

The Editor API provides functions for interacting with the editor interface.

editor.getCurrentPage()

Returns the name of the page currently open in the editor.

Example: ${editor.getCurrentPage()}

editor.getCurrentPageMeta()

Returns the meta data of the page currently open in the editor.

Example: ${editor.getCurrentPageMeta()}

editor.getText()

Returns the full text of the currently open page.

Example:

local text = editor.getText()
print("Document length: " .. #text)

editor.setText(text, isolateHistory)

Updates the editor text while preserving cursor location.

Example:

local text = editor.getText()
editor.setText(text:upper(), false)  -- Convert to uppercase

editor.insertAtPos(text, pos)

Insert text at the specified position.

Example:

editor.insertAtPos("Hello!", 0)  -- Insert at beginning

editor.replaceRange(from, to, text)

Replace text in the specified range.

Example:

editor.replaceRange(0, 5, "New text")

editor.insertAtCursor(text, scrollIntoView?)

Insert text at the current cursor position.

Example:

editor.insertAtCursor("Inserted at cursor")

editor.getCursor()

Returns the cursor position as character offset.

Example:

local pos = editor.getCursor()
print("Cursor at position: " .. pos)

editor.getSelection()

Returns the current selection range.

Example:

local sel = editor.getSelection()
print("Selection from " .. sel.from .. " to " .. sel.to)

editor.setSelection(from, to)

Sets the current selection range.

Example:

editor.setSelection(0, 10)  -- Select first 10 characters

editor.moveCursor(pos, center)

Move the cursor to a specific position.

Example:

editor.moveCursor(0, true)  -- Move to start and center

editor.moveCursorToLine(line, column, center)

Move the cursor to a specific line and column.

Example:

editor.moveCursorToLine(1, 1, true)  -- Move to start of first line

editor.openPageNavigator(mode)

Opens the page navigator.

Example:

editor.openPageNavigator("page")

editor.openCommandPalette()

Opens the command palette.

Example:

editor.openCommandPalette()

editor.showPanel(id, mode, html, script)

Shows a panel in the editor.

Example:

editor.showPanel("rhs", 1, "<h1>Hello</h1>")

editor.hidePanel(id)

Hides a panel in the editor.

Example:

editor.hidePanel("rhs")

editor.flashNotification(message, type)

Shows a flash notification.

Example:

editor.flashNotification("Operation completed", "info")

editor.downloadFile(filename, dataUrl)

Triggers a file download in the browser.

Example:

editor.downloadFile("test.txt", "data:text/plain;base64,SGVsbG8=")

editor.uploadFile(accept, capture)

Opens a file upload dialog.

Example:

local file = editor.uploadFile(".txt", nil)
print("Uploaded: " .. file.name)

editor.copyToClipboard(data)

Copies data to the clipboard.

Example:

editor.copyToClipboard("Copied text")

editor.toggleFold()

Toggles code folding at the current position.

Example:

editor.toggleFold()

editor.foldAll()

Folds all foldable regions.

Example:

editor.foldAll()

editor.unfoldAll()

Unfolds all folded regions.

Example:

editor.unfoldAll()

editor.openSearchPanel()

Opens the editor's search panel.

Example:

editor.openSearchPanel()