developit/yii2-jcrop

yii2 图像裁剪扩展

安装数: 1,487

依赖关系: 0

建议者: 0

安全: 0

星标: 10

关注者: 2

分支: 6

开放问题: 2

类型:yii2-extension

1.1.4 2019-09-06 16:46 UTC

This package is auto-updated.

Last update: 2020-06-06 18:18:33 UTC


README

yii2 图像裁剪扩展

安装

安装此扩展的首选方式是通过 composer.

运行以下命令之一

php composer.phar require --prefer-dist developit/yii2-jcrop "*"

或者将以下内容添加到你的 composer.json 文件的 require 部分中。

"developit/yii2-jcrop": "*"

使用

扩展安装完成后,只需在你的代码中使用它即可

use developit\jcrop\Jcrop;
<?= $form->field($model, 'avatar')->widget(Jcrop::className(), [
    'uploadUrl' => Url::toRoute('/user/avatar'),
])->label(false) ?>

小部件具有以下属性

名称 描述 默认值 必需
uploadParameter 上传参数名称 file
width 裁剪后图像的最终宽度 200
height 裁剪后图像的最终高度 200
uploadUrl 上传和裁剪图像的URL
maxSize 最大文件大小(字节) 2097152
cropAreaWidth 预览框的宽度 300
cropAreaHeight 预览框的高度 300
extensions 允许的文件扩展名(字符串)。 jpeg, jpg, png, gif

在 UserController

    public function actions()
    {
        return [
            'avatar' => [
                'class' => 'developit\jcrop\actions\Upload',
                'url' => '/common/files/',
                'path' => Yii::getAlias('@files'),
                'name' => Yii::$app->user->id
            ]
        ];
    }

操作有以下参数

名称 描述 默认值 必需
path 裁剪后保存图像的路径
url 下载的图像可用的URL。
name 上传的文件名。
uploadParameter Upload参数名称。它必须与小部件中类似参数的值匹配。 file
maxSize 最大文件大小(字节)。它必须与小部件中类似参数的值匹配。 2097152
extensions 允许的文件扩展名(字符串)。它必须与小部件中类似参数的值匹配。 jpeg, jpg, png, gif
width 裁剪后图像的最终宽度。它必须与小部件中类似参数的值匹配。 200
height 裁剪后图像的最终高度。它必须与小部件中类似参数的值匹配。 200

操作如下

screenshot screenshot

许可证

yii2-jcrop 是一个由 Ehsan Rezaei(http://www.developit.ir)修改的开源项目,许可证为 GPL-3.0。它基于 https://github.com/budyaga/yii2-cropper 开发和修改。