小時候我們玩過拼圖,那是用手去拼的。今天我們來研究用 JavaScript 拼圖——同樣是拼圖,用程式拼卻麻煩多了,所以未來我會把它優化成一個引擎。
熟悉《三國志曹操傳》的玩家都知道,遊戲中的地圖是由一格格小地圖塊拼出來的。要還原這個效果,就跟前言說的一樣:很麻煩。但即使麻煩,它也是一門技術,因此在此分享。
今天換個講解方式,先不給程式碼。假設你有一張圖,把它裁開成若干份並打亂,現在要你用 JavaScript 把它們組回原樣,你會怎麼做?
先不談順序,光是「把它們放在一起」就不容易。於是我把難度降低,給你三個選項:
A. 用 margin 慢慢調
B. 用陣列把它們排列好
C. 放棄
選 A 很不明智,選 C 代表連你自己都拿不定主意。顯然 B 才是正解。既然答案都公布了,就直接看程式碼吧。





素材並非取自《三國志曹操傳》,因為原作的地圖素材我還沒整理好,就隨便找了些替代品,功能上完全一樣。
麻煩的程式碼最容易寫得亂七八糟,所以此時更要嚴格區分「樣式設定」與「拼圖核心」。核心就在這幾行:
// 地圖塊型別對照表:字元 → [圖片路徑, 提示文字]
var mScene = {
'L': ['./land.png', '陸地'],
'S': ['./sea.png', '河流'],
'T': ['./tree.png', '樹木'],
'B': ['./bridge.png', '橋'],
'C': ['./beach.png', '沙灘']
};
var mCurrent = {
Margin: { left:-1, top:-1, right:-1, bottom:-1 },
Position: { X:-1, Y:-1 },
Type: 'NONE'
};
// 一張地圖就是一串字元:分號換行、逗號分欄
var sHurdleONE =
'S,S,S,S,S,S,S,S,S,S,S'
+ ';T,L,T,T,T,T,S,S,S,S,T'
+ ';T,L,L,T,S,S,S,S,S,L,T'
+ ';T,L,L,L,C,C,C,S,S,T,S'
+ ';T,L,L,L,C,C,C,B,B,L,T'
+ ';T,L,L,C,C,C,C,S,S,L,T'
+ ';T,L,L,C,C,T,S,S,L,L,T';
var vHurdles = [sHurdleONE]; // 多張地圖就繼續往陣列裡放
我用 S 代表河流、T 樹木、B 橋、C 沙灘、L 陸地。mCurrent 後面會用到,暫不解釋。mTitle 專門負責顯示 title,也不必多想。
關鍵是 sHurdleONE:把定義好的字元用分號與逗號串成一份「地圖文件」。後端只要依每個字元的寬高定義就能把它們連成一整張圖,而且只要調整改動字元在字串中的位置,就能改變地圖樣貌——這正是資料與程式分離的價值。
為了日後能切換地圖,我們把第一張圖放進陣列:
var vHurdles = [sHurdleONE]; // 新增地圖後,只要把它的變數名加進這個陣列,呼叫時傳對應索引即可
function _createGrid(nWidthBasic, nHeightBasic, nPicWidth, nPicHeight, cType, mMargin)
{
var mCoordMember = {
left: nWidthBasic,
top: nHeightBasic,
right: nWidthBasic + nPicWidth,
bottom: nHeightBasic + nPicHeight
};
var mPositionMember = {
X: (mCoordMember.left - mMargin.x) / nPicWidth,
Y: (mCoordMember.top - mMargin.y) / nPicHeight
};
return { Coord: mCoordMember, Position: mPositionMember, Type: cType };
}
function _loadHurdle(sHurdle)
{
var nBasic = 0;
var nWidthBasic = nBasic; // margin-left 起點
var nHeightBasic = 0; // margin-top 起點
var nPicWidth = 45; // 每塊圖的寬
var nPicHeight = 45; // 每塊圖的高
var v = sHurdle.split(';');
var vRec = [];
for (var nSub = 0; nSub < v.length; nSub++){
var vCrid = v[nSub].split(',');
vRec[vRec.length] = vCrid;
}
for (var nRow = 0; nRow < vRec.length; nRow++){
var vCol = vRec[nRow];
for (var nCol = 0; nCol < vCol.length; nCol++){
var cType = vCol[nCol];
var mMargin = { x: nBasic, y: nBasic };
vView[vView.length] =
_createGrid(nWidthBasic, nHeightBasic, nPicWidth, nPicHeight, cType, mMargin);
nWidthBasic += nPicWidth; // 往右一格
}
nHeightBasic += nPicHeight; // 換下一列
nWidthBasic = nBasic; // 水平歸零
}
}
function _showMap(sID)
{
var xDiv = document.getElementById(sID);
var sIdPrefix = 'ID_IMG_NUM_';
var sIdGrid = 'ID_A_NUM_';
for (var nSub = 0; nSub < vView.length; nSub++){
var mGrid = vView[nSub];
if (mGrid){
var xMargin = mGrid.Coord;
var xProper = mScene[mGrid.Type];
if (xProper){
var xGrid = document.createElement('a');
var xImg = document.createElement('img');
xImg.style.position = 'absolute';
xImg.style.marginLeft = xMargin.left;
xImg.style.marginTop = xMargin.top;
xImg.src = xProper[0];
xImg.style.border = '0px solid #000000';
xImg.style.width = 45;
xImg.style.height = 45;
xImg.style.display = 'block';
xImg.id = sIdPrefix + nSub;
xGrid.onclick = function(e){
var sId = e.target.id;
var nIdAsSub = parseInt(sId.substring(sIdPrefix.length));
mCurrent = vView[nIdAsSub];
if (!mCurrent) alert("Error 0004.");
};
xGrid.title = xProper[1] + '(' + parseInt(mGrid.Position.X)
+ ', ' + parseInt(mGrid.Position.Y + 2) + ')';
xGrid.id = sIdGrid + nSub;
xGrid.appendChild(xImg);
xDiv.appendChild(xGrid);
} else { alert("Error: 0003."); } // 型別不在 mScene 對照表中
} else { alert("Error: 0002."); } // 網格資料缺失
}
}
function _showHurdle(nHurdle)
{
if (vHurdles[nHurdle - 1]){
_loadHurdle(vHurdles[nHurdle - 1]);
_showMap('ID_DIV_BATTLEFIELD');
} else { alert("Error: 0001."); } // 索引超出地圖陣列範圍
}
就這樣,一張地圖用掉了將近兩百行。值得說明的是:程式裡刻意埋了 Error 0001 到 0004 這類編號提示。在這種層層嵌套的程式裡,一旦跳出某個編號,就能立刻定位是哪個環節出錯,省下大量除錯時間。
另外要注意,所有圖片都是 createElement 動態產生的,HTML 裡並沒有任何 img 標籤,別在 HTML 中白找。
最後是呼叫入口:
<body onload="_showHurdle(1)">
參數 nHurdle 是地圖在 vHurdles 陣列中的索引,從 1 開始而非 0。也就是說要用第一張地圖就寫 _showHurdle(1)。

由於是靜態結果,就不另附 demo 了。這個方法雖然繁瑣,地圖塊變多時效能也會下降,但畢竟是一條可行之路。若你有更好的做法,也歡迎提出來一起討論。