Blok Alanı
block alan türü, başka bir Blockstudio bloğa öznitelik olarak başvurmanızı sağlar. Başvurulan bloğun alanları, özel alanlarla aynı idStructure ve overrides sistemi kullanılarak satır içinde genişletilir.
Şablonlarda değer, oluşturulan blok çıktısını döndürür.
Tanım
{
"blockstudio": {
"attributes": [
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}"
}
]
}
}
Bu işlem, başvurulan bloğun alanlarını satır içinde genişletir. mytheme/card bloğunda heading ve content alanları varsa ana blok card_heading ve card_content özniteliklerini alır.
Şablonlarda Kullanım
Şablonlarda alan değeri, başvurulan bloğun oluşturulmuş HTML çıktısını döndürür:
<div class="hero">
<h1>{{ a.title }}</h1>
{{ a.card }}
</div>
<div class="hero">
<h1><?php echo $a['title']; ?></h1>
<?php echo $a['card']; ?>
</div>
Döndürülen Biçim
returnFormat kullanarak alan değerinin ne döndüreceğini denetleyin:
| Değer | Açıklama |
|---|---|
rendered |
(varsayılan) Başvurulan bloğun oluşturulmuş HTML çıktısı |
data |
Başvurulan bloğun öznitelik değerlerini içeren ilişkisel dizi |
both |
rendered (HTML) ve data (öznitelik değerleri) içeren nesne |
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"returnFormat": "data"
}
Geçersiz Kılmalar
Başvurulan bloğun tek tek alan özelliklerini, özel alanlardaki gibi geçersiz kılın:
{
"id": "card",
"type": "block",
"block": "mytheme/card",
"idStructure": "card_{id}",
"overrides": {
"heading": { "default": "Welcome", "label": "Card Title" },
"content": { "label": "Card Body" }
}
}
Birlikte Çalıştıkları
Blok alanı hem normal bloklarla hem de bileşen bloklarla çalışır. Bileşen bloklar programatik olarak oluşturulmak üzere tasarlandığından, bu kullanım için uygundur.