Blade 允许你自定义命令,你可以使用 directive 方法注册命令。下面这篇文章主要给大家总结介绍了关于Laravel框架中自定义模板指令的相关资料,文中通过示例代码介绍的非常详细,需要的朋友可以参考借鉴,下面来一起看看吧
介绍
最近在学习laravel,在Laravel框架中使用模板的一种方法就是通过控制器布局,通常我们在视图模板中编写复杂的逻辑,看上去显得很杂乱,那么使用自定义的模板Directives,可以简化你的视图逻辑,编写出更优雅的代码,Laravel Blade是一种将其特殊语法编译成PHP和HTML的模板引擎。其特殊语法指令,指令是加糖功能,在其后隐藏杂乱的代码。模板包含大量的内置指令,例如@foreach/@if/@section/@extends等等,内置的指令对于做一个简单的项目足以,但是当你在代码中编写重复复杂的功能时,那么自定义模板指令或许可以帮你优化你的视图结构。
下面话不多说了,来一起看看详细的介绍吧。
自定义一个简单的模板指令
$expression参数是可选的
\Blade::directive('directive_name', function ($expression) { return $expression; });
视图中用法Demo
<p>@hello('World')</p>
声明自定义模板指令的位置AppServiceProvider.php
<?php namespace App\Providers; use Illuminate\Support\Facades\Blade; use Illuminate\Support\ServiceProvider; class AppServiceProvider extends ServiceProvider { /** * Perform post-registration booting of services. * * @return void */ public function boot() { Blade::directive('hello', function ($expression) { return "<?php echo 'Hello ' . {$expression}; ?>"; }); } /** * Register bindings in the container. * * @return void */ public function register() { // } }
以这种方式定义的指令加载成功,可以在任何模板中使用
注意事项
第一点
不能直接访问自定义指令中传递的多个参数,需要将其遍历出来
<p>@greet('Hi', 'Hammad')</p> \Blade::directive('hello', function ($expression) { list($greet, $name) = explode(', ', $expression); return "<?php echo {$greet} . ' ' . {$name}; ?>"; });
像 array() list() 这种并不是一个函数,而是一种语言结构
第二点
一定要时刻记住需要过滤输出,一般使用{{}}时候,Blade已经预先执行了过滤操作,为了避免恶意用户将js代码注入到站点,一定要转义HTML,可以使用Laravel自带的函数e(),也相当于htmlentities()
\Blade::directive('hello', function ($expression) { return "<?php echo 'Hello ' . e({$expression}); ?>"; });
第三点
每次添加或修改自定义模板指令之后,一定要先清除缓存视图模板,可以使用clear Artisan
php artisan view:clear
Laravel5.5新特性
在使用自定义的模板指令的时候,大多数只是某种形式的条件,这些要求我们需要注册三个独立指令,if/else/endif,目前Laravel5.5已经支持简化条件指令,例如下面的实例,模板可以使用admin/else/endadmin
public function boot() { \Blade::if('admin', function () { return auth()->check() && auth()->user()->isAdmin(); }); }
总结
Atas ialah kandungan terperinci Laravel框架中自定义模板指令相关总结. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!