📘 Modul 05: Blade Template Engine
Pakem mengadopsi sintaks Laravel Blade murni secara native di Rust (resources/views/**/*.blade.rs). Engine Blade di Pakem berjalan tanpa ketergantungan runtime berat, mendukung caching otomatis, pipeline filter berantai, dan delegasi ke plugin WASM Sandbox.
1. Menampilkan Variabel & Escaping
Escaped Output (Aman dari XSS)
Gunakan kurung kurawal ganda {{ ... }} untuk mencetak variabel yang otomatis di-escape HTML:
<h1>Halo, {{ $user.name }}!</h1>
<p>Email: {{ $user.email }}</p>Raw / Unescaped Output
Gunakan tanda seru ganda {!! ... !!} jika Anda ingin mencetak konten HTML mentah:
<div class="article-body">
{!! $post.html_content !!}
</div>2. Pewarisan Layout (Layout Inheritance)
Pakem Blade mendukung struktur template bertingkat menggunakan @extends, @section, dan @yield.
Layout Induk (resources/views/layouts/app.blade.rs):
<!DOCTYPE html>
<html lang="id">
<head>
<meta charset="UTF-8">
<title>@yield('title') - Pakem App</title>
</head>
<body class="bg-slate-900 text-white">
<nav>
<a href="/">Home</a> | <a href="/products">Produk</a>
</nav>
<main class="container mx-auto p-6">
@yield('content')
</main>
<footer>
<p>© 2026 Pakem Framework</p>
</footer>
</body>
</html>Halaman Turunan (resources/views/home.blade.rs):
@extends('layouts.app')
@section('title', 'Beranda')
@section('content')
<div class="hero">
<h1 class="text-3xl font-bold">Selamat Datang di Toko Kami</h1>
<p>Temukan produk teknologi terbaik dengan harga hemat.</p>
</div>
@endsection3. Struktur Kontrol & Kondisional
@if, @elseif, @else, @endif
@if($user.is_admin)
<span class="badge admin">Administrator</span>
@elseif($user.is_editor)
<span class="badge editor">Editor</span>
@else
<span class="badge user">Pengguna Biasa</span>
@endif@unless (Kebalikan dari @if)
@unless($user.is_verified)
<div class="alert">Silakan verifikasi email Anda terlebih dahulu!</div>
@endunless@switch, @case, @default
@switch($order.status)
@case('pending')
<p>Pesanan sedang menunggu pembayaran.</p>
@break
@case('paid')
<p>Pesanan telah lunas dan sedang diproses.</p>
@break
@default
<p>Status pesanan tidak diketahui.</p>
@endswitch4. Perulangan (Loops)
@foreach & Variabel Ajaib $loop
<ul>
@foreach($products as $product)
<li>
#{{ $loop.index }} - {{ $product.name }}
@if($loop.first) <span class="badge">PRODUK UTAMA</span> @endif
@if($loop.last) <span class="badge">AKHIR DAFTAR</span> @endif
</li>
@endforeach
</ul>@forelse (Loop dengan Fallback Kosong)
@forelse($items as $item)
<div class="card">{{ $item.title }}</div>
@empty
<p class="text-slate-400">Belum ada item yang tersedia saat ini.</p>
@endforelse5. Form & Security Helpers
<form method="POST" action="/posts/1">
<!-- Token CSRF otomatis terinjeksi -->
@csrf
<!-- HTTP Method Spoofing untuk PUT / PATCH / DELETE -->
@method('PUT')
<input type="text" name="title" value="{{ $post.title }}">
<!-- Attribute Helpers -->
<input type="checkbox" name="active" @checked($post.is_active)>
<button type="submit" @disabled($post.is_archived)>Perbarui</button>
</form>6. Pipeline Filter Berantai
Pakem Blade mendukung operator pipa | untuk mentransformasi teks secara berurutan:
<!-- Format Mata Uang Rupiah -->
<p>Total: {{ $nominal | rupiah }}</p>
<!-- URL Slug Generator & Uppercase -->
<p>Slug: {{ $title | slug | uppercase }}</p>
<!-- Pembatasan Panjang Teks -->
<p>Ringkasan: {{ $content | limit: 120 }}</p>
<!-- Kombinasi Berantai Bersama Filter WASM Sandbox -->
<p>{{ $komentar | sensor_kata | trim }}</p>7. Direktif WebAssembly & Indonesian Script
Direktif @wasm
Eksekusi fungsi plugin WebAssembly langsung di dalam view:
<div>Hasil Filter WASM: @wasm('sensor_kata', 'sensor', $komentar)</div>Direktif @eval_is
Eksekusi logika perhitungan skrip Indonesian Script (.is) tanpa reload server:
<span>Hemat Diskon: Rp @eval_is('promo.is', 'hitung_promo', $total, 'DISKON50')</span>8. Merender View dari Controller (View::make & impl IntoResponse)
Untuk merender template Blade dari Controller, gunakan builder View::make(...) atau req.view(...):
use pakem::prelude::*;
use axum::response::IntoResponse;
use crate::app::models::user::User;
pub async fn show_dashboard(req: Request) -> impl IntoResponse {
let users = User::all(req.db()).await.unwrap_or_default();
let is_admin = req.user.as_ref().map(|u| u.role == "admin").unwrap_or(false);
// Sintaks bebas ampersand (&) yang bersih dan mudah diketik
View::make("dashboard.index")
.with("title", "Dashboard — Pakem")
.with("users", users)
.with("is_admin", is_admin)
.render(req)
.await
}Metode .render(req).await (atau .render(&req).await) secara otomatis:
- Menyisipkan variabel global aplikasi (CSRF token, flash messages, data user auth aktif).
- Mengompilasi dan mengeksekusi template Blade secara asinkron.
- Mengembalikan tipe response yang langsung kompatibel dengan Axum
impl IntoResponse.
Navigasi Modul:
- Sebelumnya: Modul 04: Model & Eloquent ORM
- Berikutnya: Modul 06: WASM Sandbox & Plugin ➔
- Kembali ke: Daftar Isi Dokumentasi