1. 理解jQuery animate() 方法
jquery的animate()方法是实现自定义css属性动画的强大工具。它允许开发者在指定的时间内，平滑地改变元素的数值型css属性。例如，改变元素的top、left、width、height等属性，可以创建移动、缩放等动画效果。
对于角色跳跃动画，我们通常会改变其top属性，使其先向上移动一段距离，再向下回到原位，从而模拟跳跃的轨迹。
2. 实现跳跃动画逻辑
一个典型的跳跃动画包含两个阶段：上升和下降。在jQuery中，可以通过链式调用animate()方法来实现这两个连续的动画。
2.1 跳跃函数 (sauter)
sauter 函数负责启动跳跃动画。它首先检查角色是否正在跳跃（通过personnage.enSaut状态变量），以防止重复跳跃。
// 假设 personnage 是一个包含角色状态和方法的全局对象
const personnage = {
enSaut: false, // 标识角色是否正在跳跃
threadMarcherCourir: null, // 用于管理角色移动的定时器
directionSouhaitee: 'ARRET', // 角色期望的移动方向
ARRET: 'ARRET', // 停止状态
marcher: function() {
// 模拟角色行走的逻辑
console.log("角色正在行走...");
},
resetSaut: function() {
// 此方法将在动画完成后调用
// 具体实现见下一节
}
};
const clavier = {
touchesAppuyees: [], // 模拟键盘按键状态
MAJUSCULE: 'Shift'
};
let partieEnCours = true; // 模拟游戏是否进行中
function sauter() {
if (!personnage.enSaut) {
let lePersonnage = $("#personnage"); // 使用jQuery选择器获取元素
lePersonnage.animate({ top: "-=100px" }, 500) // 向上跳跃100px，耗时500ms
.animate({ top: "+=100px" }, 500) // 向下返回100px，耗时500ms
.promise() // 返回一个Promise对象，表示动画链的完成
.done(personnage.resetSaut); // 当所有动画完成时，调用 resetSaut 方法
clearInterval(personnage.threadMarcherCourir); // 跳跃时停止行走/奔跑动画
personnage.enSaut = true; // 设置跳跃状态为true
}
}在上述代码中：
- $("#personnage").animate({ top: "-=100px" }, 500) 使元素向上移动。
- .animate({ top: "+=100px" }, 500) 使元素向下返回。
- .promise().done(personnage.resetSaut) 是关键。promise() 方法返回一个Promise对象，当所有链式动画都完成时，该Promise会被解决（resolved）。done() 方法则在Promise解决时执行回调函数personnage.resetSaut。这确保了resetSaut函数只在跳跃动画完全结束后才执行。
2.2 重置跳跃状态函数 (resetSaut)
resetSaut 函数在跳跃动画完成后被调用，用于清除跳跃状态并恢复之前的移动逻辑（如果适用）。
personnage.resetSaut = function () {
let timeoutMouvement = 60; // 默认移动间隔
personnage.enSaut = false; // 重置跳跃状态
// 如果角色期望移动，则恢复行走/奔跑动画
if (personnage.directionSouhaitee !== personnage.ARRET) {
if (clavier.touchesAppuyees.includes(clavier.MAJUSCULE)) {
timeoutMouvement /= 2; // 如果按住Shift键，移动速度加倍
}
if (partieEnCours) {
clearInterval(personnage.threadMarcherCourir); // 确保清除旧的定时器
personnage.threadMarcherCourir = setInterval(personnage.marcher, timeoutMouvement); // 重新启动行走定时器
}
}
};3. animate() 函数缺失问题排查
在开发过程中，如果遇到类似 animate() is not a function 的错误，即使确认已引入jQuery库，这通常意味着你使用的jQuery版本是精简版（slim build），它排除了某些模块，其中就包括了动画效果（effects）模块。
3.1 错误原因分析
jQuery有完整版和精简版之分。精简版通常会移除不常用的模块，例如AJAX、动画效果（animate()、fadeIn()、slideDown()等）和一些旧的兼容性代码，以减小文件大小。当你通过console.log($.fn.jquery)看到类似 3.5.1 -ajax,-ajax/jsonp,...,-effects,-effects/Tween,... 的输出时，其中的 -effects 就明确指出动画模块已被排除。
3.2 解决方案
要解决animate()函数缺失的问题，最直接的方法是确保引入完整版的jQuery库。
示例：引入完整版jQuery CDN
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>jQuery 跳跃动画</title>
<!-- 引入完整版 jQuery 库 -->
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.7.1/jquery.min.js"></script>
<style>
#personnage {
position: relative; /* 必须是 relative, absolute, fixed 等定位，animate top/left 才能生效 */
width: 50px;
height: 50px;
background-color: blue;
top: 200px; /* 初始位置 */
left: 100px;
}
button {
margin-top: 20px;
}
</style>
</head>
<body>
<div id="personnage"></div>
<button id="boutonDeSaut">跳跃</button>
<script>
// 确保在DOM加载完成后执行脚本
$(document).ready(function() {
// 定义 personnage 和 clavier 对象 (同上文)
const personnage = {
enSaut: false,
threadMarcherCourir: null,
directionSouhaitee: 'ARRET',
ARRET: 'ARRET',
marcher: function() {
console.log("角色正在行走...");
}
};
const clavier = {
touchesAppuyees: [],
MAJUSCULE: 'Shift'
};
let partieEnCours = true;
// 赋值 resetSaut 方法
personnage.resetSaut = function() {
let timeoutMouvement = 60;
personnage.enSaut = false;
if (personnage.directionSouhaitee !== personnage.ARRET) {
if (clavier.touchesAppuyees.includes(clavier.MAJUSCULE)) {
timeoutMouvement /= 2;
}
if (partieEnCours) {
clearInterval(personnage.threadMarcherCourir);
personnage.threadMarcherCourir = setInterval(personnage.marcher, timeoutMouvement);
}
}
};
// 绑定跳跃事件
$("#boutonDeSaut").click(function() {
sauter(); // 调用跳跃函数
});
function sauter() {
if (!personnage.enSaut) {
let lePersonnage = $("#personnage");
lePersonnage.animate({ top: "-=100px" }, 500)
.animate({ top: "+=100px" }, 500)
.promise()
.done(personnage.resetSaut);
clearInterval(personnage.threadMarcherCourir);
personnage.enSaut = true;
}
}
// 示例：模拟角色初始行走
// personnage.directionSouhaitee = 'AVANT';
// personnage.threadMarcherCourir = setInterval(personnage.marcher, 60);
});
</script>
</body>
</html>4. 整合游戏状态与事件处理
在实际的游戏开发中，跳跃动画需要与游戏的整体状态管理和事件监听紧密结合：
- $(document).ready(): 确保所有DOM元素加载完毕后再执行jQuery代码，这是良好的实践。
- 状态变量 (personnage.enSaut): 使用布尔变量来跟踪角色是否处于跳跃状态，防止在一次跳跃完成前再次触发跳跃。
- 定时器管理 (clearInterval, setInterval): 在跳跃开始时，通常需要停止角色原有的行走或奔跑动画（通过clearInterval），待跳跃结束后再根据需要恢复（通过setInterval）。
- 事件监听: 可以通过键盘事件（如keydown或keyup）或点击事件来触发跳跃函数。
5. 注意事项
- 元素定位: 使用animate()改变top或left属性时，目标元素必须具有CSS定位属性（position: relative; position: absolute; position: fixed;等），否则动画可能不生效。
- jQuery版本: 始终确保引入了包含所需模块的jQuery版本。如果只需要核心功能，精简版是更好的选择，但如果需要动画，则必须使用完整版。
- 性能: 对于复杂的动画或对性能要求极高的场景，CSS3 transition 或 animation 通常比JavaScript动画（包括jQuery animate()）提供更好的性能，因为它们可以利用GPU硬件加速。对于简单的UI动画，jQuery animate() 仍然非常方便。
- 代码结构: 将相关的角色逻辑（如sauter和resetSaut）封装在一个对象中，有助于保持代码的组织性和可维护性。
总结
通过本教程，我们学习了如何使用jQuery的animate()方法实现一个简单的角色跳跃动画。关键在于利用animate()的链式调用来定义跳跃的上升和下降阶段，并通过promise().done()确保在动画完全结束后执行回调函数。同时，我们深入探讨了animate() is not a function这一常见错误的根本原因——使用精简版jQuery库，并提供了引入完整版jQuery的解决方案。掌握这些知识将帮助你在网页中创建更加生动和交互式的动画效果。
