imgAreaSelect 中文文档帮助说明

一、技术文档
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

 

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/wdjxps.html