Към съдържанието

Регистриране на ресурси

Blockstudio автоматично ще добавя в опашката всички файлове, завършващи на .css, .scss и .js, когато блокът ви се използва на дадена страница. Можете да указвате начина на добавяне на ресурсите в опашката чрез едно от следните имена на файлове. * е заместващ знак, който можете да замените с произволен избран от вас низ.

Във файловете CSS и SCSS на блока %selector% се разгръща до класа на обвивката, чиято област е ограничена до блока. Така можете да изберете същия елемент, към който се прилага bs_get_scoped_class(), дори когато файлът не е ресурс с ограничена област.

Шаблон Поведение
*.(s)css Добавя като таг <link> в редактора и на фронтенда
*.inline.(s)css Добавя съдържанието в вграден таг <style> в редактора и на фронтенда
*.editor.(s)css Добавя като таг <link> само в редактора
*.scoped.(s)css Добавя съдържание с ограничена област във вграден таг <style> в редактора и на фронтенда
*.js Добавя като таг <script> в редактора и на фронтенда
*.inline.js Добавя съдържанието в вграден таг <script> в редактора и на фронтенда
*.editor.js Добавя като таг <script> само в редактора
*.view.js Добавя като таг <script> само на фронтенда

Забележка

Обозначението с тире (*-inline.css, *-editor.css и т.н.) все още се поддържа за обратна съвместимост, но е остаряло. Използвайте обозначение с точка за новите блокове.

Вградено съдържание

Вградените стилове и скриптове имат голямото предимство, че се визуализират директно като тагове за стил или скрипт в страницата. Това може да ускори зареждането, тъй като спестява допълнителните заявки, които иначе биха били необходими.

  • Файловете .js се вграждат в края на body
  • Файловете .(s)css се вграждат в края на head
  • Всеки файл се вгражда само веднъж

Вградени малки таблици със стилове

Файлът *.(s)css се свързва по подразбиране, което добавя по една заявка за всеки файл. Вместо това настройката assets.inlineLimit отпечатва малките таблици със стилове вградени, като следва правилото, което ядрото WordPress прилага към собствените си стилове: външните таблици със стилове на блоковете на дадена страница се сортират от най-малката към най-голямата и се отпечатват като <style>, докато общият им размер остава в рамките на лимита. Всеки останал файл запазва своя таг <link>.

JSON
{
  "assets": {
    "inlineLimit": 40000
  }
}

Лимитът е в байтове, а 0, стойността по подразбиране, изключва поведението. Той измерва компилирания файл, който <link> би заредил, минифициран, когато assets.minify.css е включено. Само изборът между <link> и <style> зависи от размера. Всеки таг остава на мястото, където би бил <link>, така че редът на зареждане и каскадата не се променят. Елементът запазва своя id.

Настройката не важи за файлове *.inline.(s)css и *.scoped.(s)css, които винаги са вградени, за ресурсите на редактора и администрацията или за таблиците със стилове, извлечени от импортирани модули JavaScript. Глобалните таблици със стилове се броят като таблици със стилове на блокове. Файлът остава свързан, когато вграждането би променило съдържанието му:

  • Съдържа относителен URL в url() или @import, който се разрешава спрямо таблицата със стилове при свързване и спрямо страницата при вграждане. Абсолютните пътища, пълните URL адреси, URI адресите data: и фрагментите # са допустими.
  • Използва image-set() или съдържа затваряща последователност </style.
  • Съдържа escape последователности CSS, начало на коментар HTML или декларация @charset. Тези файлове остават свързани като предпазна мярка, за да не се рискува промяна на URL или парсването на документа.

Използвайте филтъра за настройката, за да промените лимита от PHP:

PHP
add_filter('blockstudio/settings/assets/inline_limit', fn() => 40000);

Вграденото CSS става част от HTML на страницата. Кешът на страницата трябва да се изчисти след промяна на таблица със стилове, а браузърът не може да кешира тези байтове между страниците, затова лимитът е общ за цялата страница.

С ограничена област

Стиловете с ограничена област също се вграждат, но получават префикс с ID, който е уникален за всеки блок. Използвайте функцията bs_get_scoped_class, за да добавите класа към шаблона си.

PHP
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
  <h1 class="hero__title">Scope me!</h1>
</section>
CSS
%selector% {
  --hero-gap: var(--wp--preset--spacing--space-10);
}

%selector%.hero {
  border-bottom: 1px solid currentColor;
}

.hero__title {
  color: red;
}

Горният пример ще доведе до следния стил с ограничена област:

HTML
<style>
  .bs-62df71e6cc9a {
    --hero-gap: var(--wp--preset--spacing--space-10);
  }

  .bs-62df71e6cc9a.hero {
    border-bottom: 1px solid currentColor;
  }

  .bs-62df71e6cc9a .hero__title {
    color: red;
  }
</style>

<section class="hero bs-62df71e6cc9a">
  <h1 class="hero__title">Scope me!</h1>
