Обработка на ресурси
Минимизиране
Blockstudio може автоматично да минимизира всички файлове CSS и JS в даден блок.
Компилираните файлове се записват в папката _dist на блока и се добавят в опашката при използване на блока. Когато изходният файл се актуализира, Blockstudio проверява дали съществува компилиран файл с този времеви печат; ако не, той се създава.
За тази цел се използва библиотеката minify.
Минимизирането може да бъде активирано чрез настройката assets/minify:
add_filter('blockstudio/settings/assets/minify/css', function() {
return true;
});
add_filter('blockstudio/settings/assets/minify/js', function() {
return true;
});
SCSS
Ако предпочитате да пишете стиловете си на SCSS, можете да активирате обработката на SCSS:
add_filter('blockstudio/settings/assets/process/scss', function() {
return true;
});
Това ще активира обработката на SCSS за файлове .css.
Като алтернатива можете да използвате разширението .scss и стиловете ще се обработват автоматично, дори когато горната настройка не е true.
Пътища за импортиране
Когато използвате SCSS, можете да импортирате други файлове SCSS. Пътищата за импортиране са относителни спрямо файла, от който се импортира.
@import "modules.scss";
Освен това можете да зададете персонализирани пътища за импортиране чрез филтъра blockstudio/assets/process/scss/import_paths, така че да импортирате файлове от други директории, без да указвате структурата на папките.
При импортиране може да пропуснете разширението .scss; резолверът намира частични файлове като _tokens.scss или файла _index.scss на дадена директория.
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
$paths[] = get_template_directory() . '/scss';
return $paths;
});
Предварително добавен код
Ако искате общите функции, променливи, миксини или помощни средства на Sass да са достъпни във всеки файл SCSS, можете да добавите глобален предварително зададен код преди компилацията.
Това е полезно за рамки като Bootstrap, когато искате достъп до общи миксини, например точки на прекъсване, без да повтаряте импортирането във всеки ресурс на блок.
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
В комбинация с blockstudio/assets/process/scss/import_paths това прави посочената повърхност на Sass достъпна за всеки компилиран файл.
Ресурсите на блоковете се компилират повторно при промяна на времето на последна промяна на зависимост, включително файлове, импортирани от други частични файлове. Blockstudio проследява локалните зависимости @import, @use и @forward, включително зависимостите на предварително добавения код и конфигурираните пътища за импортиране. Общите зависимости се проследяват еднократно, а цикличните зависимости не могат да предизвикат безкраен цикъл при откриването. Тези файлове се включват и в списъка за наблюдение на кеша по време на изпълнение.
Например, редактирането на mixins/_wysiwyg.scss компилира повторно global-styles.scss, когато той импортира scss/_wysiwyg.scss, което на свой ред импортира този миксин. Не е необходимо да променяте входния файл. Вградените модули на Sass и отдалечените импортирания се изключват от локалния граф на зависимостите.
ES модули
Всички скриптове (вградени и по подразбиране) в Blockstudio се зареждат с приложено type="module" по подразбиране. Това означава, че можете да използвате синтаксиса за import в скриптовете на блоковете си без допълнителна настройка.
Забележка
За по-задълбочен преглед на ES модулите посетете уеб документацията на MDN.
Да разгледаме следния код в script.js:
import { h, render } from "https://esm.sh/preact@10.15.1";
import htm from "https://esm.sh/htm@3.1.1";
import confetti from "https://esm.sh/canvas-confetti@1.6.0";
const html = htm.bind(h);
function App(props) {
confetti();
return html`<h1>Hello ${props.name}!</h1>`;
}
render(
html`<${App} name="Hello from Preact!" />`,
document.querySelector("#element")
);
Горният пример създава компонент с Preact, като импортира всички необходими компоненти и функции от съвместим с ESM CDN, в този случай esm.sh. В този подход няма нищо лошо, но той изисква необходимите ресурси да се заявяват от външен сайт, което създава риск скриптовете да се повредят, ако CDN не работи.
Blockstudio включва удобен начин за изтегляне на ES модули в блока, с което се премахва нуждата от външни ESM CDN мрежи в продукционна среда.
Настройка
За да изтеглите модул в директорията на блока си, използвайте префикса npm:, следван от името и версията на пакета:
import { h, render } from "npm:preact@10.15.1";
import htm from "npm:htm@3.1.1";
import confetti from "npm:canvas-confetti@1.6.0";
Този синтаксис съответства на конвенцията за спецификатори Denonpm.
Забележка
Наследеният префикс
blockstudio/(e.g,blockstudio/preact@10.15.1) все още се поддържа за обратна съвместимост, но препоръчваме да използвате префиксаnpm:в новите си проекти. Вижте ръководството за миграция за подробности.
Blockstudio автоматично ще проверява променените .js файлове за импортирания и ще ги изтегля в локалната директория на блока. Изтеглените файлове ще бъдат поставени в папка modules в директорията на блока.
При запис файлът на скрипта ще бъде променен, за да използва локално хоствания модул:
import { h, render } from "./modules/preact/10.15.1.js";
import htm from "./modules/htm/10.15.1.js";
import confetti from "./modules/canvas-confetti/1.6.0.js";
Докато сте в редактора, URL адресът CDN ще продължи да се използва (Blockstudio използва esm.sh), когато преглеждате и работите по блока.
Уточнения
Версия
Обикновено модулите могат да се използват от CDN без номер на версия. В този случай винаги ще се използва най-новата версия. Тъй като Blockstudio не записва информация в базата данни, при използване на модули е необходим номер на версия.
Еднакви модули
Модулите са в обхвата на блоковете си. Дори да използвате един и същ модул със същия номер на версията в няколко блока, Blockstudio пак ще изтегли заявения модул в блока. Това е така най-вече защото блоковете трябва да са самостоятелни единици, които лесно се споделят между различни инсталации или сайтове.
Освен това един и същ модул ще бъде заявен два пъти, ако и двата блока присъстват на дадена страница. Този проблем може да се реши, като използвате script-inline.js вместо файла script.js. Blockstudio ще пренасочи всеки import към местоположението на първата поява на модула, ако името и номерът на версията съвпадат.
Зареждащо устройство за CSS
Възможно е също да импортирате файлове CSS, като използвате същия синтаксис като по-горе.
import "npm:swiper@11.0.0/swiper.min.css";
Файлът CSS ще бъде изтеглен в папката modules и автоматично добавен в опашката при използване на блока. Ако версията е една и съща, само една версия на файла CSS ще бъде добавена в опашката, дори ако присъства в няколко блока.