1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/GLUESTICK-vue-img-cutter

Клонировать/Скачать
Внести вклад в разработку кода
Синхронизировать код
Отмена
Подсказка: Поскольку Git не поддерживает пустые директории, создание директории приведёт к созданию пустого файла .keep.
Loading...
README.md

vue-img-cutter

中文文档

Vue-img-cutter — это плагин для кадрирования изображений, который можно использовать для поворота, масштабирования и обрезки изображений любого размера.

GitHub stars GitHub forks npm npm

Возможности:


  • Для IE9+, MSEdge, Chrome, Firefox;
  • Можно настроить в строке или модально;
  • Поворот, масштабирование;
  • Обрезка по масштабу;
  • Кадрирование исходного изображения;
  • Кадрирование удалённых изображений.

Скриншот:


Скриншот

Демо:


https://www.ihtmlcss.com/demo/dist/#/croptool

Git:


Github: https://github.com/acccccccb/vue-img-cutter;

码云: https://gitee.com/GLUESTICK/vue-img-cutter.

Если этот проект вам полезен, пожалуйста, поставьте мне звезду :)

Метод использования:


  1. Установить:
npm install vue-img-cutter@2 --save-dev # для vue2
npm install vue-img-cutter@3 --save-dev # для vue3
  1. Импортировать ImgCutter.vue:
import ImgCutter from 'vue-img-cutter'
export default {
        components:{
            ImgCutter
        },
...
}
  1. Написать код в шаблоне:
<ImgCutter v-on:cutDown="cutDown"></ImgCutter>
  1. Solt:
<ImgCutter v-on:cutDown="cutDown">
    <template #open>
        <button>Choose image</button>
    </template>
</ImgCutter>
  1. Этот метод совместим с IE9, его также можно использовать для обрезки междоменных изображений:
  • Создать объект (имя, src, ширина и высота обязательны).
  • this.$refs.imgCutterModal.handleOpen(The Object).
// Объект выглядит так.
let obj = {
    name: '1.jpg', //Image name
    src: 'http://url/1.jpg', // Image url
    //width:200,//Image width  remove in 2.1.9+
    //height:200,//Image height remove in 2.1.9+
};
ForIE9:function(){
    // Сначала нужно создать объект с именем и src.
    // Затем вызвать handleOpen(obj) и передать obj.
    this.$refs.imgCutterModal.handleOpen({
        name:"image.jpg",
        src:"http://imageServ.com/image.jpg",
    });
}

Описание параметров:

Атрибут Эффект Тип Требуется По умолчанию
isModal Модальный режим Boolean Нет true
showChooseBtn Показать кнопку выбора Boolean Нет true
lockScroll Блокировка прокрутки при отображении модального окна Boolean Нет true
label Текст кнопки String Нет 选择图片
boxWidth Ширина инструмента Number Нет 800
boxHeight Высота инструмента Number Нет 400
cutWidth Ширина поля выделения Number Нет 200
cutHeight Атрибут Эффект Тип
--- --- --- --- ---
cutDown Обрезка изображения Функция Да Объект
error Выбрасывание ошибки Функция Нет Объект ошибки

Таблица: Hook function

Высота поля выбора Число Нет 200
Инструмент Показать панель инструментов Булево Нет
ToolBgc Цвет фона панели инструментов Строка (например, "#fff") Нет
SizeChange Разрешить изменение размера Булево Нет
MoveAble Разрешить смену позиции Булево Нет
OriginalGraph Обрезать исходное изображение Булево Нет
CrossOrigin Изображение с кросс-происхождением Булево Нет
crossOriginHeader Установить заголовок кросс-происхождения Строка Нет
Rate Соотношение сторон Строка (например, "4:3") Нет
WatermarkText Текст водяного знака Строка Нет
WatermarkTextFont Размер шрифта водяного знака Строка Нет
WatermarkTextColor Цвет шрифта водяного знака Строка Нет
WatermarkTextX Позиция x водяного знака Число Нет
WatermarkTextY Позиция y водяного знака Число Нет
SmallToUpload Если размер изображения меньше определённого размера, вернуть файл. SizeChange должен быть ложным Булево Нет
SaveCutPosition Сохранить последнюю позицию и размер обрезки Булево Нет
ScaleAble Разрешить масштабирование изображения Булево Нет
imgMove Разрешить перемещение изображения Булево Нет
toolBoxOverflow Разрешить выход панели инструментов за пределы изображения Булево Нет
index Вернуть результат Любой Нет
previewMode Возвращать результаты в любое время, в случае проблем с производительностью установите значение false Булево Нет
fileType Возвращаемый тип файла (png / jpeg / webp) Строка Нет
quality Качество изображения Число Нет
accept Принимать типы файлов Строка Нет
:-- :-- :-- :--
onPrintImg Print image to canvas Функция Нет
onClearAll Clear all Функция Нет
onImageLoadComplete Image loading completed Функция Нет
onImageLoadError Image loading failed Функция Нет

