我把自己歸類的一種開發風格稱為「樣式驅動」。這名字是我自己取的,因為在既有的分類裡找不到合適的位置——它既不是 Struts、WebWork 那種以請求為中心的流程,也不是 ASP.NET、JSF 那種以事件為中心的模型,而是把這兩者的優點收攏到最前面的介面層上:只要給元素掛上特定的 CSS 類別,相對應的行為與後台邏輯就會被綁定上去。
請求驅動是最常見的一類 Web 框架實作。一個 HTTP 請求進來,先由一個共用的 Dispatcher Servlet 解析,再分派給對應的應用處理器;處理器依序處理介面特有的控制邏輯、呼叫業務物件、處理工作階段狀態,準備好模型後轉發到檢視。它的結構清楚、職責分明,代價是每個環節都得老老實實寫。
事件驅動的設計目標,是把桌面 UI 裡那套眾所皆知的事件模式搬進瀏覽器。這類框架不太在意表單該提交到哪個 URL、URL 又該映射到哪個控制器;在它們的世界裡,表單元件與監聽器是一對一的搭檔,監聽器透過事件被觸發。頁面被看成一群介面元件的組合,每個元件各自保有自己的狀態,也知道該怎麼呈現自己,甚至可以換上不同的皮膚。
一個偏傳統 MVC,一個是以頁面為中心的快速開發。樣式驅動的做法,是在這兩者之上做一層薄封裝,把介面層的優勢取出來用:為最前端的元素賦予特定樣式,由樣式觸發對應的後台業務,於是「執行請求」與「處理事件」這兩件事被統一在同一個宣告式的手法之下。
它最大的好處是:只要給元素掛上一個 class,就換來一組功能與一段業務處理。編碼量少了,編譯次數也少了,用一句話概括就是「一次編寫,到處綁定」。同一段後台邏輯被反覆使用時,效益特別明顯;在 Ajax 大行其道的今天,把樣式綁定套在既有的請求驅動或事件驅動框架之上,開發效率的提升會相當有感。對於面向服務的開發,這個思路同樣有它的位置。
那麼既有的方案為什麼不夠?
ASP.NET 的 runat="server" 確實有點魔法味,能把前端元素變成後端可用的伺服器控制項。但這種轉換是綁死的:一個 <input type=text runat=server> 永遠只能當文字框用,不可能自己長出別的能力,而且後台必須在對應的頁面類別裡為它寫專屬處理。樣式驅動則把這層限制鬆開——任何元素、控制項、甚至控制項內部的元素,都能靠 JavaScript 在前端轉換成你想要的功能與效果,再送回原本的請求或自訂請求,剛好補上 ASP.NET 的不足。
使用者控制項呢?很抱歉,它與特定頁面耦合得太深,搬到別的專案裡往往派不上用場。Web 控制項庫雖然能重用、耦合也低了,卻有兩個難題:限制太強、複雜度太高。要一個普通程序員從零寫出「可排序、可刪除、可修改、可上下移動、可看詳細資料」的 DataGrid 模板控制項,是一件極度耗神的事。
有人會說,我直接拖一個 DataGrid 再往上加按鈕、模板列、排序、明細連結不就得了?如果只有一個,當然可以。但如果是幾百個 DataGrid,每個都要其中一種或幾種能力,後台就有的寫了;就算你抽出一層、封裝出一個 DataGridBuilder,各種重載方法堆下來,複雜度一樣收拾不住。
改用樣式綁定就清爽多了。要排序,給 DataGrid 一個 CSSClass="sort",後台寫幾行、甚至一行都不寫;要把某個欄位變成刪除鈕,在該欄的 ItemStyle 掛上 CSSClass="delbtn";不需要排序的表格,樣式拿掉就是。頁面類別裡干干净净,被樣式改變過的元素把值送到統一的業務物件處理,一切規規矩矩。
樣式驅動不依賴後台怎麼實作,這也是它容易移植的原因。實現上需要三個 JavaScript 基礎件:事件操作腳本庫(Dean Edwards 與 Tino Zijdel 的 common.js)、樣式基本操作庫(CSS.js,提供 elementHasClass、addClassToElement、getElementsByClass 等),以及大名鼎鼎的 prototype.js。
假設要實作刪除。前端組出來的查詢字串形如:
command=delrow&pars=0^3|1^小明|&table=dgBigclassmanage
後台由 AjaxDelRow.cs 接手,先把 pars 拆成鍵值對,再依 table 參數判斷來源、派發到對應的業務介面:
protected override void DoAJax()
{
// 搜集參數
string parlist = request.Params["pars"];
string[] paritem = parlist.Split('|');
Hashtable hash = new Hashtable(paritem.Length);
for (int i = 0; i < paritem.Length - 1; i++)
{
string[] paritempart = paritem[i].Split('^');
hash.Add(paritempart[0], paritempart[1]);
}
bool isDeled = false;
string table = request.Params["table"];
// 判斷來源
if (table != null)
{
if (table.Equals("dgBigclassmanage")) // DATAGRID 的 ID
{
// 呼叫對應業務外觀的 DAO 來刪除
// hash["0"] 為 datagrid 的第 0 列,假設傳過來的是 ID 值
isDeled = (new BusinessFacade()).DeleteById(hash["0"].ToString());
}
if (isDeled) { Output("true"); }
else { Output("false"); }
}
}
做完這一段,凡是掛上 delbtn 的元素都能觸發刪除。上面的寫法為了示範而簡化——用表格 ID 來判斷來源在真實專案裡並不嚴謹,比較妥當的做法是在查詢字串裡多帶一個業務識別參數,派發之後再做一次二次派發,以該參數作為路由依據。
由於這套樣式只依賴 TABLE 元素,所以 DataGrid、DataList、自己手寫的 table,甚至最終會渲染成 table 的自訂控制項,全都能吃。這篇文章主要提供的是一個思路,跟程式碼寫得多漂亮關係不大;在 .NET 裡輕量地使用樣式綁定,搭配 Ajax 應用的效果確實很好,你也可以在此基礎上實作一個更優秀的輕量框架。
下面是功能按鈕的控制腳本骨架。它一開始就掃過文件裡所有 table,凡是掛了 crudtable 的就接管;接著逐列逐格檢查有沒有 delbtn、editbtn、updownbtn,有的就把該格轉換成對應的連結:
var crudbtn = {
that: false,
isOdd: false,
lastAssignedId: 0,
addbtnid: 0,
newRows: -1,
init: function() {
// 有些瀏覽器不支援 getElementsByTagName,先擋一下
if (!document.getElementsByTagName) { return; }
this.that = this;
this.run();
},
// 遍歷所有 table,有 crudtable 樣式就接管
run: function() {
var tables = document.getElementsByTagName("table");
for (var i = 0; i < tables.length; i++) {
if (CSS.elementHasClass(tables[i], 'crudtable')) {
this.makecrudTable(tables[i]);
}
}
},
makecrudTable: function(table) {
if (!table.id) {
table.id = 'crudTable' + this.lastAssignedId++;
}
for (var j = 0; j < table.tBodies[0].rows.length - 1; j++) {
var row = table.tBodies[0].rows[j + 1];
for (var k = 0; k < row.cells.length; k++) {
var cell = row.cells[k];
// 刪除鈕
if (CSS.elementHasClass(cell, 'delbtn')) {
cell.id = 'delbtn' + this.addbtnid++;
var linkEl = createElement('a');
linkEl.href = '#';
linkEl.onclick = this.delRow;
linkEl.setAttribute('columnId', k);
linkEl.innerText = "刪除";
cell.appendChild(linkEl);
}
// 修改鈕
if (CSS.elementHasClass(cell, 'editbtn')) {
cell.id = 'editbtn' + this.addbtnid++;
var linkEl = createElement('a');
linkEl.href = '#';
linkEl.onclick = this.editRow;
linkEl.setAttribute('columnId', k);
linkEl.innerText = "修改";
cell.appendChild(linkEl);
}
// 上移/下移鈕
if (CSS.elementHasClass(cell, 'updownbtn')) {
cell.id = 'updownbtn' + this.addbtnid++;
var linkEl = createElement('a');
linkEl.href = '#';
linkEl.onclick = this.upRow;
linkEl.setAttribute('columnId', k);
linkEl.innerText = "上移";
cell.appendChild(linkEl);
var p = createElement('span');
p.innerHtml = " ";
cell.appendChild(p);
var linkEl2 = createElement('a');
linkEl2.href = '#';
linkEl2.onclick = this.downRow;
linkEl2.setAttribute('columnId', k);
linkEl2.innerText = "下移";
cell.appendChild(linkEl2);
}
}
}
// 隔行換色,依賴 odd 樣式
this.isOdd = true;
var rows = table.tBodies[0].rows;
for (var i = 0; i < rows.length - 1; i++) {
this.DOStripe(rows[i + 1]);
}
},
// 隔行分色策略,依賴 odd 樣式
DOStripe: function(rowItem) {
if (!this.isOdd) { CSS.addClassToElement(rowItem, 'odd'); }
else { CSS.removeClassFromElement(rowItem, 'odd'); }
this.isOdd = !this.isOdd;
},
delRow: function(e) { /* 收集該列資料、呼叫 Ajax、移除列、重排底色 */ },
editRow: function(e) { /* 把可編輯格換成 input,鈕改為「確定/取消」 */ },
cancelRow: function(e) { /* 以 oldValue 還原原值 */ },
upRow: function(e) { /* table.moveRow + 重新隔行換色 + Ajax 同步 */ },
downRow: function(e) { /* 同上,方向相反 */ }
};
function crudbtnInit() { crudbtn.init(); }
// 回呼:處理結束後的反映
afterUpdate = function(e) {
if (e == 'true') {
// 成功,什麼都不用做
} else if (e == 'false') {
alert("您的操作失敗了,請重新嘗試");
window.location.reload();
} else if (e == 'repeated') {
alert("您寫入了重複的資訊!請重新輸入");
window.location.reload();
}
};
addEvent(window, 'load', crudbtnInit);
幾個關鍵手法值得單獨點出來。刪除時並不是把整列丟掉就好,而是先掃過該列所有格子、把值組進 pars 字串送給後台,再從 DOM 移除,最後重跑一次隔行換色——少了最後這步,刪完一列底色就會亂掉。修改時會在 tr 上打一個 editing 標記,第二次點擊同一顆鈕就代表「確定」,這時候才收集輸入框的值送出。上移與下移共用同一支後台邏輯,只是把 pars 與 pars2 對調,後端不必多寫一份。
原文的程式碼裡,隔行換色與 class 判斷函式的大小寫寫法並不一致(css.elementHasClass 與 CSS.elementHasClass 混用),tBodIEs 也應寫成標準的 tBodies;上面的整理已統一為一致且可執行的形式。另外 innerHtml 一律應改為 innerHTML,而 removeNode、innerText 屬 IE 特有方法,跨瀏覽器時要改用 removeChild 與 textContent。
排序走的是另一條路:它不需要 Ajax,只要把排序方向與欄位索引塞進 __doPostBack 的參數,讓後端重新排序後再綁定一次即可。
var sorting = {
that: false,
isOdd: false,
sortColumnIndex: -1,
lastAssignedId: 0,
lastSortedTable: -1,
init: function() {
if (!document.getElementsByTagName) { return; }
this.that = this;
this.run();
},
// 在文件中遍歷所有 table,有 sort 樣式就啟動排序
run: function() {
var tables = document.getElementsByTagName("table");
for (var i = 0; i < tables.length; i++) {
if (CSS.elementHasClass(tables[i], 'sort')) {
this.makeSortable(tables[i]);
}
}
},
makeSortable: function(table) {
if (!table.id) {
table.id = 'sortableTable' + this.lastAssignedId++;
}
if (table.rows.length < 2) { return; }
// 把第一列視為表頭,第二列用來解析初始排序方向
var row = table.tBodies[0].rows[0];
var row2 = table.tBodies[0].rows[1];
for (var i = 0; i < row.cells.length; i++) {
var linkEl = createElement('a');
linkEl.href = '#';
linkEl.onclick = this.headingClicked;
linkEl.setAttribute('columnId', i);
linkEl.title = '點擊排序';
var innerEls = row.cells[i].childNodes;
for (var j = 0; j < innerEls.length; j++) {
// 標題列掛了 nosort 就不排序
if (!CSS.elementHasClass(row.cells[i], 'nosort')) {
linkEl.appendChild(innerEls[j]);
}
}
row.cells[i].appendChild(linkEl);
var spanEl = createElement('span');
CSS.addClassToElement(row.cells[i], 'tableSortArrow');
row.cells[i].appendChild(spanEl);
// 判斷後台傳來的排序方向樣式
if (CSS.elementHasClass(row2.cells[i], 'sortOrderASC')) {
spanEl.appendChild(document.createTextNode(' ↑'));
spanEl.setAttribute('sortOrder', 'ASC');
} else if (CSS.elementHasClass(row2.cells[i], 'sortOrderDESC')) {
spanEl.appendChild(document.createTextNode(' ↓'));
spanEl.setAttribute('sortOrder', 'DESC');
}
}
this.isOdd = false;
var rows = table.tBodies[0].rows;
for (var i = 0; i < rows.length; i++) { this.DOStripe(rows[i]); }
},
headingClicked: function(e) {
var that = sorting.that;
var linkEl = getEventTarget(e);
var td = linkEl.parentNode;
var tr = td.parentNode;
var thead = tr.parentNode;
var table = thead.parentNode;
var column = linkEl.getAttribute('columnId') || td.cellIndex;
// 找出目前這一列的排序方向
var arrows = CSS.getElementsByClass(td, 'tableSortArrow', 'span');
var previousSortOrder = '';
if (arrows.length > 0) {
previousSortOrder = arrows[0].getAttribute('sortOrder');
}
that.lastSortedTable = table.id;
// 先把所有排序箭頭歸零
var allArrows = CSS.getElementsByClass(tr, 'tableSortArrow', 'span');
for (var j = 0; j < allArrows.length; j++) {
var arrowParent = allArrows[j].parentNode;
arrowParent.removeChild(allArrows[j]);
if (arrowParent != td) {
var spanEl = createElement('span');
spanEl.className = 'tableSortArrow';
arrowParent.appendChild(spanEl);
}
}
// 再回饋新的方向給使用者
var spanEl = createElement('span');
spanEl.className = 'tableSortArrow';
if (previousSortOrder == '' || previousSortOrder == 'DESC') {
spanEl.appendChild(document.createTextNode(' ↑'));
td.setAttribute('sortOrder', 'ASC');
spanEl.setAttribute('sortOrder', 'ASC');
} else {
spanEl.appendChild(document.createTextNode(' ↓'));
td.setAttribute('sortOrder', 'DESC');
spanEl.setAttribute('sortOrder', 'DESC');
}
td.appendChild(spanEl);
// 進入後台處理
__doPostBack('Pars', "sortdirect=" + td.getAttribute('sortOrder')
+ "&colid=" + td.firstChild.getAttribute('columnId'));
return false;
},
DOStripe: function(rowItem) {
if (!this.isOdd) { CSS.addClassToElement(rowItem, 'odd'); }
else { CSS.removeClassFromElement(rowItem, 'odd'); }
this.isOdd = !this.isOdd;
}
};
function sortInit() { sorting.init(); }
addEvent(window, 'load', sortInit);
後台這邊只需要一個方法,把 __EVENTARGUMENT 拆開、取出排序方向與欄位索引,然後依控制項的型別走不同的路:
public DataView SortBuilder(object dataobj, DataView dv)
{
string req = Request.Form["__EVENTARGUMENT"];
string p_sort = null;
string p_colid = null;
if (req != null)
{
string[] args = req.Split('&');
foreach (string arg in args)
{
string[] hash = arg.Split('=');
if (hash[0].Equals("sortdirect")) { p_sort = hash[1]; }
else if (hash[0].Equals("colid")) { p_colid = hash[1]; }
}
if (p_sort != null && p_colid != null && !p_colid.Equals("null"))
{
SortDirect = p_sort;
int iColid = Int32.Parse(p_colid);
if (dataobj is DataGrid)
{
foreach (DataGridColumn dc in ((DataGrid)dataobj).Columns)
{
if (dc.ItemStyle.CSSClass.IndexOf("sortOrder") != -1)
{
dc.ItemStyle.CSSClass = "";
}
}
((DataGrid)dataobj).Columns[iColid].ItemStyle.CSSClass
+= " sortOrder" + SortDirect;
BoundColumn bc = (BoundColumn)((DataGrid)dataobj).Columns[iColid];
dv.Sort = bc.DataField + " " + SortDirect;
}
if (dataobj is DataList)
{
DataList dl = (DataList)dataobj;
dl.ItemStyle.CSSClass += " sortOrder" + SortDirect;
dv.Sort = dl.DataKeyField + " " + SortDirect;
}
// 自訂控制項可自行實作這一段
if (dataobj is Table)
{
Table tbl = (Table)dataobj;
IList list = tbl.ColumnList;
tbl.ColName = list[iColid].ToString();
tbl.SortDirect = SortDirect;
dv.Sort = list[iColid] + " " + SortDirect;
}
}
}
return dv;
}
這裡的巧妙之處是雙向的:後台把排序方向寫進 ItemStyle 的 CSSClass(sortOrderASC 或 sortOrderDESC),前端腳本下次載入時讀到這個樣式,就能還原箭頭方向。樣式不只是外觀,它同時充當了狀態的載體。
排序樣式的使用方式非常短。前台引用 JS 並掛上 sort 樣式,後台則是:
DataSet ds = 取得資料來源; DataView dv = ds.Tables[0].DefaultView; dv = SortBuilder(控制項, dv); 控制項.DataSource = dv;
把這套思路放回日常的 Ajax 開發裡,你會發現它節省下來的不是幾行程式碼,而是「每個頁面都要再想一次怎麼做」的心智負擔。當然,任何抽象都有代價:樣式名稱就是隱含的契約,團隊成員必須知道 crudtable、delbtn、sort 各自代表什麼;而所有邏輯都收攏在前端腳本裡,也意味著除錯時得習慣往瀏覽器的開發者工具裡鑽。取捨還是要看專案的規模與團隊的默契。