---
title: "Placeholder API — чтение и установка"
description: "Смена плейсхолдера пустого блока на лету: он обновляет уже существующие блоки и применяется к блокам, созданным позже."
source: https://blokeditor.com/ru/docs/placeholder-api/
lastmod: 2026-08-01
---

Фреймворк JavaScript

Интерфейс Плейсхолдер

На этой странице placeholder.get()

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

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

[Редактировать на GitHub](https://github.com/JackUait/blok/blob/main/docs/src/components/api/api-data.ts)

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

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