Blade
Blade adalah mesin templat yang terutama digunakan dengan framework Laravel. Mesin ini memungkinkan pengembang membuat templat yang ekspresif dan rapi dengan sintaks yang memperluas PHP secara sederhana dan intuitif. Templat Blade memudahkan tugas umum seperti menampilkan data dan mengelola tata letak, sehingga pengembangan halaman web dinamis menjadi lebih efisien.
Penyiapan
Untuk menggunakan templat Blade dengan Blockstudio, instal paket illuminate/view milik Laravel menggunakan Composer. Versi 8 hingga 12 dapat digunakan.
composer require illuminate/view
Selanjutnya, tambahkan filter ke file functions.php tema Anda untuk memberi tahu Blockstudio cara merender templat Blade. Blockstudio secara otomatis mengumpulkan semua templat Blade dan memetakan jalurnya, sehingga Anda dapat menggunakan sintaks titik milik Blade untuk include dan tata letak. Blockstudio\Blade_Renderer menyusun pabrik view dari illuminate/view dan menyimpan view terkompilasi dalam direktori sementara sistem.
add_filter(
"blockstudio/blocks/render",
function ($value, $block) {
$blockPath = $block->path;
if (str_ends_with($blockPath, ".blade.php")) {
if (!Blockstudio\Blade_Renderer::available()) {
return 'Error: Blade is not installed. Please run "composer require illuminate/view".';
}
$data = $block->blockstudio["data"];
$bladeData = $data["blade"];
return Blockstudio\Blade_Renderer::render(
$bladeData["path"],
$bladeData["templates"][$block->name],
[
"a" => $data["attributes"],
"attributes" => $data["attributes"],
"b" => $data["block"],
"block" => $data["block"],
"c" => $data["context"],
"context" => $data["context"],
]
);
}
return $value;
},
10,
2
);
Wrapper jenssegers/blade yang digunakan versi sebelumnya halaman ini tidak berfungsi dengan illuminate/view 10 dan yang lebih baru (“Target class [blade.compiler] does not exist”). Jika terpasang, Blade_Renderer menggunakan paket illuminate/view yang disertakannya.
Variabel Templat
Templat Blade Anda dapat mengakses variabel berikut:
| Variabel | Deskripsi |
|---|---|
$a |
Alias untuk $attributes |
$attributes |
Atribut blok |
$b |
Alias untuk $block |
$block |
Data yang berkaitan dengan blok itu sendiri |
$c |
Alias untuk $context |
$context |
Konteks blok (e.g., ID pos, jenis pos saat berada dalam loop) |
Penggunaan
Untuk menggunakan Blade sebagai templat blok, buat file index.blade.php di direktori blok Anda. Blockstudio kemudian akan otomatis menggunakan file ini untuk merender blok.
<div class="my-block">
@if($a['title'])
<h2>{{ $a['title'] }}</h2>
@endif
@if($a['content'])
<p>{{ $a['content'] }}</p>
@endif
</div>