ngangchill / blade
This is a standalone package for laravel blade with some extra function such as partial, some usefull directives.
Requires
- php: >=5.5.9
- illuminate/view: ~5.2.0
This package is not auto-updated.
Last update: 2024-12-16 16:25:36 UTC
README
This is a standalone package for laravel blade with some extra function such as partial, some usefull directives & extensions.Thanks for using.
use:
$pathsToTemplates = __DIR__ . '/views';
$pathToCompiledTemplates = __DIR__ . '/compiled';
//fire laravel blade statically
Ngangchill\Blade\Blade::fire()->setPaths($pathsToTemplates, $pathToCompiledTemplates);
// or
$app = new Ngangchill\Blade\Blade();
$app->setPaths($pathsToTemplates, $pathToCompiledTemplates);
ALL DONE done... lets play with laravel Blade Templates. Now you can use every Blade functions as documented in laravel bladetemplate docs.
Example:
$name = 'Skyfall';
echo View::make('index', ['name' => $name])->render();
// Add a location to the array of view locations.
View::addLocation($newPath);
// lets register a new directives
Blade::directive('hellow', function ($name) {
return "<?php echo 'Hellow <em>' . $name . '</em>'; ?>";
});
// For more info read laravel Blade Template Docs
KEEP IN MIND: Special situation [if you want to use Illuminate\Support\Facades\Blade ]
If you initiate blade class Ngangchill\Blade\Blade::fire()->setPaths('viewPath', 'compiledPath') than nothing to worry. But if you use an use statment for Ngangchill\Blade\Blade class Than you have be carefull to avoid unwanted error by setting an alias for Ngangchill\Blade\Blade class or adding a trilling slash '' before Illuminate\Support\Facades\Blade.See the example below
To use laravel blade facades call it as -
use Ngangchill\Blade\Blade;
//fire laravel blade
Blade::fire()->setPaths($pathsToTemplates, $pathToCompiledTemplates);
//Now call **Illuminate\Support\Facades\Blade** as \Blade::()....
\Blade::directive('datetime', function ($expression) {
return "<?php echo $expression->format('m/d/Y H:i'); ?>";
});
or
Set an alias:
use Ngangchill\Blade\Blade as ViewFactory;
//then
ViewFactory::fire()->setPaths(......);
Blade::directive('datetime', function ($expression) {
return "<?php echo $expression->format('m/d/Y H:i'); ?>";
});
Otherwise it may throughs unwanted error.
Read More on laravel.com
Extra features:
Creating a Partial
We use the @render('block-to-render')
directive to render a block of content that was provided via the respective @block
directive. Note that we can also provide a default value.
<div class="panel"> <div class="panel-heading"> <h3 class="panel-title">@render('title', 'Default Title')</h3> </div> <div class="panel-body"> @render('body', 'Default Body') </div> </div>
View a Partial
Partials start with the @partial('path.to.view')
directive, which accepts the view you want the partial to extend from, and end with the @endpartial
directive.
@partial('partials.panel') @block('title', 'This is the panel title') @block('body') This is the panel body. @endblock @endpartial
Blocks within partials behave the same way as sections within templates. They capture a piece of data that will be rendered into the extended view.
Special thanks to crhayes
Available Directives:
@explode()
@implode()
@dd()
@dump()
@datetime()
@date()
@time()
@use()
@namespace()
@fa()