README

这是一个分支自 mtrim//yii2-image-cutter

功能

• Bootstrap5
• 上传图片
• 裁剪图片
• 使用 Imagine

Composer

安装此扩展的首选方法是使用 Composer.

运行 php composer.phar require --prefer-dist calcio/yii2-image-cutter "dev-master"

或向您的 composer.json 文件的 require 部分添加 "calcio/yii2-image-cutter": "dev-master"

使用方法

• 添加到模型行为

    use calcio\cutter\behaviors\CutterBehavior;

    public function behaviors()
    {
        return [
            'image' => [
                'class' => CutterBehavior::className(),
                'attributes' => 'image',
                'baseDir' => '/uploads/crop',
                'basePath' => '@webroot',
            ],
        ]
    }
    
    public function rules()
    {
        return [
            ['image', 'file', 'extensions' => 'jpg, jpeg, png', 'mimeTypes' => 'image/jpeg, image/png'],
        ];
    }

参数

• integer attributes required (string) - 图片属性
• integer baseDir required - 基础目录
• integer basePath required - 基础路径
• integer quality = 92 - 裁剪结果质量

• 在视图中使用

无客户端验证

    <div class="form-group">
        <label class="control-label">Image</label>
        <?= \calcio\cutter\Cutter::widget([
            'model' => $model,
            'attribute' => 'image'
        ]); ?>
    </div>

或

带客户端验证

    <?= $form->field($model, 'image')->widget(\calcio\cutter\Cutter::className(), [
        //options
    ]); ?>

• 在视图中使用

获取图片 URL

    $model->getImg(100);
    $model-> getImgOrigin();

小部件方法选项

• model (string) (obligatory)

定义将用于创建表单输入字段的模型。

• attribute (string) (obligatory)

定义将用于创建表单输入字段的模型属性。

• useWindowHeight (bool) (optional)

使用当前窗口的高度进行表单图片裁剪

• imageOptions (array) (optional)

包含将添加到图片字段的选项列表，用于在模态框中定义裁剪数据。格式应为 ['option' => 'value']。

• cropperOptions (array) (optional)

包含将在创建裁剪对象时添加到 JavaScript 中的选项列表。有关可以添加哪些选项的更多信息，请阅读此网页。