BlockBuilder Logo/
Документация/Колбэки
Быстрый стартAPIVueReactДемоИстория изменений
GitHub

Начало работы

Быстрый стартИстория изменений

Справочник API

Обзор APIМетодыСвойстваПоля формТемизация и локализацияУтилитыТипы

Vue 3

Быстрый стартКомпонентыСобытияNuxt (SSR)

React

Быстрый стартКомпонентыКолбэкиNext.js (SSR)
Следующая страница
Next.js (SSR)
→

Колбэки

Колбэки BlockBuilderComponent для отслеживания изменений блоков

Общее использование

Передайте функции в props BlockBuilderComponent:

Типы аргументов — IBlock, TBlockId.

Доступные колбэки

onBlockAdded

Срабатывает после создания нового блока или дублирования существующего

Аргумент:

block: IBlock — полный объект блока

onBlockUpdated

Срабатывает при изменении props, settings или других полей блока

Аргумент:

block: IBlock — актуальный объект после изменения

onBlockDeleted

Срабатывает после удаления блока пользователем

Аргумент:

blockId: TBlockId — id удалённого блока (строка)

Практические примеры

Синхронизация с бэкендом

Автосохранение с debounce

onSave vs колбэки

onBlockAdded / onBlockUpdated / onBlockDeleted — точечные реакции на действия пользователя. onSave получает весь массив блоков при явном сохранении (кнопка «Сохранить») и может вернуть false, чтобы оставить несохранённое состояние.

Аналитика и логирование

Советы

  • •Для автосохранения используйте debounce в onBlockUpdated
  • •При удалении сохраняйте только id — объект блока уже недоступен
  • •Дублирование блока тоже вызывает onBlockAdded
  • •Колбэки срабатывают синхронно с действиями пользователя в UI