還在 Table 布局的年代,做產品列表最頭痛的一件事就是:3 列 × 4 行需要 12 格,但產品只有 10 筆,剩下 2 格該怎麼辦?空白還是要渲染出 <td></td>,否則表格會歪掉。寫死当然可以,但資料是動態從資料庫撈出來的,就必須算。
把資料筆數除以欄數,看餘數是多少:
餘數為 0,代表剛好排滿,直接雙層迴圈輸出即可;餘數不為 0,就把最後「餘數」筆拉出來單獨處理,前面用完整的列補齊,最後一列再補上 cols - 餘數 個空格。
/**
* @class renderTable
* 輸入一個數組 和 列數,生成一個表格 table 的 markup。
* @param {Array} list
* @param {Number} cols
* @param {Function} getValue
*/
define(function(require, exports, module) {
module.exports = function (list, cols, getValue){
this.list = list;
this.cols = cols || 5;
this.getValue = getValue || this.getValue;
}
module.exports.prototype = (new function(){
this.render = function(list){
list = list || this.list;
var len = list.length ;
var cols = this.cols;// 位數
var rows;
var remainder = len % cols;
var htmls = [];
rows = len / remainder;
if(remainder == 0){
// 可整除 無余數 直接處理
list.forEach(addTr.bind({ cols : cols, htmls: htmls, getValue : this.getValue }));
}else{
// 處理余數部分
var remainnerArr = list.splice(list.length - remainder);
list.forEach(addTr.bind({ cols : cols, htmls: htmls, getValue : this.getValue }));
// 填空位
var emptyArr = new Array(cols - remainnerArr.length);
emptyArr = emptyArr.join('empty');
emptyArr = emptyArr.split('empty');
// 余數部分 + 空位
remainnerArr = remainnerArr.concat(emptyArr);
if(remainnerArr.length != cols){
throw '最後一行長度錯誤!長度應該為' + cols;
}
remainnerArr.forEach(addTr.bind({ cols : cols, htmls: htmls, getValue : this.getValue }));
}
return addTable(htmls.join(''));
}
/**
* 默認的獲取顯示值的函數。一般要覆蓋該函數。
* @param {Mixed}
* @return {String}
*/
this.getValue = function(data){ return data; }
/**
* 為每個值加個 <td></td>。若滿一行加一個 </tr><tr>
* @param {Mixed} item
* @param {Number} i
* @param {Array} arr
*/
function addTr(item, i, arr){
var html = '<td>' + this.getValue(item) + '</td>';
if(i == 0){
html = '<tr>' + html;
}else if((i + 1) % this.cols == 0 && i != 0){
html += '</tr><tr>';
}else if(i == arr.length){
html += '</tr>';
}
this.htmls.push(html);
}
/**
* @param {String} html
*/
function addTable(html){
return '<table>' + html + '</table>';
}
});
});
這份實作用 Function.prototype.bind 把上下文傳進 forEach 回呼,思路清楚,但其實可以把 htmls 與 cols 收進閉包裡,程式碼會更短。
另外 var rows = len / remainder; 這行算出來的值後面沒有被使用,可以刪掉;而 new Array(n).join('empty').split('empty') 這個產生 n 個佔位元素的技巧雖然聰明,用 Array(cols - remainnerArr.length).fill('') 會更直白。
最後要提醒的是,這種「補空格」的邏輯在今天的專案裡通常交給 CSS 就好:display: grid 搭配 grid-template-columns: repeat(4, 1fr),不足 4 個項目時網格會自動留白,一行程式都不用寫。這套算法真正仍有價值的場景,是需要輸出 email 模板或某些不支援 grid 的環境。