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