DS Server

Javascript: Toolbar.setItems Method

Method|Introduced in 32.4.1

Description

Replaces all main-toolbar items with DOM elements or built-in item descriptors.

Syntax

<void> Toolbar.setItems(<(ToolbarItem|DefaultToolbarItemDescriptor)[]> items)

Parameters

ParameterDescription
items

Items to display.

Return Value

Replaces all main-toolbar items with DOM elements or built-in item descriptors.

Examples

Use an existing DOM element as a custom toolbar item.

const zoomIn = document.createElement("button");
zoomIn.textContent = "Zoom in";
controller.toolbar.setItems([zoomIn]);
// Add the viewer's built-in toolbar items.
controller.toolbar.setItems([
    { defaultItemType: "ZoomInButton" },
    { defaultItemType: "ZoomOutButton" }
]);

The following example demonstrates toolbar.setItems in a practical Document Viewer workflow. Sets the items of the toolbar.

function replaceViewerToolbarItems(toolbarItems) {
    TXDocumentViewer.toolbar.setItems(toolbarItems);
    console.log("Toolbar item count:", TXDocumentViewer.toolbar.getItems().length);
}