本文主要是介绍使用jQuery轻松生成滑动拼图游戏——jqPuzzle插件简介,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
jqPuzzle 这个jQuery插件可以帮助你在自己的网页上轻松生成滑动拼图游戏。选择一张图片放进你的网页中,然后给它来点小小的魔法——jqPuzzle 会帮你把它变成滑动拼图!你还可以根据自己的喜好对这个拼图进行各种定制。太COOL了!
使用方法相当的简单。首先,像所有jQuery插件一样,在<head> 标签中引用所需要的文件:
- <script type="text/javascript" src="jquery.js"></script>
- <script type="text/javascript" src="jquery.jqpuzzle.js"></script>
- <link rel="stylesheet" type="text/css" href="jquery.jqpuzzle.css" />
然后,在网页中插入一张图片,赋予它一个 jqPuzzle 类,一切OK!
- <img src="street.jpg" alt="Animals crossing" class="jqPuzzle" />
进行过上面的两步之后,您应该可以看到您的拼图了。当然如果愿意,这个插件还有一些选项,允许您对这个拼图进行定制。使用语法如下:
jqp[-LANGUAGE]-rROWS-cCOLS[-hHOLE][-sSHUFFLE_ROUNDS][-FLAGS]
把所有大写字母的单词变成您需要的值即可。另外,中括号[ ]中的部分都是可选的(包括中括号)。具体解释如下:
* LANGUAGE: 界面语言代码。默认是英文。
* ROWS: 拼图的行数 (从 3 到 9)。
* COLS: 拼图的列数 (从3 到 9)。
* HOLE: 拼图中“图眼”的位置(即缺的那一块的位置) (从 1 到 rows*columns), 默认是缺最右下角那块。
* SHUFFLE ROUNDS: 把原图进行多少次打乱。默认是 3 次
* FLAGS: 其它选项。您想用多少,就摆上多少,次序无所谓:
o S: 把拼图的初始状态设为已被打乱。
o N: 隐藏拼图上的数字。
o A: 隐藏 'Shuffle' 按钮。
o B: 隐藏 'Original' 按钮。
o C: 隐藏 'Numbers' 按钮。
o D: 隐藏 'moves' 移动步数。
o E: 隐藏 'seconds' 游戏时间。
下面是一些例子:
三行五列,图眼在5的位置:
- <img src="street.jpg" alt="Animals crossing" class="jqPuzzle jqp-r3-c5-h5" />
德语界面,五行五列:
- <img src="street.jpg" alt="Animals crossing" class="jqPuzzle jqp-de-r5-c5" />
四行四列,打乱一次:
- <img src="street.jpg" alt="Animals crossing" class="jqPuzzle jqp-r4-c4-s1" />
法语界面,三行三列,图眼在5位置,初始隐藏拼图上的数字、移动步数和游戏时间:
- <img src="street.jpg" alt="Animals crossing" class="jqPuzzle jqp-fr-r3-c3-h5-NDE" />
德语界面,五行七列,初始拼图是打乱状态,隐藏“shuffle”按钮和游戏时间:
- <img src="street.jpg" alt="Animals crossing" class="jqPuzzle jqp-de-r5-c7-SAE" />
用我们熟悉的jQuery方式,在$(document).ready()中调用jqPuzzle()方法,则是另一种使用方式。来个例子:
- <script type="text/javascript">
- $(document).ready(function() {
- $('img').jqPuzzle(); // apply to all images
- });
- </script>
使用这种方式,您可以对jqPuzzle这个插件的所有功能进行控制。
至于jqPuzzle()这个方法,可以带两个可选的参数:
jqPuzzle(settings, texts)
其中 setting 这个参数的默认值定义如下:
- var settings = {
- rows: 4, // 行数 [3 ... 9]
- cols: 4, // 列数 [3 ... 9]
- hole: 16, // 图眼位置 [1 ... rows*columns]
- shuffle: false, // 初始状态打乱图片 [true|false]
- numbers: true, // 在拼图上显示数字 [true|false]
- language: 'en', // 用户界面代码 [language code]
- // display additional gui controls
- control: {
- shufflePieces: true, // 显示 'Shuffle' 按钮[true|false]
- confirmShuffle: true, // 打乱之前询问 [true|false]
- toggleOriginal: true, // 显示 'Original' 按钮 [true|false]
- toggleNumbers: true, // 显示 'Numbers' 按钮[true|false]
- counter: true, // 显示移动步数 [true|false]
- timer: true, // 显示计时器 [true|false]
- pauseTimer: true // 按下 'Original' 按钮时暂停计数器
- // [true|false]
- },
- // perform actions when the puzzle is solved sucessfully
- success: {
- fadeOriginal: false, // 原始图像交错淡变 [true|false]
- callback: undefined, // 回调用户自定义函数 [function]
- callbackTimeout: 300 // 回调函数被调用Timeout(单位:毫秒)
- },
- // animation speeds and settings
- animation: {
- shuffleRounds: 3, // 打乱次数 [1 ... ]
- shuffleSpeed: 800, // 每次打乱所用的时间 (单位:毫秒)
- slidingSpeed: 200, // 单次移动所用的时间 (单位:毫秒)
- fadeOriginalSpeed: 600 // 原始图像交错淡变所用的时间 (单位:毫秒)
- },
- // additional style information not specified via css
- style: {
- gridSize: 2, // 2块拼图之间的间距
- overlap: true, // 如果为 true, 相邻两块拼图的边界重叠(仅当gridSize为0时有效)
- backgroundOpacity: 0.1 // 原始图像的透明度
- // [0 ... 1] (0 意为不显示原始图像)
- }
- }
如果您需要定制自己的拼图,不用把这个 setting 整个重写一遍,只要指出与默认值不同之处即可。例如:
- $(document).ready(function() {
- // 定制您自己的 settings 参数
- var mySettings = {
- cols: 5,
- hole: 11,
- numbers: false,
- control: {
- toggleNumbers: false,
- counter: false,
- timer: false
- },
- animation: {
- shuffleRounds: 1,
- slidingSpeed: 100,
- shuffleSpeed: 200
- }
- };
- $('#myImage').jqPuzzle(mySettings);
第二个参数 texts 的作用一目了然,就是定义界面上所有的文字内容:
- var texts = {
- shuffleLabel: 'Shuffle',
- toggleOriginalLabel: 'Original',
- toggleNumbersLabel: 'Numbers',
- confirmShuffleMessage: 'Do you really want to shuffle?',
- movesLabel: 'moves',
- secondsLabel: 'seconds'
- }
此外,这个插件还支持使用CSS文件进行外观样式的修改。我就偷个懒不写了,您自己看看吧。当然最好的学习方法就是先看看演示,再下载这个插件,亲自动手修改各个参数观察变化:
演示网址:http://www.2meter3.de/jqPuzzle/demos.html
下载网址:http://download.csdn.net/source/2063938
这篇关于使用jQuery轻松生成滑动拼图游戏——jqPuzzle插件简介的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!