developit / yii2-jcrop
yii2 图像裁剪扩展
1.1.4
2019-09-06 16:46 UTC
Requires
- bower-asset/jcrop: =0.9.12
- bower-asset/simple-ajax-uploader: @dev
- yiisoft/yii2: *
- yiisoft/yii2-imagine: *
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 | 否 |
操作如下
许可证
yii2-jcrop 是一个由 Ehsan Rezaei(http://www.developit.ir)修改的开源项目,许可证为 GPL-3.0。它基于 https://github.com/budyaga/yii2-cropper 开发和修改。