Kod Alanı Varlıkları
Dosyalar biçimindeki statik stiller ve betiklerin yanı sıra Blockstudio, kod alanı aracılığıyla dinamik varlık bloklarını da destekler. Kullanım durumunuza bağlı olarak bunları blok kapsamında tutabilirsiniz.
Temel kullanım
En temel düzeyde, kod alanı içeriğini şablonunuzda elle oluşturabilirsiniz.
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>
Kapsamlı seçici
Diğer bloklarla çakışmaları önlemek için, oluşturma şablonunuzda useBlockProps ile birlikte kod alanının içinde %selector% değişkenini kullanabilirsiniz.
Kod alanlarında %selector%, tekil blok örneğini hedefler. CSS ve SCSS dosyalarında ise %selector%, bunun yerine bloğun ortak kapsamlı sınıfını hedefler.
Örnek
Yukarıdaki örnekteki h1 etiketini kod alanımızda hedeflemek istediğimizi varsayalım.
%selector% h1 {
color: red;
}
Şimdi Blockstudio üç şey yapacak:
- Bu blok örneği için benzersiz bir kimlik oluşturur
%selector%ifadesini benzersiz kimlikle değiştirir- Aynı seçiciyi
useBlockPropsile işaretlenmiş öğeye ekler
Son çıktı şöyle görünür:
<div data-assets="c9abe0d95c2b">
<h1>My block</h1>
</div>
<style>
[data-assets='c9abe0d95c2b'] h1 {
color: red;
}
</style>
Otomatik oluşturma
Stil etiketini her seferinde elle oluşturmak zahmetli olabilir. Bu süreci kolaylaştırmak için kod alanında asset özniteliğini kullanabilirsiniz.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "code",
"label": "Custom CSS",
"language": "css",
"asset": true
}
]
}
}
Bu, css olarak işaretlenmiş kod blokları için otomatik olarak style etiketleri oluşturur ve bunları belgenin head bölümüne taşır. Dil olarak javascript işaretlenmiş alanlar içinse bunun yerine script etiketleri oluşturulur ve body bölümünün sonuna yerleştirilir.
Eklentilerde
eklenti içinde kod alanları kullanırken asset özniteliği gerekli değildir. Dil css veya javascript ise Blockstudio kod alanının içeriğini otomatik olarak bir varlık olarak oluşturur.
Örnek
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customCss",
"type": "code",
"label": "Custom css",
"language": "css"
}
]
}
}
Ek yapılandırma gerekmez. Yukarıdaki yapı, kenar çubuğunda her core/* bloğu için bir kod alanı gösterir ve içeriği otomatik olarak sayfaya varlık olarak ekler.
SCSS
Kod alanları SCSS derlemesini destekler. Dili scss olarak ayarlayın; Blockstudio, değeri ScssPhp üzerinden derleyip CSS olarak oluşturur.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
SCSS değişkenler, iç içe yapı ve mixin’ler gibi özelliklerin tümü çalışır:
%selector% {
$primary: #3b82f6;
h1 {
color: $primary;
}
&:hover {
background: lighten($primary, 40%);
}
}
Düzenleyicide SCSS sunucu tarafında gerçek zamanlı olarak derlenir; böylece yazdıkça sonucu görürsünüz. Ön yüzde derleme, blok oluşturulurken gerçekleşir.