Content Editor

The content editor lets users edit text and images directly on the PDF page — add text, add images, and modify existing content. It is coordinated by the engine's content_edit_manager with a dedicated history manager, exposed to the UI through the core bridge.

The content-editing engine lives in the closed-source Core (packages/core/src/editor/). The UI layer drives it through the bridge and mirrors state in the stores.

UI APIs

Save / save-as enable/disable

UI.disableDocumentEditorSave();     // useViewer.setDocumentEditorSaveStatus(false)
UI.enableDocumentEditorSave();      // useViewer.setDocumentEditorSaveStatus(true)
UI.disableDocumentEditorSaveAs();   // useViewer.setDocumentEditorSaveAsStatus(false)
UI.enableDocumentEditorSaveAs();    // useViewer.setDocumentEditorSaveAsStatus(true)

Toggle the documentEditorSaveStatus / documentEditorSaveAsStatus flags in the viewer store, controlling whether the Save / Save-As actions are available in the document editor.

UI.saveDocumentEditor() (async)

Persist the document-editor changes and reload the document.

await UI.saveDocumentEditor();

Internally (in apis/saveDocumentEditor.js):

1. Calls core.saveDocumentEdit() to get a newUrl; returns early if falsy.
2. Resets editor state: useDocument.resetSetting(), useDocument.setToolState('').
3. Switches the viewer back to view mode: setActiveToolMode('view'), setToolbarGroup('toolbarGroup-View'), setActiveHeaderGroup('default').
4. Triggers upload (setUpload(true), setUploadLoading(true)), preserves the old scale.
5. Sets useDocument.setCurrentPdfData(newUrl), refreshes totalPages via core.getPagesCount(), outlines via core.getOutlines(), resets page to 1.
6. Re-applies scroll/spread mode and scale via core.switchScrollMode / core.switchSpreadMode / core.scaleChanged.
7. setUploadLoading(false).

Content editor state

Store	Field	Purpose
viewer	contentEditorType	Editor type ('text').
viewer	documentEditorSaveStatus / documentEditorSaveAsStatus	Save / save-as availability.
document	documentEditor	{ operationList[], pageList[], selectedPageList[] }.
document	canUndo / canRedo	{ content, annotation } undo/redo flags.

useHistoryListener (in HeaderItemsListener.js) bridges the engine's contentEditHistoryChanged / historyChanged events into useDocument.setCanUndo / setCanRedo.

Content editor components

• DocumentEditorContainer — the page editor surface, shown when the active tool mode is document.
• ContentEditorPanel — content-editor selection properties (right panel, eager-loaded).
• ContentEditorToolBar — content-editor toolbar.
• ContentEditorPopup — the content-editor context menu (see Popups).

Related dialogs: ContentEditorPreventDialog, DocEditorPreventDialog.

Core bridge (content-editor surface)

The core bridge exposes on instance.Core:

Function	Purpose
switchAnnotationEditorMode	Switch the editor mode.
setContentEditorProperty(type, props)	Set properties on the active content editor. For text, supports independent bold, italic, underline, and strikethrough changes, plus an explicit character range. See Edit Text and Image Properties.
getContentEditManager	Get the content-edit coordinator.
getContentEditHistoryManager	Get the content-edit history manager.
addEditorImage	Add an image to the editor.
getCropedPageImage	Get a cropped page image.
saveDocumentEdit	Save edits and return a new URL.

Examples

Disable save-as in the editor

UI.disableDocumentEditorSaveAs();

Save and reload

await UI.saveDocumentEditor();

Related

• Header & Toolbar — the editor toolbar group.
• Popups — the content-editor popup.
• Core Bridge
• API Reference