imgAreaSelect 中文文档帮助说明

2020-05-23 06:08:16易采站长站整理



setOptions



setOptions(newOptions)


--设置插件选项


参数:


newOptions – 选项配置对象(一般是JSON对象)




getSelection



getSelection([noScale])


 --获取当前的选区


 


参数:


noScale (可选) – 如果设置为真,那么对于返回的选区不进行缩放操作。


 


返回:


选择区域里的对象




setSelection



setSelection(x1, y1, x2, y2, [noScale])


  --设置当前选择区域


 


参数:


x1 – 选择区域左上角X坐标


y1 – 选择区域左上角Y坐标


x2 – 选择区域右下角X坐标


y2 – 选择区域右下角Y坐标


noScale (可选) –若设为真,则不会对图像进行缩放


 


注意:此方法只在插件内设置选择区域,并不会马上观察到选区的变化,如果需要立马显示更改后的区域,必须在使用setSelect()函数后就调用update()函数,且让show选项为true.




cancelSelection



cancelSelection()


  --取消当前的选择


 


注意:这个方法会隐藏”选择/未选择”区域,所以不必调用update()函数。




update



update([resetKeyPress])


--更新插件配置


 


参数:


resetKeyPress (可选) – 如果设成false,此实例的按键将复位(即不可用)


 


二、简单实例
1、宽度或者高度限制

minWidth、minHeight、maxWidth以及maxHeight选项允许你设置选区的范围。在这个例子中,图像的最大范围将限制为200x150px。


$(document).ready(function () {


$(‘#ladybug_ant’).imgAreaSelect({ maxWidth: 200, maxHeight: 150, handles: true });


});


2、固定高宽比

配置aspectRatio选项就可以了,这里将其设置成”4:3”:


$(document).ready(function () {


$(‘#bee’).imgAreaSelect({ aspectRatio: ‘4:3’, handles: true });