laravel中设置自定义视图指令流程步骤及注意事项

2023-06-01 视图 自定义 指令

通常我们在视图模板中编写复杂的逻辑,看上去显得很杂乱,

那么使用自定义的模板Directives,可以简化你的视图逻辑,编写出更优雅的代码,

Laravel Blade是一种将其特殊语法编译成PHP和HTML的模板引擎。

其特殊语法指令,指令是加糖功能,在其后隐藏杂乱的代码。

模板包含大量的内置指令,

例如@foreach/@if/@section/@extends等等,内置的指令对于做一个简单的项目足以,

但是当你在代码中编写重复复杂的功能时,那么自定义模板指令或许可以帮你优化你的视图结构。


Blade 允许你自定义命令,你可以使用 directive 方法注册命令


laravel5.5+版本指令新特性

在使用自定义的模板指令的时候,大多数只是某种形式的条件,

这些要求我们需要注册三个独立指令,if/else/endif,目前Laravel5.5已经支持简化条件指令,

例如下面的实例,模板可以使用admin/else/endadmin


public function boot()
{
 \Blade::if('admin', function () {
  return auth()->check() && auth()->user()->isAdmin();
 });
}


测试demo

需求:

前端视图中需要统一日期格式


这点跟我上一篇博文一样 (laravel中设置视图共享变量流程步骤)

也需要在 AppServiceProvider 中进行注册。


<?php
namespace App\Providers;
use Illuminate\Support\ServiceProvider;
class AppServiceProvider extends ServiceProvider
{
    /**
     * Bootstrap any application services.
     *
     * @return void
     */
    public function boot()
    {
        //
           Blade::directive('datetime', function($datetime){  
               return date('Y-m-d H:i:s', $datetime);
           });
    }


视图中调用:


    @datetime( 1629693558 )

效果图就不接了, 跟我上一篇一样,有兴趣的可以自行去看看

以这种方式定义的指令加载成功,可以在任何模板中使用


注意事项

第一点

不能直接访问自定义指令中传递的多个参数,需要将其遍历出来

像 array() list() 这种并不是一个函数,而是一种语言结构


第二点

一定要时刻记住需要过滤输出,一般使用{{}}时候,Blade已经预先执行了过滤操作,

为了避免恶意用户将js代码注入到站点,一定要转义HTML,

可以使用Laravel自带的函数e(),也相当于htmlentities()


第三点

每次添加或修改自定义模板指令之后,

一定要先清除缓存视图模板,可以使用clear Artisan

php artisan view:clear


相关文章