apimediaru/nova-media-library

Laravel Nova 字段。

1.0.2-beta.9 2023-10-17 17:18 UTC

README

Laravel Nova 包提供了前端 UI 和字段,具有一些有用的选项,用于我们使用的库的分支和修改 spatie\laravel-medialibrary。有关如何使用基础媒体库的文档可以在此处找到 这里

安装

composer require apimediaru/nova-media-library

用法

步骤 1:注册模型集合和转换

use APIMedia\NovaMediaLibrary\Http\Services\MediaLibraryService;
use Spatie\MediaLibrary\InteractsWithMedia;
use Spatie\MediaLibrary\HasMedia;
use Spatie\Image\Manipulations;


class ExampleModel extends Model implements HasMedia
{
    use InteractsWithMedia;
    
    /**
     * Register media collections
     */
    public function registerMediaCollections(): void
    {
        $this->addMediaCollection('gallery');
    }

    /**
     * Register media conversions
     * 
     * @throws \Spatie\Image\Exceptions\InvalidManipulation
     */
    public function registerMediaConversions(Media $media = null): void
    {
        // Adds 'thumbnail' conversions attached to all collections
        MediaLibraryService::addLibraryConversions($this);

        $this->addMediaConversion('thumb')
            ->fit(Manipulations::FIT_CROP, 150, 150)
            ->performOnCollections('gallery');

        $this->addMediaConversion('medium')
            ->fit(Manipulations::FIT_MAX, 720, 720)
            ->performOnCollections('gallery');

        $this->addMediaConversion('large')
            ->fit(Manipulations::FIT_MAX, 1920, 1920)
            ->performOnCollections('gallery');
    }
}

步骤 2:添加 nova 字段。集合键解析为 nova 默认字段属性,因此您可以为 make 方法省略第二个参数。

use Laravel\Nova\Http\Requests\NovaRequest;


class ExampleResource extends Resource {
    /**
     * Get the fields displayed by the resource.
     *
     * @param  \Illuminate\Http\Request  $request
     * @return array
     */
    public function fields(Request $request)
    {
        return [
            // ... 
            MediaField::make(__('gallery'), 'gallery'),
        ];
    }
}

限制媒体文件数量

public function fields(Request $request)
    {
        return [
            // ... 
            MediaField::make(__('gallery'), 'gallery')
                ->limit(10),
        ];
    }

禁用/启用对某些集合的重复检查

public function fields(Request $request)
    {
        return [
            // ... 
            MediaField::make(__('gallery'), 'gallery')
                ->checkDuplicates(false),
        ];
    }

Nova 组件

  • 拖放单个或多个文件进行上传
  • ctrl+A 切换所有文件选择
  • 使用 ctrlshiftctrl+shift 修饰符点击缩略图以选择多个媒体文件,就像在默认文件资源管理器中一样
  • 使用缩略图点击上下文菜单执行多个操作
  • 通过拖放单个或多个文件更改显示顺序