Skip to content
ФреймворкJavaScript

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

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

Редактировать на 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

The current editor placeholder, or false when it is disabled.

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

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

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

placeholder.set(value)

void

Sets the editor placeholder; updates existing blocks in place and applies to blocks created afterward. Pass false to disable. Available synchronously after construction — pre-ready calls are buffered and replayed.

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

Обновляет существующие блоки на месте и применяется к блокам, созданным позже; передайте 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);