> ## Documentation Index > Fetch the complete documentation index at: https://mintlify.com/betoalien/Lyger-PHP-Framework/llms.txt > Use this file to discover all available pages before exploring further. # Blade Templates > Use Blade templating engine for dynamic views in Lyger ## Overview Lyger includes a lightweight Blade-inspired templating engine for rendering dynamic views. The Blade engine provides a clean syntax for working with PHP templates, layouts, and components. Lyger's Blade implementation (`Lyger\Livewire\Blade`) is a simplified version designed for performance and ease of use. ## Basic Usage ### Setting Up Blade Configure the views and cache paths: ```php theme={null} use Lyger\Livewire\Blade; // Set the views directory Blade::setViewsPath(__DIR__ . '/resources/views'); // Set the cache directory Blade::setCachePath(__DIR__ . '/storage/cache/views'); ``` ### Rendering Views ```php theme={null} use Lyger\Livewire\Blade; // Render a view with data $html = Blade::render('welcome', [ 'title' => 'Welcome to Lyger', 'user' => 'John Doe', ]); echo $html; ``` ```php theme={null} // Use dot notation for nested directories // Renders: resources/views/admin/dashboard.php $html = Blade::render('admin.dashboard', [ 'stats' => $statistics, ]); ``` ```php theme={null} use Lyger\Livewire\View; // Alternative syntax using View facade $html = View::make('profile.show', [ 'user' => $currentUser, ]); ``` ## Template Files Create template files in your views directory: ```php theme={null} <?= $title ?>

Hello, !

Welcome to the application.

``` ### Variable Extraction All data passed to the view is automatically extracted as variables: ```php theme={null} Blade::render('profile', [ 'name' => 'John Doe', 'email' => 'john@example.com', 'age' => 30, ]); ``` ```php theme={null}

Email:

Age:

``` ## Includes and Partials ### Including Partials Use `Blade::include()` to include partial views: ```php theme={null}

Dashboard

$menuItems]) ?>
``` ```php theme={null} ``` ## Layouts and Sections ### Defining Layouts Create a layout template with yield points: ```php theme={null} <?= Blade::yield('title') ?> - My App
``` ### Extending Layouts Use `Blade::extends()` to specify the parent layout: ```php theme={null} ``` Use `Blade::start()` and `Blade::end()` to define section content: ```php theme={null} Home Page

Welcome to Our Site

This is the home page content.

``` ### Complete Layout Example ```php Layout File theme={null} <?= Blade::yield('title') ?>
``` ```php Page Using Layout theme={null}

By
``` ## Components ### Rendering Components Use `Blade::component()` to render Livewire or component class instances: ```php theme={null} 10, 'step' => 2, ]); echo $html; ?> ``` ### Component in Views ```php theme={null}

Dashboard

'Total Users', 'value' => $userCount, 'icon' => 'users', ]) ?> 'Revenue', 'value' => '$' . number_format($revenue, 2), 'icon' => 'dollar', ]) ?>
``` ## Loop Helper The `Blade::each()` method simplifies rendering lists: ```php theme={null} use Lyger\Livewire\Blade; $users = [ ['name' => 'John', 'email' => 'john@example.com'], ['name' => 'Jane', 'email' => 'jane@example.com'], ['name' => 'Bob', 'email' => 'bob@example.com'], ]; $html = Blade::each($users, 'partials.user-item', 'user'); echo $html; ``` ```php theme={null}

Item of

First Last
``` ### Loop Variables The `$loop` variable provides useful iteration data: | Variable | Description | | -------------------- | ------------------------------ | | `$loop['index']` | Zero-based index (0, 1, 2...) | | `$loop['iteration']` | Current iteration (1, 2, 3...) | | `$loop['first']` | True if first iteration | | `$loop['last']` | True if last iteration | | `$loop['count']` | Total number of items | ## Blade Directives The `Lyger\Livewire\Directives` class provides common template directives: ### Conditional Directives ```php theme={null} use Lyger\Livewire\Directives; $html = Directives::if('$isAdmin', ''); // Output: ``` ```php theme={null} $html = Directives::isset('$user', '

Welcome, name ?>

'); // Output:

Welcome...

