雙向資料綁定的意思是:資料變了,畫面跟著變;畫面上的輸入變了,資料也跟著變。舉例來說,有一個 user 物件帶著 name 屬性,當你執行 user.name = '新名字',頁面上顯示名字的地方自動更新;反過來,如果頁面上有個輸入框綁著 name,使用者打字也會即時反映回 user 物件。
Ember.js、Angular.js、KnockoutJS 都把它當成主打功能,但這不代表實作起來很玄妙,也不代表非得靠框架不可。核心概念其實相當樸素,拆開來只有三件事:
實作方式有很多種,最簡潔有效的一種是「發布/訂閱」(PubSub)模式:在 HTML 上用自訂的 data 屬性標記綁定關係,所有參與綁定的物件與 DOM 元素都訂閱同一個發布者;不論變化來自物件還是輸入框,都交由發布者統一播報。
function DataBinder(object_id) {
// 借用 jQuery 物件當作最簡陋的 PubSub
var pubSub = jQuery({});
// 約定屬性格式:data-bind-<object_id>="<property_name>"
var data_attr = "bind-" + object_id,
message = object_id + ":change";
// 監聽帶綁定屬性的元素變化,代理到 PubSub 上廣播
jQuery(document).on("change", "[data-" + data_attr + "]", function (evt) {
var $input = jQuery(this);
pubSub.trigger(message, [$input.data(data_attr), $input.val()]);
});
// PubSub 把變化傳播給所有綁定的元素
pubSub.on(message, function (evt, prop_name, new_val) {
jQuery("[data-" + data_attr + "=" + prop_name + "]").each(function () {
var $bound = jQuery(this);
if ($bound.is("input, textarea, select")) {
$bound.val(new_val);
} else {
$bound.html(new_val);
}
});
});
return pubSub;
}
function User(uid) {
var binder = new DataBinder(uid);
var user = {
attributes: {},
// setter 透過 PubSub 發布變化
set: function (attr_name, val) {
this.attributes[attr_name] = val;
binder.trigger(uid + ":change", [attr_name, val, this]);
},
get: function (attr_name) {
return this.attributes[attr_name];
},
_binder: binder
};
// 訂閱變化,並避免自己觸發自己造成迴圈
binder.on(uid + ":change", function (evt, attr_name, new_val, initiator) {
if (initiator !== user) {
user.set(attr_name, new_val);
}
});
return user;
}
要綁定時,只要在 HTML 元素上寫好對應的 data 屬性即可:
// JavaScript
var user = new User(123);
user.set("name", "Wolfgang");
// HTML
<input type="number" data-bind-123="name" />
從此輸入框的值會自動映射到 user 的 name 屬性,反之亦然。完成。
現在的專案多半已經載入 jQuery,上面的寫法綽綽有餘。但如果要完全擺脫它(例如只支援 IE8 以上的環境),其實也不難,本質上就是自己實作一次 PubSub,再監聽 DOM 事件。
function DataBinder( object_id ) {
// 自己寫一個極簡的 PubSub
var pubSub = {
callbacks: {},
on: function( msg, callback ) {
this.callbacks[ msg ] = this.callbacks[ msg ] || [];
this.callbacks[ msg ].push( callback );
},
publish: function( msg ) {
this.callbacks[ msg ] = this.callbacks[ msg ] || [];
for ( var i = 0, len = this.callbacks[ msg ].length; i < len; i++ ) {
this.callbacks[ msg ][ i ].apply( this, arguments );
}
}
},
data_attr = "data-bind-" + object_id,
message = object_id + ":change",
changeHandler = function( evt ) {
var target = evt.target || evt.srcElement, // 相容 IE8
prop_name = target.getAttribute( data_attr );
if ( prop_name && prop_name !== "" ) {
pubSub.publish( message, prop_name, target.value );
}
};
// 監聽 change 事件並轉發給 PubSub
if ( document.addEventListener ) {
document.addEventListener( "change", changeHandler, false );
} else {
document.attachEvent( "onchange", changeHandler ); // IE8
}
// PubSub 把變化傳播到所有綁定元素
pubSub.on( message, function( evt, prop_name, new_val ) {
var elements = document.querySelectorAll( "[" + data_attr + "=" + prop_name + "]" ),
tag_name;
for ( var i = 0, len = elements.length; i < len; i++ ) {
tag_name = elements[ i ].tagName.toLowerCase();
if ( tag_name === "input" || tag_name === "textarea" || tag_name === "select" ) {
elements[ i ].value = new_val;
} else {
elements[ i ].innerHTML = new_val;
}
}
});
return pubSub;
}
資料模型幾乎不用改,只把 setter 裡呼叫 jQuery 的 trigger() 換成我們自己寫的 publish():
function User( uid ) {
// ...
set: function( attr_name, val ) {
this.attributes[ attr_name ] = val;
binder.publish( uid + ":change", attr_name, val, this );
}
// ...
}
不到一百行、可讀可維護的原生 JavaScript,就完成了資料雙向綁定。理解這個原理之後,再回頭看那些重型框架,你會發現它們的核心並沒有想像中神秘。