关于jQuery插件imgAreaSelect基础讲解

关于ImgAreaSelect,  是一jQuery插件,它支持用户通过鼠标拖曳选择图片的一部分,如图片拖曳、图片编辑等~~来具体看一下

1、先下载imgAreaSelect插件

下载地址:

英文:http://odyniec.net/projects/imgareaselect/

中文:http://www.css88.com/EasyTools/javascript/jQueryPlugin/imgAreaSelect/index.html

在头部引用:

<link rel="stylesheet" type="text/css" href="../jquery.imgareaselect-0.9.10/css/imgareaselect-default.css" /> <script type="text/javascript" src="../jquery.imgareaselect-0.9.10/scripts/jquery.imgareaselect.pack.js"></script>

2、下载的插件里有三个样式表

imgareaselect-default.css – 这是默认的样式表, 
imgareaselect-animated.css – 这个样式与默认的样式表基本是一样的,只是它能够让选择区域边框变化 
imgareaselect-deprecated.css – 只有你想使用不赞同的选项时才用这个样式表。 
你只需要在html头部将其中的一个样式表添加进来就可以。这css文件夹中还包含4张gif图片,它们是用来显示边框的。

3、元素分布如图所示

此插件通过创建几个div元素来表示选择区域,包括边框、可调整手柄以及未选择的区域。这些元素已经指定了特定的类名了,所以你可以通过CSS或者jQuery选择器来获得并操作它们。

其中的前缀"imgareaselect"是默认的前缀,可以通过"classPrefix"选项来修改。这在当有许多选择框需要分别操作(比如修改样式)的时候特别有用。

4、选项 
用户在这个插件的很多方面都可以进行定制,用户通过插件选项来达到这个目的(这些选项会在插件初始化的时候起效)。这些选项包括:


选项


描述


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


设置此插件所作用元素的z-index的值,一般情况下,imgAreaSelect 总是可以自动计算出它的值,但是极少数情况下还是有必要设置的。


onInit


当插件初始化时所调用的函数(详见6、回调函数)


onSelectStart


当开始选择时所调用的函数(详见6、回调函数)


onSelectChange


当改变选择区域时所调用的函数(详见6、回调函数)


onSelectEnd


当选择结束时所调用的函数(详见6、回调函数)

5、回调函数

回调函数(当设置onInit, onSelectStart, onSelectChange或 onSelectEnd选项)接收两个参数,第一个选项是这个插件所应用图像的引用,另外一个则是呈现当前选择的对象,这个对象有六个性质。

为了便于理解,下面给出当选择完后执行的回调函数的例子:

$(‘img#photo‘).imgAreaSelect({

onSelectEnd: function (img, selection) {

alert(‘width: ‘ + selection.width + ‘; height: ‘ + selection.height);

}

});

6、键盘支持

如果选项"keys"设置为true,那么我们能够通过键盘上的按键进来选择框的移动。下面的键可以使用,默认的功能如下:

每个属性通过设置数值(以像素为单位,数值要不小于1),表明当按下此键时移动/改变大小多少像素,或者指定其值为"string"来指定它是"resize"模式。例如:

$(‘img#example‘).imgAreaSelect({

keys: { arrows: 15, ctrl: 5, shift: ‘resize‘ }

});

这个例子里设置成"方向键会移动选区15像素,按住Ctrl键会移动5像素,而按住Shift键时则切换到resize模式"。

如果不止一个图像,且自己修改了按键设置,那么只对一个图像会应用这个自定义设置。一般来说,当"激活"(用鼠标点击)某个图像时,这个图像就会使用自定义的按键设置。

7、API方法

这个插件也提供了几个API方法扩展它的应用,并能够通过这些API方法跟其他web应用联合起来。

为了使用这些方法,首先需要一个插件对象,可以调用imgAreaSelect()函数并让其选项"instance"设置为true来实现:

var ias = $(‘#photo‘).imgAreaSelect({ instance: true });

现在就可以使用此对象来调用公共的方法了。例如,设置一个默认预定义的范围:

ias.setSelection(50, 50, 150, 200, true);

ias.setOptions({ show: true });

ias.update();

只要当初始化完成,就可以使用这些API方法了。下面列出这些API方法:

二、简单实例

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 });

});

3、设置初始选项区域

配置x1, y1, x2与 y2选项就可以了:

