Перейти к содержимому
ФреймворкJavaScript

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

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

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

Методы ниже вызываются на редакторе, созданном через 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);