``` ```php theme={null} $html = Directives::empty('$items', '

No items found

'); // Output:

No items found

``` ### Loop Directives ```php @foreach theme={null} use Lyger\Livewire\Directives; $html = Directives::foreach( '$users', '$user', '
  • name ?>
    • ' ); // Output: // //
  • name ?>
    • // ``` ```php @for theme={null} $html = Directives::for( '$i = 0', '$i < 10', '$i++', '

    Item

    ' ); // Output: // //

    Item

    // ``` ```php @while theme={null} $html = Directives::while( '$hasItems', '
    name ?>
    ' ); // Output: // //
    name ?>
    // ``` ```php @forelse theme={null} $html = Directives::forelse( '$products', '$product', '
    name ?>
    ', '

    No products available

    ' ); // Output: // //
    name ?>
    // //

    No products available

    // ```     ### Authentication Directives ```php theme={null} use Lyger\Livewire\Directives; // @auth directive $html = Directives::auth( 'Dashboard', 'Login' ); // Output: // check()): ?> // Dashboard // // Login // ``` ```php theme={null} // @can directive $html = Directives::can('edit-posts', ''); // Output: // can('edit-posts')): ?> // // ``` ### Switch Directive ```php theme={null} use Lyger\Livewire\Directives; $html = Directives::switch('$status', [ 'pending' => 'Pending', 'approved' => 'Approved', 'rejected' => 'Rejected', ], 'Unknown'); // Output: // // // Pending // // // Approved // // // Rejected // // // Unknown // ``` ## Shared Data Share data across all views: ```php theme={null} use Lyger\Livewire\View; // Share data globally View::share('siteName', 'My Application'); View::share('currentYear', date('Y')); // Access in any view $siteName = View::getShared('siteName'); ``` ```php theme={null} ``` ## Error Handling Blade automatically handles template errors: ```php theme={null} use Lyger\Livewire\Blade; $html = Blade::render('non-existent-view', []); // Output: "View not found: non-existent-view" ``` ```php theme={null} // Catch rendering errors try { $html = Blade::render('problematic-view', ['data' => $data]); } catch (\Throwable $e) { // Output: "Error rendering view: [error message]" error_log($e->getMessage()); } ``` ## Integration with Livewire Use Blade to render Livewire component views: ```php theme={null} namespace App\Livewire; use Lyger\Livewire\Component; use Lyger\Livewire\Blade; class UserProfile extends Component { public string $name = ''; public string $email = ''; public function render(): string { return Blade::render('livewire.user-profile', [ 'name' => $this->name, 'email' => $this->email, ]); } } ``` ```php theme={null}

    ``` ## Best Practices Use a consistent directory structure: ``` resources/views/ ├── layouts/ │ ├── app.php │ └── admin.php ├── partials/ │ ├── header.php │ └── footer.php ├── components/ │ └── card.php └── pages/ ├── home.php └── about.php ``` Always escape user-generated content to prevent XSS: ```php theme={null}

    ```     Avoid complex business logic in templates. Use controllers or components for data processing. Extract repeated markup into partials for better maintainability. Organize views in subdirectories and use dot notation for cleaner code: ```php theme={null} Blade::render('admin.users.index', $data); // Instead of: Blade::render('admin/users/index', $data); ```     ## Practical Examples ### Complete Page Example ```php Controller theme={null} get(); $related = Post::where('category', $post->category) ->limit(3) ->get(); return Blade::render('blog.show', [ 'post' => $post, 'comments' => $comments, 'related' => $related, ]); } } ``` ```php View Template theme={null} title) ?>

    title) ?>

    By author ?> created_at)) ?>
    content ?>

    Comments

    Related Posts

    $relatedPost]) ?>
    ``` ```php Comment Partial theme={null}
    ```     ## API Reference ### Blade Class | Method | Description | | ----------------------------- | ----------------------------- | | `setViewsPath($path)` | Sets the views directory path | | `setCachePath($path)` | Sets the cache directory path | | `render($view, $data)` | Renders a view with data | | `renderComponent($component)` | Renders a component | | `include($view, $data)` | Includes a partial view | | `yield($section)` | Outputs section content | | `start($section)` | Starts a section | | `end()` | Ends a section | | `extends($layout)` | Extends a layout | | `component($class, $props)` | Renders component class | | `each($items, $view, $key)` | Renders view for each item | ### View Class | Method | Description | | --------------------------- | ---------------------------- | | `make($view, $data)` | Creates and renders a view | | `share($key, $value)` | Shares data across all views | | `getShared($key, $default)` | Gets shared data | ### Directives Class | Method | Description | | ---------------------------------------------- | -------------------------- | | `if($condition, $content)` | Conditional rendering | | `foreach($items, $item, $content)` | Loop through items | | `forelse($items, $item, $content, $empty)` | Loop with empty fallback | | `for($init, $condition, $increment, $content)` | For loop | | `while($condition, $content)` | While loop | | `switch($value, $cases, $default)` | Switch statement | | `isset($var, $content)` | Check if variable is set | | `empty($var, $content)` | Check if variable is empty | | `auth($content, $guest)` | Authentication check | | `can($permission, $content)` | Authorization check |