Laravel Nova 中文文档资源工具
总览#
资源工具与 工具 很类似；然而，资源工具并不会显示在 Nova 的侧边栏，而是显示在特定的资源详情页。 与 Nova 工具一样，资源工具具有高度的可自定义性，并且主要由一个完全由你控制的单文件 Vue 组件构成。
## 定义工具
可以使用 Artisan 命令使用 nova：resource-tool 生成资源工具。默认情况下，所有新工具都将放置在应用程序的 nova-components 目录中。使用 nova：resource-tool 命令生成工具时，传递给该命令的工具名称应遵循 Composer 供应商/程序包格式。因此，如果我们要构建 Stripe 检查器工具，则可以运行以下命令：
artisan nova：resource-tool acme / stripe-inspector生成工具时，Nova 会提示您安装工具的 NPM 依赖项，编译其资产并更新应用程序的 composer.json 文件。所有自定义工具都已在您的应用程序中注册为 Composer “路径” 存储库。
Nova 资源工具包括构建工具所需的所有支架。每个工具甚至都包含其自己的 composer.json 文件，并准备与 GitHub 上的世界或您选择的源代码控制提供商共享。
## 注册工具
Nova 资源工具可能已在资源的 fields 方法中注册。此方法返回资源可用的字段数组。要注册您的资源工具，请将您的工具添加到此方法返回的字段数组中：
use Acme\StripeInspector\StripeInspector;
/**
* 获取资源显示的字段
*
* @param \Illuminate\Http\Request $request
* @return array
* /
public function fields(Request $request)
{
return [
ID::make('ID', 'id')->sortable(),
StripeInspector::make()->canSee(function ($request) {
return false;
}),
];
}### 工具选项
通常，你应该允许工具的使用者可以自定义工具的配置选项。可以通过在工具类上公开方法来做到这一点。这些方法可以调用工具的基础 withMeta 方法，以将信息添加到工具的元数据中，该元数据将在您的 Tool.vue 组件中可用。withMeta 方法接受键 / 值选项数组：
<？php
namespace Acme\StripeInspector;
use Laravel\Nova\ResourceTool;
class StripeInspector extends ResourceTool
{
/**
* 获取资源工具的显示名称
*
* @return string
*/
public function name()
{
return 'Stripe Inspector';
}
/**
* 表示条纹检查员应允许退款
*
* @return $this
*/
public function issuesRefunds()
{
return $this->withMeta(['issuesRefunds' => true]);
}
/**
* 获取资源工具的组件名称
*
* @return string
*/
public function component()
{
return 'stripe-inspector';
}
}## 建筑工具
Nova 生成的每个工具都包括其自己的服务提供商和 “工具” 类。以 stripe-inspector 工具为例，该工具类位于 src / StripeInspector.php。
该工具的服务提供程序也位于该工具的 src 目录中，并且已在该工具的 composer.json 文件中注册，以便可以由 Laravel 框架自动加载。
### 授权
如果您只想将给定工具公开给某些用户，则可以将 canSee 方法链接到工具的注册上。canSee 方法接受一个闭包，该闭包应返回 true 或 false。闭包将收到传入的 HTTP 请求：
使用Acme \ StripeInspector \ StripeInspector;
/ **
*获取资源显示的字段。
*
* @param \ Illuminate \ Http \ Request $ request
* @返回数组
* /
公共功能字段(请求$ request)
{
返回[
ID :: make('ID'，'id')-> sortable()，
StripeInspector :: make()-> canSee(function($ request){
返回false；
})，
];
}### 路由
通常，您将需要定义工具调用的 Laravel 路线。 Nova 生成您的工具时，它会创建一个 routes / api.php 路由文件。如果需要，您可以使用此文件来定义工具所需的任何路径。
工具的 ToolServiceProvider 在路由组内自动定义此文件中的所有路由。路由组指定该组内的所有路由应接收 / nova-vendor / tool-name 前缀，其中 tool-name 是工具的 “kebab-case” 名称。因此，例如，/ nova-vendor / stripe-inspector。您可以随意修改此路由组定义，但要确保您的 Nova 工具将与其他 Nova 软件包共存。
路由授权
在为您的工具构建路由时，您应该始终 ** 使用 Laravel 门或策略向这些路由添加授权。
### 资产
Nova 生成您的工具时，将为您生成 resources / js 和 resources / sass 目录。这些目录包含工具的 JavaScript 和 Sass 样式表。这些目录中感兴趣的主要文件是：resources / js / components / Tool.vue 和 resources / sass / tool.scss。
Tool.vue 文件是包含工具前端的单文件 Vue 组件。您可以根据需要从该文件中自由构建工具。您的工具可以使用 Axios 发出 HTTP 请求，Axios 可以在全球使用。另外，moment.js 和 underscore.js 库是全局可用的。
#### 资源工具属性
资源工具的 Tool.vue 组件将接收多个 Vueprops：resourceName，resourceId 和 field。resourceId 属性包含工具当前附加到的资源的主键。向控制器发出请求时，可以使用 resourceId。field 属性提供对可能可用的任何工具选项的访问：
const issueRefunds = this.field.issuesRefunds;#### 注册资产
您的 Nova 工具的服务提供商会注册您工具的已编译资产，以便它们可用于 Nova 前端：
/ **
*引导所有应用程序服务。
*
* @返回无效
* /
公共功能boot()
{
$ this-> app-> booted(function(){
$ this-> routes();
});
Nova :: serving(function(ServingNova $ event){
Nova :: script('stripe-inspector'，__DIR __。'/ .. / dist / js / tool.js');
Nova :: style('stripe-inspector'，__DIR __。'/ .. / dist / css / tool.css');
});
}** JavaScript 引导程序和路由 **
您的组件被引导并注册在
resources / js / tool.js文件中。您可以根据需要随意修改此文件或在此处注册其他组件。
编译资源#
Nova 创建资源工具的同时生成一个 webpack.mix.js 文件。你可以使用 NPM dev 和 prod 命令进行构建：
// 在本地开发环境下编译资源...
npm run dev
// 编译并压缩资源...
npm run prod此外，你还可以运行 NPM watch 命令在文件改动时自动编译：
npm run watch本译文仅用于学习和交流目的，转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议，如果我们的工作有侵犯到您的权益，请及时联系我们。
关于 LearnKu
粤公网安备 44030502004330号
推荐文章：