| 組件 | 職責 | 關鍵 API |
|---|---|---|
| Model | 單一資料實體、業務邏輯、同步伺服器 | defaults, fetch/save/destroy, validate, get/set, toJSON |
| Collection | Model 有序集合、批次同步、排序/過濾 | model, url, add/remove/reset, fetch, comparator, each/map/filter |
| View | UI 渲染、事件委派、模板綁定、Model/Collection 監聽 | el, template, events, initialize, render, listenTo, remove |
| Router | URL 雜湊路由、單頁應用導航 | routes, navigate, execute, Backbone.history.start() |
const Student = Backbone.Model.extend({
urlRoot: '/api/students',
defaults: { name: '', age: 0, grade: '' },
validate(attrs) { if (!attrs.name) return '姓名必填'; }
});
const Students = Backbone.Collection.extend({
model: Student,
url: '/api/students',
comparator: 'name' // 排序
});
const StudentRow = Backbone.View.extend({
tagName: 'tr',
template: _.template($('#tpl-student-row').html()),
events: {
'click .edit': 'enableEdit',
'click .delete': 'deleteModel',
'blur input, select': 'saveModel'
},
initialize() {
this.listenTo(this.model, 'change', this.render);
this.listenTo(this.model, 'destroy', this.remove);
},
enableEdit() { this.$('input,select').prop('disabled', false).first().focus(); },
deleteModel() { this.model.destroy(); },
saveModel() {
const data = {};
this.$('input,select').each((i, el) => data[el.name] = el.value);
this.model.save(data, { patch: true });
},
render() { this.$el.html(this.template(this.model.toJSON())); return this; }
});
const StudentList = Backbone.View.extend({
el: '#student-app',
template: _.template($('#tpl-student-list').html()),
initialize() {
this.collection = new Students();
this.listenTo(this.collection, 'add', this.addOne);
this.listenTo(this.collection, 'reset', this.render);
this.collection.fetch({ reset: true }); // 初始載入
},
events: { 'click #add-student': 'addNew' },
addNew() {
const m = new Student({ name: '新學生', age: 18 });
this.collection.create(m, { wait: true }); // 等 server 回應再 add
},
addOne(model) {
const view = new StudentRow({ model });
this.$('tbody').append(view.render().el);
},
render() {
this.$el.html(this.template());
this.collection.each(this.addOne, this);
return this;
}
});
const AppRouter = Backbone.Router.extend({
routes: {
'': 'list',
'student/:id': 'detail',
'student/:id/edit': 'edit'
},
list() { new StudentList(); },
detail(id) { /* 顯示詳情 */ },
edit(id) { /* 編輯頁 */ }
});
Backbone.history.start({ pushState: true, root: '/' });
<script type="text/template" id="tpl-student-list">
<button id="add-student">新增學生</button>
<table><thead><tr><th>姓名</th><th>年齡</th><th>操作</th></tr></thead><tbody></tbody></table>
</script>
<script type="text/template" id="tpl-student-row">
<td><input name="name" value="<%= name %>" disabled /></td>
<td><input name="age" type="number" value="<%= age %>" disabled /></td>
<td>
<a class="edit" href="#">編輯</a> |
<a class="delete" href="#">刪除</a>
</td>
</script>
listenTo 替代 model.on:View 銷毀時自動解除綁定,防洩漏。wait: true:collection.create(model, {wait:true}) 等伺服器 200 回應後再觸發 add,避免樂觀 UI 失敗殘留。patch: true:model.save(data, {patch:true}) 發送 PATCH 僅更新變更欄位。_.templateSettings 或預編譯工具避免運行時編譯開銷。Backbone 為輕量 MV* 先驅,現代專案多轉向 React/Vue/Svelte。維護舊專案時,理解其「事件驅動、手動綁定、模板分離」思想有助於重構或漸進式遷移(如逐步以 React Component 替換 Backbone View)。