Slot (You can use slot="slot name" to custom button):

Slot name Эффект
open Choose btn
openImgCutter Choose btn
choose Choose btn(in tool)
cancel Cancel btn
confirm Confirm btn
ratio Toolbar ratio
scaleReset Toolbar reset scale
turnLeft Toolbar turn left
turnRight Toolbar turn right
reset Toolbar reset
flipHorizontal Toolbar flip horizontal
flipVertically Toolbar flip vertically

Return @cutDown:


Атрибут Описание
fileName Имя файла
file Файл (некоторые версии IE не поддерживают)
blob Blob (некоторые версии IE не поддерживают)
dataURL dataURL

Development:

  • Оригинальная картинка
  • Зеркало

Donation:

微信 支付宝

Update log:

3.0.5

3.0.4

3.0.3

3.0.2

  • bugfix: #note_11139264.
  • bugfix: #64.
  • Новый prop (quality): A Number between 0 and 1 indicating the image quality.

3.0.1

  • bugfix: #I4SDOE.
  • bugfix: dialog-footer default height 40px.
  • bugfix: width height x и y convert to int.

3.0.0

  • chore: Build tool changed to vue3.

2.2.6

2.2.5

  • Bugfix: remove this in template.

2.2.4

  • Новый prop (toolBoxOverflow): Allow tool box out of picture range, default: true.

2.2.3

  • Bug fix: When you set rate, the control-box didn't reach the expected position #I3OXMW.

2.2.2

  • Новый prop (imgMove): Allow move img, default: true.

2.2.1

  • Новый prop (fileType): Return file type, default: png.

2.2.0

  • Новый prop (index): Return result with index.
  • Новый prop (previewMode): Return results at any time, in case of performance problems, set this to false.
  • Fix Bug: Update style.

2.1.10

  • Новые функции:
    • saveCutPosition: Save last cut position and size.
    • scaleAble: Able/Disable scale image.

2.1.9

  • Crop original image not need imageObj.width и imageObj.height.

2.1.8

  • Новые функции: smallToUpload, If choose image size less then defined Size, return file. sizeChange must be false. #20.

2.1.7

  • Fix bug: #21 cropPicture() missed params.

2.1.6

  • Добавить новые функции hook: onClearAll, onPrintImg, onChooseImg.

Комментарии ( 0 )

Вы можете оставить комментарий после Вход в систему

Введение

Простой в использовании плагин для обрезки изображений Vue, поддерживает обрезку и изменение размера изображений, а также их перемещение вверх, вниз, влево и вправо. Поддерживается фиксированный масштаб и фиксированный размер. Возможна обрезка удалённого изображения. Для реализации функции обрезки требуется совсем немного кода. Также можно настр... Развернуть Свернуть
MIT
Отмена

Обновления

Пока нет обновлений

Участники

все

Недавние действия

Загрузить больше
Больше нет результатов для загрузки
1
https://api.gitlife.ru/oschina-mirror/GLUESTICK-vue-img-cutter.git
git@api.gitlife.ru:oschina-mirror/GLUESTICK-vue-img-cutter.git
oschina-mirror
GLUESTICK-vue-img-cutter
GLUESTICK-vue-img-cutter
master