這是一個實際的專案案例:把一份只有「資料」的 HTML 試卷,自動轉換成排版講究、可分頁翻閱、附帶作答計時的線上試卷。以下記錄需求、思路與實作。
題目以語意化的 class 標示結構:Desc 為說明區、Problem 為單一題目、Choices 為選項區。
<ol id="olThePaper">
<div class="Desc">選擇題:說明文字……</div>
<div class="Problem" id="1">
<li>1. 你認為怎樣的老師是好老師?</li>
<div class="Choices">
<label><input type="radio" name="prob1" value="A" />和學生平等相處,能全面滿足學生各種需要</label>
<label><input type="radio" name="prob1" value="B" />所在教學班的成績優於其他平行班</label>
<label><input type="radio" name="prob1" value="C" />嚴格管理學生、所帶的班級班風良好</label>
<label><input type="radio" name="prob1" value="D" />父母般地關心學生的生活和情緒狀態</label>
</div>
</div>
<div class="Problem" id="3">
<li>3. 哪張圖片最好看?</li>
<div class="Choices">
<label><input type="radio" name="prob3" value="A" />這一張<img src="img1.png" height="300px" width="400px" alt="img1"/>好看。</label>
<label><input type="radio" name="prob3" value="E" />不知道。</label>
</div>
</div>
<div class="Problem" id="4">
<li>4. 床前明月光,<input type="text" name="prob4" /></li>
</div>
<div class="Problem" id="5">
<li>5. 多選題範例……</li>
<div class="Choices">
<label><input type="checkbox" name="prob6" value="A" />選項一</label>
<label><input type="checkbox" name="prob6" value="B" />選項二</label>
</div>
</div>
</ol>
這個結構的巧妙之處是:輸入完全就是普通 HTML,命題老師用任何所見即所得編輯器都能產出,不必學新語法。
需求本質上是「依容器寬度動態決定版面」,這只能用 JavaScript 完成。最後選定 jQuery 搭配 Aptana 作為 IDE,樣式則全交給 CSS 處理。
<head> <title>試卷</title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <script src="lib/jquery/jquery-1.4.2.js" type="text/javascript"></script> <script src="lib/countdown/jquery.countdown.pack.js" type="text/javascript"></script> <script src="TestPaperProcessor.js" type="text/javascript"></script> <link href="style.css" rel="stylesheet" type="text/css" /> </head> <body> <div id="divToolbar"> <div id="divPrev">PrevPage</div> <div id="divNext">NextPage</div> <div id="divPageInfo">Loading the test...</div> <div id="divTimer"></div> </div> <form id="formPaper" action="demo.html" method="post" accept-charset="utf-8"> <ul> <div class="Display" id="divLeft">left</div> <!-- 左頁 --> <div class="Display" id="divRight">right</div> <!-- 右頁 --> </ul> <ol id="olThePaper"> ... 題目 ... </ol> </form> </body>
注意版面設計:左頁與右頁並排,一次顯示兩頁,翻頁時以「跨頁」為單位前進,比較符合紙本試卷的閱讀習慣。
/* YahooUI CSS Reset */
body,div,dl,dt,dd,ul,ol,li,h1,h2,h3,h4,h5,h6,pre,form,fieldset,input,textarea,p,blockquote,th,td {
padding: 0; margin: 0;
}
table { border-collapse: collapse; border-spacing: 0; }
fieldset,img { border: 0; }
ol,ul { list-style: none; }
h1,h2,h3,h4,h5,h6 { font-weight: normal; font-size: 100%; }
/* 自訂樣式 */
.Choices { line-height: 150%; margin: 5px 0; }
.Page { height: 500px; border: solid 1px gray; }
#olThePaper, .Display { padding: 0; width: 500px; }
/* 注意:.Display 與 #olThePaper 的寬度必須相同 */
.Display { float: left; }
#divToolbar { height: 35px; }
#divPrev, #divNext {
float: left; width: 100px; height: 30px;
border: solid 1px green; background-color: #999999;
}
#divPageInfo { float: left; width: 100px; height: 30px; }
#divTimer { float: left; width: 500px; height: 30px; }
那行註解是實戰中慘痛學到的教訓:.Display 與 #olThePaper 寬度若不一致,選項排版的槽位計算就會失準,整個自適應機制跟著崩掉。
/**
* @param {String} PaperOlId ol 標籤的 id,包住整份試卷
* @param {String} ProblemClass 題目區的 css class 名
* @param {String} DescClass 說明區的 css class 名
* @param {String} ChoicesClass 選項區的 css class 名
* @param {String} LeftPageId 左頁 id
* @param {String} RightPageId 右頁 id
*/
function TTestPaperProcessor(PaperOlId, ProblemClass, DescClass, ChoicesClass, LeftPageId, RightPageId) {
this.FPaperOlId = PaperOlId;
this.FProblemClass = ProblemClass;
this.FDescClass = DescClass;
this.FChoicesClass = ChoicesClass;
this.FLeftPageId = LeftPageId;
this.FRightPageId = RightPageId;
$('#' + this.FLeftPageId).html('');
$('#' + this.FRightPageId).html('');
this._FormatProblemOptions(); // 先排版選項
this._DivideIntoPages(); // 再分頁
this.setCurrPage(1);
}
順序很重要:必須先把選項壓縮完成,題目的實際高度才會是最終值,之後的分頁計算才會準確。
_FormatProblemOptions: function() {
var mThis = this;
var mSelector = '.' + this.FProblemClass + ' .' + this.FChoicesClass;
$(mSelector).each(function() {
// 依 label 的實際寬度由大到小排序,大項優先配置
var mLabels = new Array();
mLabels = jQuery.makeArray($('label', this));
mLabels.sort(function(First, Second) {
return $(Second).outerWidth(true) > $(First).outerWidth(true);
});
$(mLabels).appendTo(this);
var mSlots = -1; // 強制在第一輪建立新列
var mSlotWidth = $(mSelector).width() / 4.0; // 一行四槽
var mCellSize = 0;
while (mLabels.length > 0) {
if (mSlots <= 0) { // 沒有空槽,開新列
mCurrRow = $('<div class="___table" style="display: table;"></div>');
mCurrRow.appendTo(this);
mSlots = 4;
mCellSize = 0;
// 依選項實際寬度決定它要吃掉幾個槽
var mRealCellWidth = $(mLabels[0]).outerWidth(true);
if (mRealCellWidth < mSlotWidth) { mCellSize = 1; }
if (mRealCellWidth >= mSlotWidth && mRealCellWidth < mSlotWidth * 2) { mCellSize = 2; }
if (mRealCellWidth >= mSlotWidth * 2) { mCellSize = 4; }
}
mSlots -= mCellSize;
if (mSlots >= 0) { // 有空槽,放進去
mLabel = mLabels.shift();
$(mLabel).addClass('___cell');
$(mLabel).css('display', 'table-cell');
$(mLabel).appendTo(mCurrRow);
}
}
// 讓同一列內的儲存格平均分配寬度
$('.___table').each(function() {
$(this).css('width', '100%');
var mCellWidth = 100 / $('.___cell', this).length;
$('.___cell', this).css('width', mCellWidth + '%');
});
});
}
演算法核心三句話:選項依寬度排序(大的先放,避免後面塞不進去產生空洞)、一行四槽(依最長選項決定槽寬)、依實際寬度換算佔幾槽。這就自動達成了「短選項擠一行、長選項獨佔一行」的需求。
程式同時為 IE6/7 準備了 table/tr/td 的分支版本,因為舊版 IE 不支援 display: table-cell。那一版還有個眉角:必須套用 table { border-collapse: collapse; border-spacing: 0; },否則 offsetWidth 會偏大,導致長選項被誤判為可佔一列而換行。
_CreateNewPage: function() {
++this.FPageCount;
mPage = $('<div class="' + this.CPageClass + '" id="___page_' + this.FPageCount + '"></div>');
mPage.appendTo($('#' + this.FPaperOlId));
return mPage;
},
_DivideIntoPages: function() {
var mProblems = $('.' + this.FProblemClass + ', .' + this.FDescClass);
var mProblemsCount = mProblems.length;
var mCurrPage = this._CreateNewPage();
var mPageHeight = mCurrPage.outerHeight(true); // 頁面可用高度
var mUsedPageHeight = 0;
for (var mCurrProblem = 0; mCurrProblem < mProblemsCount; ++mCurrProblem) {
// 若加入這一題會超出頁面高度,就換頁
if (mUsedPageHeight + $(mProblems[mCurrProblem]).outerHeight(true) > mPageHeight) {
mCurrPage.hide();
mCurrPage = this._CreateNewPage();
mPageHeight = mCurrPage.outerHeight(true);
mUsedPageHeight = 0;
}
$(mProblems[mCurrProblem]).appendTo(mCurrPage);
mUsedPageHeight += $(mProblems[mCurrProblem]).outerHeight(true);
}
mCurrPage.hide();
}
這是最經典的「貪婪裝箱」策略:逐題累加高度,一旦會溢出就換新頁。因為以整題為單位搬移,天然保證了同一題不會跨頁。
這裡有個非常值得記下的細節:程式註解特別警告,offsetHeight 在 Chrome 可能回傳 0、在 Safari 若放在 $(window).ready() 內幾乎必然是 0,因此必須改用 outerHeight(true),且整段初始化要掛在 $(window).load() 而非 ready——因為分頁依賴圖片與字型載入後的真實高度。
setCurrPage: function(Value) {
if (Value < 1 || Value > this.FPageCount) {
throw new Error('No such page: ' + Value + '.');
}
this.FCurrPage = parseInt(Value / 2) * 2 + 1; // 轉為奇數,對齊跨頁
$('#' + this.FLeftPageId + ' .' + this.CPageClass).hide();
$('#' + this.FRightPageId + ' .' + this.CPageClass).hide();
if (this.FCurrPage >= 0) {
$('#___page_' + this.FCurrPage).appendTo($('#' + this.FLeftPageId));
$('#___page_' + this.FCurrPage).show('fast'); // 翻頁動畫
if (this.FCurrPage < this.FPageCount) {
++this.FCurrPage;
$('#___page_' + this.FCurrPage).appendTo($('#' + this.FRightPageId));
$('#___page_' + this.FCurrPage).show('fast');
--this.FCurrPage;
}
}
},
Prev: function() { this.setCurrPage(this.FCurrPage - 2); },
Next: function() { this.setCurrPage(this.FCurrPage + 2); }
show('fast') 就是翻頁動畫的來源;想自訂只要換成 fadeIn、slideDown 或自寫的 animate 即可,符合需求中「可訂制動畫」那一條。
$(window).load(function() {
var obj = new TTestPaperProcessor('olThePaper', 'Problem', 'Desc', 'Choices', 'divLeft', 'divRight');
$('#divPrev').click(function() {
try {
obj.Prev();
$('#divPageInfo').text(obj.getCurrPage() + ' of ' + obj.getPageCount());
} catch (e) { alert('No such page!'); }
});
$('#divNext').click(function() {
try {
obj.Next();
$('#divPageInfo').text(obj.getCurrPage() + ' of ' + obj.getPageCount());
} catch (e) { alert('No such page!'); }
});
// 時間到自動提交
function TimeUp() { $('#formPaper').submit(); }
$('#divTimer').countdown({
until: '+90m',
compact: true,
format: 'HMS',
description: '',
onExpiry: TimeUp // 到期回呼,直接送出表單
});
$('#divPageInfo').text(obj.getCurrPage() + ' of ' + obj.getPageCount());
});
這個系統最值得學習的不是程式碼本身,而是把「排版」這個抽象的視覺問題,轉化為可計算的數值問題:選項排版轉化成「四槽背包問題」,分頁轉化成「貪婪裝箱問題」。一旦完成這個轉化,剩下的事情就只是把 DOM 當成畫布去搬動元素。
當然它也有明顯限制:分頁只算高度不算寬度溢出的文字換行、跨頁判定依賴字型載入完成、舊版 IE 需要獨立分支。這些都是後續可持續改善的方向。
原始碼下載:/201007/yuanma/TestPaperProcessor.rar