一、技术文档
1、介绍
ImgAreaSelect是一jQuery插件,它支持用户通过鼠标拖曳选择图片的一部分,非常的fashion。另外,可以在这个选择图像区域的基础上应用网站的其他一些技术,比如图片拖曳、图片编辑等。
2、基本用法
这个插件基于jQuery上通过imgAreaSelect()方法来调用,它操作的对象是HTML中<img>元素内的图像。
复制代码 代码如下:
<script type="text/javascript">
$(document).ready(function () {
$('img#photo').imgAreaSelect({
handles: true,
onSelectEnd: someFunction
});
});
</script>
如果在jQuery对象里有不止有一个img元素,那么这个插件会对里面的元素逐个应用此方法。其实这个方法不仅仅应用于img元素,它支持任何块级元素(比如有图像背景的div元素)。
与其它jQuery插件相似,这个插件可以在$(document).ready() 或者 $(window).load()句柄中初始化。
3、选项
用户在这个插件的很多方面都可以进行定制,用户通过插件选项来达到这个目的(这些选项会在插件初始化的时候起效)。这些选项包括:
选项
描述
aspectRatio
长宽比,以后在选择时候就会维持不变。
e.g. "4:3"
autoHide
如果设为true,那么在选择完后区域会消失。
Default:false
classPrefix
预先给插件元素的前缀(详见下面:5、元素与类)
Default:imgareaselect
disable
如果设置成true,这个插件将不起作用(但是图像还是可见的)
enable
如果设置成true,这个插件又将重新起作用
fadeSpeed
若设置成大于零的某个数,将"渐隐/渐现"这个插件
Default:true
handles
若设置成true,在改变大小的时候显示改变框(就是角点有些小"矩形")
Default:false
hide
若设置成true,则隐藏选择框
imageHeight
图像的真实高度(因为有可能被CSS缩放过了)
imageWidth
图像的真实宽度(因为有可能被CSS绽放过了)
instance
若设为true,imgAreaSelect()函数会返回一个对选择区域图像的一个引用,以便能够进一步使用API。(详见8、API方法)
keys
启用/关闭键盘支持(详见7、键盘支持)
Default:false
maxHeight
限制选择框(以像素为单位),设置最大、最小的高度、宽度。
maxWidth
minHeight
minWidth
movable
设置是否支持选择框移动
Default:true
parent
指定此插件默认所附加到的父元素
Default:body
persistent
若设置成true,点击选择区域外将开始一个新的选项(换言之,是否让用户只能移动/缩放选择区域)
Default:false
remove
若设置成true,则该插件将完全移除
resizable
决定选择区域是否可以改变大小
Default:true
resizeMargin
当选择区域宽度超过多少像素时将启用"可改变大小"模式
show
如果设置成true,选择区域将可见
x1
y1
初始化时选择框左上角的坐标
x2
y2
初始化时选择框右下角的坐标
zIndex