scalexy/filament-spatie-media-library-croppie

使用 spatie media library 和 croppie.js 进行图像上传的 filament 表单字段

v0.1.5 2023-08-12 06:54 UTC

This package is auto-updated.

Last update: 2024-09-12 09:08:59 UTC


README

Latest Version on Packagist Total Downloads

安装

您可以通过 composer 安装此包(无需单独安装 croppie,因为其资产已打包)

composer require scalexy/filament-spatie-media-library-croppie

要在 filament 外部使用(例如,仅使用表单包),请将 js 和 css 添加到您的 vite(或 mix)配置中

@vite([
    'vendor/scalexy/filament-spatie-media-library-croppie/resources/dist/js/filament-spatie-media-library-croppie.js',
    'vendor/scalexy/filament-spatie-media-library-croppie/resources/dist/css/filament-spatie-media-library-croppie.css',
    ...
])

此字段扩展了并因此具有 Filament Spatie Media Library 插件 字段的全部功能。

SpatieMediaLibraryCroppie::make('image')
    ->boundaryWidth('100%')
    ->boundaryHeight('600'),

使用 boundaryWidthboundaryHeight 设置模态中图像区域的宽度和高度。上面的值是默认值。

SpatieMediaLibraryCroppie::make('image')
    ->viewportWidth('400')
    ->viewportHeight('400'),

使用 viewportWidthviewportHeight 设置裁剪器的宽度和高度。上面的值是默认值。

SpatieMediaLibraryCroppie::make('image')
    ->showZoomer(),

可以通过调用 showZoomer 来显示模态中图像下方的缩放条。

SpatieMediaLibraryCroppie::make('avatar')
    ->avatar(),

我们可以使用 avater 方法使 croppie 变为圆形。

Croppie::make('background')
    ->modalSize('6xl')
    ->modalHeading("Crop Background Image")

可以使用 modalSize 方法自定义模态大小。要设置标题,请使用 modalHeading

设置图像质量和格式

如果您的裁剪图像非常大(见:[Foliotek/Croppie#444]),您可以使用 imageFormat()imageQuality() 方法修改生成的图像。

SpatieMediaLibraryCroppie::make('image')
    ->imageFormat('jpeg')
    ->imageQuality(0.7);

默认值为

  • imageQuality(0.9)
  • imageFormat('png')

许可证

MIT 许可证(MIT)。有关更多信息,请参阅 许可证文件

致谢

这是一个 josefbehr/FilamentCroppie 的分支,后者又是 nuhel/FilamentCroppie 的分支,它扩展并适应了使用 spatie/media-library,并通过 npm 安装 croppie。

变更日志

v0.0.1

  • josefbehr/filament-croppie 分支并重命名所有内容