Prostředky z pole kódu
Kromě statických stylů a skriptů uložených v souborech podporuje Blockstudio také dynamické bloky prostředků prostřednictvím pole kódu. V závislosti na použití je lze omezit na daný blok.
Základní použití
V nejjednodušším případě můžete obsah pole kódu vykreslit ručně v šabloně.
PHP
<div useBlockProps>
<h1>My block</h1>
</div>
<style><?php echo $attributes['css']; ?></style>
Twig
<div useBlockProps>
<h1>My block</h1>
</div>
<style>{{ attributes.css }}</style>
Výběr ohraničený na blok
Abyste předešli konfliktům s jinými bloky, můžete v poli kódu použít proměnnou %selector% spolu s useBlockProps v šabloně vykreslování.
V polích kódu cílí %selector% na konkrétní instanci bloku. V souborech CSS a SCSS cílí %selector% na sdílenou třídu bloku ohraničenou na jeho obsah.
Příklad
Představme si, že chceme v poli kódu cílit na značku h1 z výše uvedeného příkladu.
%selector% h1 {
color: red;
}
Nyní Blockstudio provede tři věci:
- Vytvoří jedinečné ID pro danou instanci bloku
- Nahradí
%selector%tímto jedinečným ID - Přidá stejný selektor k prvku označenému pomocí
useBlockProps
Výsledný výstup bude vypadat například takto:
<div data-assets="c9abe0d95c2b">
<h1>My block</h1>
</div>
<style>
[data-assets='c9abe0d95c2b'] h1 {
color: red;
}
</style>
Automatické vykreslování
Ruční vykreslování tagu style může být pokaždé zdlouhavé. Tento postup si můžete usnadnit použitím atributu asset v poli kódu.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "code",
"label": "Custom CSS",
"language": "css",
"asset": true
}
]
}
}
Automaticky vytvoří tagy style pro bloky kódu označené jako css a přesune je do hlavičky dokumentu. U polí, jejichž jazyk je označen jako javascript, se místo toho vytvoří tagy script a umístí se na konec těla dokumentu.
V rozšířeních
Při použití polí kódu uvnitř rozšíření není atribut asset potřeba. Blockstudio automaticky vykreslí obsah pole kódu jako prostředek, pokud je jazyk css nebo javascript.
Příklad
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customCss",
"type": "code",
"label": "Custom css",
"language": "css"
}
]
}
}
Není potřeba žádná další konfigurace. Výše uvedené zobrazí v postranním panelu pole kódu pro každý blok core/* a automaticky vykreslí jeho obsah na stránce jako prostředek.
SCSS
Pole kódu podporují kompilaci SCSS. Nastavte jazyk na scss a Blockstudio před vykreslením hodnotu zkompiluje pomocí ScssPhp jako CSS.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
Funkce SCSS, jako jsou proměnné, vnořování a mixiny, fungují:
%selector% {
$primary: #3b82f6;
h1 {
color: $primary;
}
&:hover {
background: lighten($primary, 40%);
}
}
V editoru se SCSS kompiluje na straně serveru v reálném čase, takže výsledek vidíte při psaní. Na frontendu ke kompilaci dochází při vykreslování bloku.