From 68d2f44aea5290dc4f05eec89f7b308bda1a5c16 Mon Sep 17 00:00:00 2001 From: class04f19 Date: Tue, 13 Oct 2026 03:40:54 +0000 Subject: [PATCH] Write project README with gameplay and tech notes --- README.md | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 59 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index be372af..391c7f4 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,60 @@ -# 2048-game +# 2048 · 数字合并 -2048 number-merge puzzle game in a single HTML file \ No newline at end of file +一个用纯 HTML + CSS + 原生 JavaScript 写成的 **2048** 小游戏,**单文件、零依赖**,双击 `index.html` 即可开玩。 + +## 游玩 + +在线打开: + +或克隆到本地: + +```bash +git clone https://gitea.compute-thinking.cn/class04f19/2048-game.git +cd 2048-game +# 打开 index.html +``` + +## 操作 + +| 操作 | 按键 | +| --- | --- | +| 移动方块 | `↑` `↓` `←` `→` 或 `W` `A` `S` `D` | +| 触摸滑动 | 手机 / 平板在棋盘上滑动 | +| 撤销一步 | `Z` 或点「↩ 撤销」 | +| 重新开始 | `R` 或点「新游戏」 | + +## 玩法 + +- 所有方块朝同一方向滑动,**两个数字相同的方块相撞会合并成它们的和**。 +- 每次有效移动后,空白格会随机出现一个 `2`(90%)或 `4`(10%)。 +- 目标是拼出 **2048**。达成后可选择「继续挑战」冲击更大数字。 +- 棋盘填满且**任意相邻两格都无法合并**时游戏结束。 +- 最高分通过 `localStorage` 保存在本地浏览器。 + +## 功能亮点 + +- ✅ **丝滑动画**:方块滑动用 `transform` + CSS transition;新方块缩放出现;合并方块「弹一下」 +- ✅ **撤销**:内置 20 步历史快照,手滑了也能救回来 +- ✅ **最高分持久化**:本地记录,刷新不丢 +- ✅ **双端适配**:键盘 + 触摸滑动,棋盘随容器等比缩放 +- ✅ **完整状态机**:达成 2048 弹窗、无路可走判定、继续挑战 + +## 技术实现 + +- **数据模型**:`grid[4][4]` 存放方块对象 `{ id, value, r, c, el }`,每个方块对应一个 DOM 元素。 +- **移动算法**:按移动方向决定遍历顺序(从目标边开始),每个方块先「滑到最远空格」,再判断下一格是否可合并;用 `mergedIds` 集合保证同一回合内一个方块只被合并一次。 +- **动画同步**:合并时数据立即更新(保证后续逻辑正确),视觉上让旧方块先滑到目标格,`110ms` 后再移除旧元素并让新数值弹出——这就是经典的 2048 合并手感。 +- **尺寸自适应**:`ResizeObserver` 监听棋盘尺寸,用 JS 计算 `gap / cell` 并以 CSS 自定义属性下发,方块用 `translate(var(--x), var(--y))` 绝对定位,任意屏幕下都能精确对齐。 +- **零依赖**:没有引入任何框架或库,全部原生实现。 + +## 项目结构 + +``` +. +├── index.html # 游戏本体(HTML + CSS + JS 全在这一个文件里) +└── README.md +``` + +## 许可 + +MIT