Кастомный блок в Gutenberg: как не превратить его в хрупкий ком из кода

Кастомный блок нужен не ради «уникальности», а чтобы упростить повторяющийся контент: карточки, CTA, отзывы, сложные обложки. Если блок нельзя собрать из обычных блоков за 2–3 клика, тогда есть смысл делать свой.

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

Хороший кастомный блок:
— сохраняет контент в понятном формате;
— не ломается, если часть полей пустая;
— использует стандартные компоненты редактора;
— имеет предсказуемую структуру HTML. ⚙️

Главная ошибка — тащить в блок всё подряд: сложные настройки, лишние варианты, магию в JavaScript и полную зависимость от одной темы. Чем проще интерфейс редактирования и стабильнее markup, тем меньше сюрпризов при переносе сайта.

Если блок нужен для одного повторяющегося сценария, делайте его узким, прозрачным и с минимальным числом настроек — так он переживет и редизайн, и смену контента без переделки.