Zasoby pola kodu
Oprócz statycznych stylów i skryptów zapisanych w plikach Blockstudio obsługuje także dynamiczne bloki zasobów za pomocą pola kodu. W zależności od zastosowania można ograniczyć je do danego bloku.
Podstawowe użycie
W najprostszym przypadku możesz ręcznie wyrenderować zawartość pola kodu w szablonie.
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>
Ograniczony selektor
Aby uniknąć konfliktów z innymi blokami, możesz użyć zmiennej %selector% w polu kodu wraz z useBlockProps w szablonie renderowania.
W polach kodu %selector% wskazuje pojedynczą instancję bloku. W plikach CSS i SCSS %selector% wskazuje zamiast tego współdzieloną klasę z ograniczonym zakresem danego bloku.
Przykład
Załóżmy, że w polu kodu chcemy wskazać tag h1 z powyższego przykładu.
%selector% h1 {
color: red;
}
Teraz Blockstudio wykona trzy działania:
- Utworzy unikalny identyfikator tej instancji bloku
- Zastąpi
%selector%tym unikalnym identyfikatorem - Doda ten sam selektor do elementu oznaczonego jako
useBlockProps
Wynik końcowy będzie wyglądać mniej więcej tak:
<div data-assets="c9abe0d95c2b">
<h1>My block</h1>
</div>
<style>
[data-assets='c9abe0d95c2b'] h1 {
color: red;
}
</style>
Automatyczne renderowanie
Ręczne renderowanie znacznika style za każdym razem może być uciążliwe. Aby uprościć ten proces, możesz użyć atrybutu asset w polu kodu.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "code",
"label": "Custom CSS",
"language": "css",
"asset": true
}
]
}
}
Spowoduje to automatyczne utworzenie znaczników style dla bloków kodu oznaczonych jako css i przeniesienie ich do sekcji head dokumentu. Dla pól, w których językiem oznaczono javascript, zostaną utworzone znaczniki script i umieszczone na końcu sekcji body.
W rozszerzeniach
W przypadku pól kodu używanych w rozszerzeniach atrybut asset nie jest potrzebny. Blockstudio automatycznie wyrenderuje zawartość pola kodu jako zasób, jeśli językiem jest css lub javascript.
Przykład
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customCss",
"type": "code",
"label": "Custom css",
"language": "css"
}
]
}
}
Nie jest potrzebna żadna dodatkowa konfiguracja. Powyższe ustawienie wyświetli pole kodu dla każdego bloku core/* na pasku bocznym i automatycznie wyrenderuje jego zawartość jako zasób strony.
SCSS
Pola kodu obsługują kompilację SCSS. Ustaw język na scss, a Blockstudio skompiluje wartość za pomocą ScssPhp, zanim wyrenderuje ją jako CSS.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
Działają wszystkie funkcje SCSS, takie jak zmienne, zagnieżdżanie i miksy:
%selector% {
$primary: #3b82f6;
h1 {
color: $primary;
}
&:hover {
background: lighten($primary, 40%);
}
}
W edytorze SCSS jest kompilowany po stronie serwera w czasie rzeczywistym, dzięki czemu widzisz wynik podczas pisania. Na stronie kompilacja odbywa się podczas renderowania bloku.