Главная / Блог / Изоляция CSS в WordPress

Изоляция CSS в WordPress: как защитить блоки Gutenberg от конфликтов стилей

Изоляция CSS - это предотвращение нежелательного влияния стилей между частями интерфейса. В WordPress задача сводится к конкретному вопросу: как организовать стили пользовательского блока Gutenberg, чтобы снизить риск конфликтов с оформлением темы и соседних блоков.

Отдельный файл стилей блока сам по себе изолированную область видимости не создает. Через block.json можно указать, где подключать стили, но все правила продолжают участвовать в общем каскаде страницы.

Откуда берутся конфликты

Классический случай - одинаковые классы в разных компонентах:

/* Карточки товаров */
.card {
  padding: 20px;
  background: white;
}

/* Карточки статей */
.card {
  padding: 10px;
  background: #eee;
}

Если после проверки происхождения, важности деклараций, каскадного слоя, специфичности и близости области действия (@scope, если используется) правила остаются равными, побеждает расположенное позднее в итоговом CSS. Поэтому порядок файлов влияет на результат не сам по себе, а только на последнем этапе каскада. В WordPress каскад формируется правилами из стилей темы, ядра, плагинов и пользовательских блоков, поэтому полагаться на порядок ненадежно.

Почему в WordPress организация особенно важна

Стили на странице собираются из независимых источников: тема, ядро, плагины, пользовательские блоки. Дополнительный источник правил - Global Styles, которые WordPress формирует на основе настроек ядра, темы и пользователя.

Отсюда три следствия:

  • общие имена вроде .card, .title, .button почти гарантированно пересекутся;
  • глобальные правила темы и Global Styles могут задавать оформление заголовков, ссылок и кнопок; наследуемые свойства распространяются и на содержимое пользовательского блока;
  • стили блока грузятся рядом со стилями редактора и фронтенда, их легко перепутать.

Пространства имен и БЭМ

Первый уровень защиты - предсказуемые имена.

Пространство имен - уникальный префикс блока:

.hero-offer {}
.hero-offer__title {}

БЭМ фиксирует структуру: блок, его элемент, его модификатор. Это соглашение, а не техническая граница. Селекторы остаются глобальными, но коллизии имен уходят, если префикс блока уникален в проекте. Подробнее механика разобрана в материале про БЭМ в WordPress.

Для пользовательских блоков практично включать слаг блока в префикс и не использовать короткие общие имена даже внутри блока.

Ограничение селекторов контейнером блока

Второй уровень - привязка всех правил к корневому классу блока:

.wp-block-myplugin-hero-offer h2 { ... }
.wp-block-myplugin-hero-offer .hero-offer__title { ... }

Стандартный класс вида .wp-block-myplugin-hero-offer WordPress формирует автоматически для корректно реализованной обертки блока. В edit для этого используют useBlockProps(), в save - useBlockProps.save(), в динамических PHP-блоках - get_block_wrapper_attributes(). Прописывать этот класс вручную в HTML каждого блока не нужно, достаточно вывести атрибуты обертки через эти функции.

Прием снижает риск влияния на соседние блоки, но от глобальных правил темы не защищает. Правило темы вида .entry-content h2 может перекрыть правило блока за счет специфичности, каскадного слоя или порядка применения правил. Увеличение специфичности не должно становиться основным способом защиты: сначала проверяйте селекторы и происхождение конфликтующих правил в инструментах разработчика, а не повышайте вес собственного селектора автоматически. Это особенно важно там, где тема использует theme.json: Global Styles генерируют CSS-правила на основе настроек ядра, темы и пользователя. Эти правила участвуют в общем каскаде и могут влиять на оформление содержимого блока.

Организация стилей пользовательского блока

В block.json для CSS предусмотрены три свойства с разным назначением:

{
  "style": "file:./style.css",
  "editorStyle": "file:./editor.css",
  "viewStyle": "file:./view.css"
}
  • style - общие стили блока, применяются в редакторе и на фронтенде;
  • editorStyle - дополнительные стили интерфейса редактора;
  • viewStyle - стили, которые нужны только на фронтенде.

Разделение позволяет управлять областями применения стилей: общие правила действуют в редакторе и на фронтенде, служебное оформление редактора не попадает на фронтенд, а стили только для фронтенда не подключаются в редакторе.

Полезный минимум:

  • один корневой класс на блок, все селекторы блока - через него;
  • стили редактора только в editorStyle;
  • стили только фронтенда только в viewStyle;
  • отсутствие голых селекторов элементов вне корня блока.

Когда нужны более строгие механизмы

В экосистеме WordPress обычно достаточно имен, контейнера и аккуратного block.json. Более строгие инструменты подключайте точечно:

  • CSS Modules - техническая уникальность имен классов в сборке. Не блокирует применение глобальных CSS-правил к элементам компонента, речь про каскад снаружи, а не про код внутри модуля.
  • Shadow DOM - инкапсуляция DOM и CSS внутри изолированного дерева. Полной независимости от внешней среды не дает: наследуемые свойства и CSS-переменные проходят через границу, темизация строится с учетом этого.
  • нативный @scope - ограничение области действия правил средствами CSS. Перед использованием в проде проверяйте поддержку в целевых браузерах на текущую дату.

CSS Modules полезны в проектах с компонентной архитектурой, где нужна автоматическая уникальность имен классов. @scope подходит для ограничения области действия собственных правил. Если же виджет должен встраиваться на сторонние сайты и быть защищен от большинства внешних CSS-селекторов, уместен Shadow DOM. При этом наследуемые свойства и CSS-переменные по-прежнему могут передаваться через границу теневого дерева.

Типичные ошибки

ОшибкаЧто происходитЧто сделать вместо
Общий класс .card, .titleПравило блока перекрывает чужое или перекрывается имУникальный префикс по слагу блока
Голые h2, p, a в style.cssСтиль блока расползается на страницуВсе селекторы - через корневой класс блока
Все стили в одном файлеОформление редактора видно на фронтендеРазделить style, editorStyle и viewStyle в block.json
Расчет только на порядок подключенияПосле обновления темы или плагина верстка меняетсяЯвная привязка к контейнеру и проверка происхождения правил
Ожидание автоизоляции от GutenbergОтдельный файл принимают за границу области видимостиПомнить: каскад общий, изоляция строится именами и структурой

Частые вопросы

Чтобы не пропустить новые материалы

Короткий дайджест вечером в понедельник. Без спама.

Выберите, что получать

Обсудим ваш проект

Расскажите о вашем бизнесе, покажите текущий сайт или просто опишите задачу в свободной форме. Я изучу вводные, предложу решение и сориентирую по срокам и смете.

Отвечаю в течение нескольких часов в рабочее время.

Защита от спама – Yandex SmartCaptcha

Если вам удобнее обсудить всё текстом без заполнения форм – напишите напрямую: в Telegram или на sergei@kruglov.net

Удобнее голосом? Напишите пару слов о задаче - договоримся об удобном времени созвона на 15-20 минут, и я пришлю свой номер телефона.