Тип блока

Оригинальное название: block type

Коротко

Зарегистрированное описание блока редактора WordPress: имя, атрибуты, настройки, скрипты и способ вывода. По нему создаются все экземпляры блока в записях.

Что такое «Тип блока»

Тип блока соотносится с конкретным блоком в статье так же, как класс с объектом. «Абзац» — тип core/paragraph, а каждый абзац в тексте — его экземпляр со своими значениями атрибутов. Ядро регистрирует около сотни типов, плагины и темы добавляют свои. Хранятся они в реестре WP_Block_Type_Registry, и редактор строит по нему список блоков для вставки.

Современный способ описать тип — файл block.json. Его читают и PHP, и JavaScript, поэтому сервер и редактор знают о блоке одно и то же: какие атрибуты допустимы, какие стили подключать, как выводить.

Пример block.json

{
  "apiVersion": 3,
  "name": "studio/price-card",
  "title": "Карточка тарифа",
  "category": "widgets",
  "attributes": {
    "plan": { "type": "string", "default": "Базовый" }
  },
  "supports": { "color": { "background": true } },
  "editorScript": "file:./index.js",
  "render": "file:./render.php"
}

Регистрация на сервере — одна строка: register_block_type( __DIR__ . '/build/price-card' );. Поле render делает блок динамическим: HTML соберёт PHP-файл. Без него разметку сохраняет функция save в JavaScript, и блок будет статическим.

Основные поля

  • name — неповторяющееся имя блока вида «пространство/название» латиницей в нижнем регистре;
  • attributes — какие данные хранит экземпляр и откуда их брать: из комментария блока или из разметки;
  • supports — какие стандартные панели получит блок: цвет, отступы, типографика, выравнивание (см. поддержка функций блока);
  • category, icon, keywords — где и как блок найдётся в библиотеке вставки.

Тип, вариация и паттерн

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

Обновлено:

Все термины раздела «WordPress»

Что будем искать? Например,Продвижение