JavaScript推箱子游戏实现:地图渲染、键盘交互与胜利判定详解
本文详细解析使用JavaScript和jQuery实现推箱子小游戏的完整流程。内容涵盖基于二维数组的地图动态渲染、通过keydown捕获键盘指令实现角色移动与推箱逻辑,以及检测目标点数量判断游戏胜利的条件。代码已托管于GitHub,适合初学者学习DOM操作与游戏状态管理。
推箱子是一款经典的益智游戏,许多玩家都熟悉其玩法。撰写本文的初衷在于该游戏逻辑相对简单,非常适合用于理解前端游戏开发的基础概念。
以下是游戏演示效果:

接下来对实现步骤进行详细解析:
完整代码已上传至GitHub仓库,其中包含详尽的代码注释。建议读者将代码复制并在本地环境中运行,以便直观理解实现细节。
地图渲染机制
1. 地图渲染机制
HTML结构构建:

HTML结构的设计保持极简,主要通过生成一组div元素来承载地图的样式类(class)。初始化阶段创建了12乘以9共108个div元素,以支持地图最大九行的高度显示。这些div在尺寸上保持一致,地图视觉上的差异仅通过CSS类名控制颜色来体现。
地图生成函数逻辑:
var box=$('.box div'); //地图使用的div集合
function create(){ //创建地图函数
box.each(function(index){ //index的数量是固定的,是box div下面div的数量
// 每次创建地图初始化div
box.eq(index).removeClass();
});
box.each(function(index,element){ //循环整个div的数量 二维数组里数量不够的 默认为空白
//level为关卡数 根据关卡渲染地图 builder为二维数组,为地图关卡
if(builder[level][index]){ //过滤0
box.eq(index).addClass('type'+builder[level][index]);
}
});
box.eq(origin[level]).addClass("pusher"); //推箱人 皮卡丘位置
}
//第一关的地图长这样(下面只是栗子,不是代码),0代表不可抵达区域,1代表目标(要被推到的地方),
//2代表普通路径(可以走的),3代表墙,4代表箱子
[0,0,0,0,3,3,3,0,0,0,0,0,
0,0,0,0,3,1,3,0,0,0,0,0,
0,0,0,0,3,2,3,3,3,3,0,0,
0,0,3,3,3,4,2,4,1,3,0,0,
0,0,3,1,2,4,2,3,3,3,0,0,
0,0,3,3,3,3,4,3,0,0,0,0,
0,0,0,0,0,3,1,3,0,0,0,0,
0,0,0,0,0,3,3,3,0,0,0,0]
键盘事件捕获与移动判断
2. 键盘事件捕获与移动可行性判断
利用jQuery的$(document).keydown()方法监听键盘输入,支持上下左右方向键以及W、S、A、D按键操作。
$(document).keydown(function (e) {
var key=e.which;
switch(key){
//col 的值为12,上下移动要12个div为一个周期
//方向键上或者w
case 87:
case 38:
move(-col);//判断移动函数
break;
//方向键下或者s
case 83:
case 40:
move(col);
break;
//方向键左或者a
case 65:
case 37:
move(-1);
break;
//方向键右或者d
case 68:
case 39:
move(1);
break;
}
setTimeout(win,500); //按键之后调判断是否过关
});
移动逻辑包含两种情况的判断:一是角色自然移动,二是推动箱子。只有满足特定条件时,角色(文中称为皮卡丘)才会发生位移,否则保持静止。
function move(step){ //是否移动判断
// 分为两个判断条件一个是推箱子,一个是不推箱子 自然移动。 否则不移动皮卡丘
//step 上下是12个div一个周期,左右是1个div positin是皮卡丘的原来位置
var pikaqiu1=box.eq(position);//皮卡丘现在的地方
var pikaqiu2=box.eq(position+step);//皮卡丘要去的下一个地方
var pushBox=box.eq(position+step*2);//箱子要去的下一个地方
if(!pikaqiu2.hasClass('type4')&&( pikaqiu2.hasClass('type1')||pikaqiu2.hasClass('type2'))){ //自然移动
//判断:如果下一个div的class不包含type4(箱子),并且 下一个div含有type1(目标位置),或者type2(普通路径)
//这一步和下一步判断是否有type4的原因是普通路径会变成有type4的路径,这时候就会出现问题
pikaqiu1.removeClass("pusher"); //移除当前皮卡丘
pikaqiu2.addClass("pusher");//移动皮卡丘到下一个位置
position=position+step;//增加position值
}
else if((pikaqiu2.hasClass('type4'))&&(!pushBox.hasClass('type4'))&&(pushBox.hasClass('type1')|| pushBox.hasClass('type2')) ) {
//推箱子
//如果下一个div的class包含type4(箱子)并且 不包含重叠type4(箱子) 并且 包含class type1(目标位置)或者 包含type2(空路)
pikaqiu2.removeClass('type4');//移除当前箱子
pikaqiu1.removeClass("pusher");//移除当前皮卡丘
pushBox.addClass('type4');//移动箱子到下一个位置
pikaqiu2.addClass("pusher").addClass("type2");//
//本来是type4 移除之后,这里没有class了,要变成普通路径
position=position+step;//增加position值
}
}
胜利条件判定
3. 胜利条件判定:
function win(){ //胜利条件判断
if($(".type1.type4").length===goal){ //推的箱子与关卡设置通过箱子的数量对比
if(level<9) {
alert("666,挑战下一关吧--OBKoro1");
level++; //关卡+1
goal = goalList[level];
position = origin[level];
create();
}else {
alert("厉害啊 大佬 通关了都");
}
}
}
代码仓库地址:
在线演示地址:
JavaScript闭包与类(Class)的区别及适用场景对比
2026-11-05 15:48:57
JavaScript入门要学ES6吗?let与箭头函数等新特性解析
2026-11-05 14:49:16
JavaScript 8种数据类型详解:基本类型与引用类型的区别
2026-11-05 14:25:15
怎么在JavaScript中使用async/await优化Ajax异步流程
2026-11-05 13:56:15
JavaScript replace回调函数实现动态正则替换逻辑
2026-11-05 13:52:13