$(document).ready(function () {

$(‘#duck‘).imgAreaSelect({ x1: 120, y1: 90, x2: 280, y2: 210 });

});

三、回调函数示例

1、选区预览

在下面的代码小片断里,onSelectChange()回调函数实现了选择区域预览的效果。

官方源代码:http://odyniec.net/projects/imgareaselect/examples-callback.html

function preview(img, selection) {

var scaleX = 100 / (selection.width || 1);

var scaleY = 100 / (selection.height || 1);

$(‘#ferret + div > img‘).css({

width: Math.round(scaleX * 400) + ‘px‘,

height: Math.round(scaleY * 300) + ‘px‘,

marginLeft: ‘-‘ + Math.round(scaleX * selection.x1) + ‘px‘,

marginTop: ‘-‘ + Math.round(scaleY * selection.y1) + ‘px‘

});

}

//这里通过jQuery语法在原来图片后插入同样的图片

$(document).ready(function () {

$(‘<div><img src="ferret.jpg" style="position: relative;" /><div>‘)

.css({

float: ‘left‘,

position: ‘relative‘,

overflow: ‘hidden‘,

width: ‘100px‘,

height: ‘100px‘

})

.insertAfter($(‘#ferret‘));

$(‘#ferret‘).imgAreaSelect({ aspectRatio: ‘1:1‘, onSelectChange: preview });

});

由于预览窗口是100x100px的,因此当截图窗口小于100px时,预览图会放大;当截图窗口大于100px时,预览图会缩小。这两种效果图如下:

截图 1 当截图窗口大于100px时

截图 2 当截图窗口小于100px时

需要说明的是,这里制作这种效果使用了一种技巧。最关键的一个是等比率缩放.它需要两个图片,第一图是原图,第二个图是选择区域后显示的图,用第一个图上的选择坐标+css控制产生第二个图,实际上两个图是一样的,只不过通过css控制了第二张图的显示区域与缩放比率。证据如下:

【证据一】在$(document).ready()函数中通过insertAfter插入"src"也是"ferret.jpg"的图片。再注意一下,这一段里的"overflow: ‘hidden‘,"这一行代码就是让超过100px高宽的图片额外内容隐藏掉。

【证据二】在preview()函数中,首先就定义了scaleX与scaleY,它们的内容就是100/selection.width(或height) ,也就是当selection.width小于100时,这个因子起放大作用,反之起缩小作用。

值得注意的是:

回调函数中实际图的宽高(这里的300,400是实际图的高,要根据实际情况调整!),回调函数中新图的宽高这些参数必须设置正确、否则会出现 选择偏差

2、提交选区的坐标

如果需要实现真正截图功能必须使用服务器端支持,例如php asp aspx jsp。也就是意味着,在客户端选择只是第一步,如果需进一步的处理,必须要将这选区的坐标提交给服务器。那么如何实现呢?

创建一个表彰,里面有四个隐藏域:

<form action="crop.php" method="post">

<input type="hidden" name="x1" value="" />

<input type="hidden" name="y1" value="" />

<input type="hidden" name="x2" value="" />

<input type="hidden" name="y2" value="" />

<input type="submit" name="submit" value="Submit" />

</form>

然后在初始化imgAreaSelect时,使用onSelectEnd()回调函数将选择后的数据赋给这些隐藏域,正如下面代码那样:

$(document).ready(function () {

$(‘#ladybug‘).imgAreaSelect({

onSelectEnd: function (img, selection) {

$(‘input[name="x1"]‘).val(selection.x1);

$(‘input[name="y1"]‘).val(selection.y1);

$(‘input[name="x2"]‘).val(selection.x2);

$(‘input[name="y2"]‘).val(selection.y2);

}

});

});

这样当点击"submit按钮"时,页面将上载到服务器,如果使用PHP的话,使用$_POST[‘x1‘]等就得到相应的坐标数据了。

素材源于脚本之家~~~

时间: 2024-11-05 06:20:58

关于jQuery插件imgAreaSelect基础讲解的相关文章

jQuery插件ImgAreaSelect 实例讲解一(头像上传预览和裁剪功能)

上一节随笔中,我们已经知道了关于jQuery插件ImgAreaSelect基本的知识:那么现在看一下实例: 首先,要知道我们应该实现什么功能? (1)图片能够实现上传预览功能 (2)拖拽裁剪图片,使其能够显示裁剪后的区域 (3)显示要裁剪区域的坐标 其次,该如何引用该插件呢? 那就具体看一下吧! 第一步:先将样式和文件包引入(根据你自己的位置引入) <!--引入imgareaselect的css样式--> <link rel="stylesheet" type=&qu

jQuery插件ImgAreaSelect 实例讲解二

在上一篇随笔http://www.cnblogs.com/chenguanai/p/6883401.html中,已经了解了头像的上传预览和裁剪功能:那么这次就再看一下imgareaselect的裁剪功能~~~ 有时候,我们裁剪某一区域时,分别会有大中小三个头像显示着~~~也就是如下图所示,当在右边的原图选择时,左边会分别显示大中小三个头像,便于用户选择~~~ 第一步:先引入插件和js包 <link rel="stylesheet" type="text/css"

jQuery插件imgAreaSelect图片裁剪使用详解

1.介绍 ImgAreaSelect是一jQuery插件,它支持用户通过鼠标拖曳选择图片的一部分,非常的fashion.另外,可以在这个选择图像区域的基础上应用网站的其他一些技术,比如图片拖曳.图片编辑等. 2.基本用法 这个插件基于jQuery上通过imgAreaSelect()方法来调用,它操作的对象是HTML中<img>元素内的图像. 代码如下: <script type="text/javascript"> $(document).ready(funct

编写自己的jquery插件之基础

1.编写jquery插件要遵循命名规范,通常情况下,jquery插件采用这种模式进行命名:jquery.pluginName.js,压缩版为:jquery.pluginName.min.js 2.编写jquery插件的方式有3种,第一种是通过jquery函数的原型属性来编写插件.第二种是采用jQuery.extend()方法.第三种是使用强大的jQuery UI Widget Factory编写插件.这里我选择用jQuery函数的原型属性来编写. 2.1    jQuery源码中有这样一句代码:

jQuery插件学习基础

1.给jQuery添加全局的函数: $.zgz={  fn1:function(){ alert('我是刚设置的第一个全局函数') },fn2:function(){ alert('我是刚设置的第二个全局函数') } } $(function(){ $.zgz.fn1(); $.zgz.fn2(); }) 2.给jQuery添加拓展函数方法一: $.fn.zgz=function() { alert(this.length) } $(function(){ $('oDiv').zgz(); })

利用jquery的imgAreaSelect插件实现图片裁剪示例

利用jquery的imgAreaSelect插件实现图片裁剪示例 将用户上传的图片进行裁剪再保存是现在web2.0应用中常常处理的工作,现在借助jquery的imgareaselect插件再配合PHP的GD库就可以轻松的实现这个在以前来说非常棘手的功能.我们来看看它的实现步骤: 1.包含进CSS文件(imgareaselect-default.css)和 jquery.imgareaselect.js文件 2.html代码(要裁剪的图片元素) <img id="selectbanner&q

采用jquery的imgAreaSelect样品图像裁剪示范插件实现

将用户上传的图片进行裁剪再保存是如今web2.0应用中经常处理的工作,如今借助jquery的imgareaselect插件再配合PHP的GD库就能够轻松的实现这个在曾经来说很棘手的功能. 我们来看看它的实现步骤: 1.包括进CSS文件(imgareaselect-default.css)和 jquery.imgareaselect.js文件 2.html代码(要裁剪的图片元素) <img id="selectbanner" src="/pic/banner.jpg&qu

10.折线连接--WEB设计器JQUERY插件讲解(含源码)

关键字:设计器源代码,Web设计器,工作流设计器,jQuery插件,组态设计器,SCADA系统设计器,流程图设计,表单设计建模,报表设计,可视化,设计时,运行时,轻量级开放平台. 前面章节已讲到如何在两个组件间通过曲线(贝塞尔曲线)进行连接,一般在实际应用中,贝塞尔曲线在数据流图.思维导图中应用比较多,许多如组织架构图等通过折线连接,本文在之前的基础上如何快速实现两个组件间的折线连接: 之前示例是用checkbox来指示是否画线状态,现在增加了一种线条所以需要修改一下用三种状态来识别是选择/曲线

jquery插件分类与编写详细讲解

1. 插件种类 插件其实就是对现有的方法(或者叫函数)做一个封装,方便重用提高开发效率.   jQeury主要有2种类型   1)实例对象方法插件 开发能让所有的jquery实例对象都可以调用的方法.也就是说,只要通过$()工厂获得的jquery实例对象,都可以调用我们开发的方法.95%的插件都是这种类型   2)全局函数插件 可以将独立的函数添加到jQuery命名空间中了.那么调用的时候就可以使用 $.函数名称() 或者jQuery.函数名称()来调用了.可以理解为静态方法.   2. 添加全