Laravel 包,使用 PHP 代码创建如表格等美观的通用视图

v2.4.2 2023-04-05 15:00 UTC

This package is auto-updated.

Last update: 2024-10-03 17:38:02 UTC


README

Laravel views

Laravel 视图

使用 TALL stack 创建美观的通用视图,如数据表格的 Laravel 包。

文档

阅读完整文档

实时示例

查看不同视图的实时示例

贡献

查看贡献指南

路线图

Laravel Views 正在积极开发,我将添加更多精彩功能和视图。

以下是即将到来的计划

  • 新的表单视图
  • 新的布局视图
  • 添加下载操作
  • 添加翻译
  • 添加链接作为 UI 辅助

升级指南

从 2.4.0 到 2.4.1

发布 blade 组件

一些内部组件已更改,如果您之前已发布这些组件以进行自定义,则将无法获得最新版本,不幸的是,您需要使用 php artisan vendor:publish --tag=views --provider='LaravelViews\LaravelViewsServiceProvider' 再次发布它们,并按需进行自定义。

从 2.2 到 2.3

缓存的视图

blade 指令已更改,您需要使用 php artisan view:clear 清除缓存的视图。

公共资产

主要资产(JS 和 CSS 文件)已更改,您需要使用 php artisan vendor:publish --tag=public --provider='LaravelViews\LaravelViewsServiceProvider' --force 再次发布公共资产。

发布 blade 组件

一些内部组件已更改,如果您之前已发布这些组件以进行自定义,则将无法获得最新版本,不幸的是,您需要使用 php artisan vendor:publish --tag=views --provider='LaravelViews\LaravelViewsServiceProvider' 再次发布它们,并按需进行自定义。

动作中的 renderIf() 方法

更新动作类中的 renderIf() 函数,添加新的 $view 参数,如下所示

<?php

namespace App\Actions;

use LaravelViews\Actions\Action;
use LaravelViews\Views\View;          // new line

class YourAction extends Action
{
    public function renderIf($item, View $view)       // add the view parameter
    {
        // your content
    }
}

发布配置文件(可选)

配置文件中已添加一些新变体,如果您之前已发布配置文件,则可以再次发布它以自定义新变体,这不会影响任何东西,因为新变体将来自默认配置文件。

从视图中移除 repository 方法(可选)

如果您的 repository() 方法返回一个未应用其他查询的查询对象,如 User::query(),则可以定义 protected $model = User::class; 代替,这是现在的默认行为,repository() 方法仍然有效,所以如果您不想更改,则不需要做任何更改。

/* Before */
public function repository(): Builder
{
    // You are using a single query
    return User::query();
}

/** After */
protected $model = User::class;