7 ошибок при создании кастомных блоков, которые ломают редактор и верстку

7 ошибок при создании кастомных блоков, которые ломают редактор и верстку

Кастомный блок в Gutenberg должен быть не «удобным для разработчика», а предсказуемым для редактора и автора. Если сразу не заложить границы, потом приходится чинить сохранение, стили и UX.

• Смешивают логику и разметку: блок сложно поддерживать, а изменения в одной части ломают другую.
• Не задают defaults для атрибутов: пустое состояние выглядит как баг, а не как сценарий.
• Прячут важные настройки: автор не понимает, где менять текст, отступы и фон.
• Делают слишком много опций: панель превращается в свалку, блоком неудобно пользоваться.

Проверь, чтобы блок сохранял содержимое без лишней магии: минимум зависимостей, понятные атрибуты, стабильная структура. Если есть динамика, заранее реши, что хранится в базе, а что рисуется на сервере.

Отдельно тестируй блок в пустом состоянии, с длинным текстом и с разными медиа. Именно там всплывают поломки, которые не видно на красивом демо.

Хороший кастомный блок не требует объяснений: автор открывает редактор и сразу понимает, что с ним делать.