</section>

Обикновените селектори във файл с ограничена област пак избират дъщерните елементи на обвивката с ограничена област. Използвайте %selector%, когато искате да стилизирате самата обвивка.

Глобално

Освен ресурси, специфични за даден блок, можете да добавяте в опашката и глобални ресурси, които ще са налични на всички страници, независимо дали на тях има блок. За да добавите глобален ресурс в опашката, добавете префикса global- към името на файла. Всяко от наставките (e.g. -inline) може да се използва в комбинация.

Възможните комбинации са:

  • global-styles.(s)css
  • global-styles.inline.(s)css
  • global-styles.editor.(s)css
  • global-styles.scoped.(s)css
  • global-scripts.js
  • global-scripts.inline.js
  • global-scripts.editor.js
  • global-scripts.view.js

Администрация

Административните ресурси се добавят в опашката само в административната зона WordPress. Префиксът admin- се използва за задаване на административни ресурси.

  • admin-styles.(s)css
  • admin-scripts.js

Редактор на блокове

Ресурсите на редактора на блокове се добавят в опашката само в редактора на блокове. Префиксът block-editor- се използва за задаване на ресурсите на редактора на блокове.

  • block-editor-styles.(s)css
  • block-editor-scripts.js

Забележка

Ако WordPress деактивира iframe на редактора, защото клиентски блок е регистриран с apiVersion по-малко от 3, платното на редактора и административният интерфейс на WordPress използват един и същ документ. Глобалните скриптове или скриптовете на редактора, които се свързват с window, document, body, събитията на колелцето или превъртането на документа, трябва да проверяват за body.block-editor-page или да изключват области на редактора WordPress като .interface-complementary-area и .interface-navigable-region.

Ред на зареждане

На фронтенда, когато са активирани автоматичното добавяне на ресурси в опашката и буферирането на изхода, Blockstudio добавя таговете на блоковите CSS, <link> и <style> към буферираната страница точно преди затварящия таг </head>, вместо да ги регистрира в wp_enqueue_style(). Затова блоковият CSS идва след стиловите таблици, които WordPress вече е извел в head, включително стиловете на темите и разширенията, добавени в опашката с wp_enqueue_style(), независимо от приоритета им или зависимостите им. Административните ресурси и ресурсите на block-editor- вместо това използват системата за добавяне в опашката на WordPress.

При еднаква важност, каскаден слой и специфичност, таблицата със стилове на блока има предимство пред таблицата със стилове на темата. За да промените това, увеличете специфичността на правилото на темата или добавете таблицата със стилове на темата в края на head Blockstudio генерира чрез филтъра blockstudio/render/head. Съдържанието, добавено чрез филтъра, се поставя след ресурсите на блока. Премахнете таблицата със стилове и от WordPress, за да не се зарежда два пъти.

PHP
add_action('wp_enqueue_scripts', function() {
  wp_dequeue_style('theme-overrides');
}, 100);

add_filter('blockstudio/render/head', function($head) {
  return $head . '<link rel="stylesheet" href="' . esc_url(get_theme_file_uri('overrides.css')) . '">';
});

Филтърът head се изпълнява само когато Blockstudio буферира страницата. Буферирането е изключено в предварителния преглед на Customizer и когато blockstudio/buffer/enabledне връща false. bs_is_buffering() показва в кой случай се намирате, така че дадена тема може да добави таблицата си със стилове чрез филтъра, когато страницата се буферира, и да я добави в опашката с WordPress в противен случай. Отговорът е наличен от wp_enqueue_scripts нататък и е false преди template_redirect.

PHP
add_action('wp_enqueue_scripts', function() {
  $url = get_theme_file_uri('overrides.css');

  if (bs_is_buffering()) {
    add_filter('blockstudio/render/head', function($head) use ($url) {
      return $head . '<link rel="stylesheet" href="' . esc_url($url) . '">';
    });
    return;
  }

  wp_enqueue_style('theme-overrides', $url);
});

Използвайте blockstudio/buffer/output, ако трябва да пренаредите крайния документ по друг начин.

Деактивиране на добавянето в опашката

Автоматичното добавяне на ресурси в опашката може да се деактивира чрез настройката assets/enqueue. Това е полезно, ако искате сами да управлявате добавянето на всички ресурси в опашката.

PHP
add_filter('blockstudio/settings', function($settings) {
  $settings['assets']['enqueue'] = false;
  return $settings;
});

За всеки блок

Ако шаблонът на блок не връща нищо, Blockstudio няма да добави ресурси в опашката за този блок. Този метод е удобен за деактивиране на добавянето в опашката при изпълнение на определено условие.

PHP

PHP
<?php
  if ( !$a['slides'] ) {
    // or return '';
    return false;
  }
?>

<div>my slider</div>

Twig

Twig
{% if not a.slides %}
  <div>my slider</div>
{% endif %}