<script type="text/javascript">
var myObservableArray = ko.observableArray(); // 初始化一個空陣列
myObservableArray.push("Some Value"); // 加入一項
</script>
把一個物件放進 observableArray,並不會讓這個物件自身的屬性變成可監控的。你当然可以另外把該物件的屬性宣告為 observable,但那樣它就變成了依賴監控物件。observableArray 只負責監控它持有的這份清單,並在成員被加入或移除時發出通知。
var anotherObservableArray = ko.observableArray([
{ name: "Bungle", type: "Bear" },
{ name: "George", type: "Hippo" },
{ name: "Zippy", type: "Unknown" }
]);
observableArray 本質上就是一個值為陣列的 observable,所以取值方式和普通 observable 一樣,用無參數呼叫即可:
alert('The length of the array is ' + myObservableArray().length);
alert('The first element is ' + myObservableArray()[0]);
理論上你可以用任何原生陣列函式操作它,但 KO 提供的等價方法更值得用,原因有三:
A. 相容性:例如 indexOf 在 IE8 與更早版本不可用,KO 自己的 indexOf 則全瀏覽器通行。
B. 自動通知:push、splice 這類操作會觸發依賴追蹤,通知所有訂閱者,讓 UI 自動更新。
C. 語法更順手:myObservableArray.push(...) 明顯比 myObservableArray().push(...) 好讀。
indexOf 回傳第一個等於參數的成員索引,找不到則回傳 -1。slice 則等同原生 slice,取出起始索引到結束索引之間的子集合。
myObservableArray.push('Some new value'); // 尾端新增
myObservableArray.pop(); // 移除尾端並回傳該項
myObservableArray.unshift('Some new value'); // 前端新增
myObservableArray.shift(); // 移除前端並回傳該項
myObservableArray.reverse(); // 反轉順序
myObservableArray.sort(); // 排序
這些方法與原生陣列等價,唯一的差別是「陣列改變時會通知訂閱者」。sort 預設以字元或數字排序,也可以傳入比較函式:第一項小於第二項回傳 -1,大於回傳 1,相等回傳 0。
myObservableArray.sort(
function (left, right) {
return left.lastName == right.lastName ? 0
: (left.lastName < right.lastName ? -1 : 1);
});
splice 則用來刪除指定起始索引與數量的元素,並以陣列形式回傳被刪掉的部分。例如 myObservableArray.splice(1, 3) 會從索引 1 開始刪掉 3 個元素(也就是第 2、3、4 項)。
這兩個是 KO 額外加值、原生陣列沒有的方法:
myObservableArray.remove(someItem);
// 刪除所有等於 someItem 的元素,並回傳被刪除的項目
myObservableArray.remove(function (item) {
return item.age < 18;
});
// 刪除所有 age 屬性小於 18 的元素,並回傳被刪除的項目