ФреймворкJavaScript

Placeholder API: смена плейсхолдера на лету

Чтение и смена плейсхолдера уровня редактора (подсказки в пустом блоке инструмента по умолчанию) на лету, без пересоздания редактора.

Обновлено 8 сент. 2026 г.Редактировать на GitHub

Как получить экземпляр редактора

Методы ниже вызываются на редакторе, созданном через new Blok(). Они доступны после того, как разрешится editor.isReady.

TypeScript

// 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');

Методы

placeholder.get()

string | false

Текущий плейсхолдер редактора или false, когда он отключён.

Когда использовать

Возвращает текущий текст плейсхолдера или false, если он отключён.

TypeScript

console.log(editor.placeholder.get()); // 'Type / for commands'

placeholder.set(value)

void

Устанавливает плейсхолдер редактора. Обновляет существующие блоки на месте и применяется к блокам, созданным позже. Передайте false, чтобы отключить его. Доступен синхронно после создания редактора: вызовы до готовности буферизуются и воспроизводятся.

Когда использовать

Обновляет существующие блоки на месте и применяется к блокам, созданным позже. Передайте false, чтобы убрать плейсхолдер.

TypeScript

const editor = new Blok({ holder: 'blok' });

// Safe before isReady — buffered and replayed once the editor boots
editor.placeholder.set('Write something…');

// Disable it
editor.placeholder.set(false);