Toolbar API: управление блочным тулбаром
Управление панелью инструментов блока и её состоянием.
Как получить экземпляр редактора
Методы ниже вызываются на редакторе, созданном через new Blok(). Они доступны после того, как разрешится editor.isReady.
// You already hold the instance returned by the constructor.
const editor = new Blok({ holder: 'editor' });
await editor.isReady;
// Call any API method on it.
editor.caret.setToLastBlock('end');Методы
toolbar.close(options?)
voidClose the toolbar with optional configuration.
Когда использовать
Программно закрывает тулбар блока — например, после вашего действия, чтобы UI не висел.
// Standard close (prevents hover reopen — default)
editor.toolbar.close();
// Close but allow the toolbar to reopen on hover
editor.toolbar.close({ setExplicitlyClosed: false });toolbar.open()
voidOpen the toolbar.
Когда использовать
Принудительно открывает тулбар для текущего блока; обычно он появляется при наведении/фокусе, поэтому используйте умеренно.
editor.toolbar.open();toolbar.toggleBlockSettings(openingState?, trigger?, options?)
voidToggle the block settings menu (☰).
Когда использовать
Открывает/закрывает меню настроек ☰ из кода; передайте явный булев флаг, чтобы задать состояние, а не переключать.
Параметры
| Параметр | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|
openingState | boolean | — | toggle current state | Force the settings menu open (true) or closed (false). |
trigger | HTMLElement | — | undefined | Element to anchor the settings popover to. |
options | ToolbarBlockSettingsOptions | — | undefined | Placement overrides — placeLeftOfAnchor positions the popover to the left of the anchor. |
// Toggle current state
editor.toolbar.toggleBlockSettings();
// Force open
editor.toolbar.toggleBlockSettings(true);
// Force close
editor.toolbar.toggleBlockSettings(false);
// Anchor the settings popover to a custom trigger element,
// placed to the left of the anchor
editor.toolbar.toggleBlockSettings(true, triggerEl, { placeLeftOfAnchor: true });toolbar.toggleToolbox(openingState?)
voidToggle the toolbox (+ menu).
Когда использовать
Открывает/закрывает меню вставки + (слэш-меню) программно; передайте булев флаг, чтобы задать состояние.
// Toggle current state
editor.toolbar.toggleToolbox();
// Force open
editor.toolbar.toggleToolbox(true);