各種框架都有把一個列表數據綁定到 DOM 上的功能,比如 Angular 會用 ng-repeat 來綁定。那麼 Polymer 呢?其實這個級別的功能屬於框架的擴展功能了,Angular 的 ng-repeat 也只是個 Directive 而已。Polymer 的 dom-repeat 也是這個級別的東西。
在 Polymer 中,一切都是 Directive 的概念。dom-module 用於定義模塊,它本身也是一個 Directive。dom-repeat 也是,但它不是一個標簽,而是一個基於 template 標簽的 Directive。我們可以這樣使用它:
運行
<script> var Polymer = { dom: 'shadow' }; </script>
<base href="http://www.web-tinker.com/share/" />
<link rel="import" href="polymer/polymer.html" />
<dom-module id="demo-test">
<template>
<ul>
<template is="dom-repeat" items="[[data]]">
<li>
第 <strong>[[index]]</strong> 項,
值為 <strong>[[item]]</strong>
</li>
</template>
</ul>
</template>
<script>
Polymer({
is: 'demo-test',
properties: {
data: {
type: Array,
value: [ 'a', 'b', 'c', 'd' ]
}
}
});
</script>
</dom-module>
<demo-test></demo-test>
上面的代碼對某個 template 元素設置 is 屬性為 dom-repeat,於是這個 template 元素內的東西就被循環了。這個循環根據在 template 元素上提供的 items 屬性來遍歷。注意 items 必須是數組,雖然用起來可能有點不太方便,但我覺得這個限制是一個非常好的做法。避免了像 Angular 那樣使用 for-in 去遍歷導致的各種問題。
items 的每一項,其索引和值會被放入 index 和 item 這兩個屬性中供 template 內的模板使用,於是上面的例子就輸出了給定的索引和值。
然而 Polymer 的數據更新並不是基於髒數據比對,所以數據的動態更新可能就有點麻煩。比如我們有一個按鈕,每次點擊要增加一項的話應該這麼寫
運行
<script> var Polymer = { dom: 'shadow' }; </script>
<base href="http://www.web-tinker.com/share/" />
<link rel="import" href="polymer/polymer.html" />
<dom-module id="demo-test">
<template>
<input placeholder="請輸入內容" value="{{value::input}}" />
<button on-click="append">添加一項</button>
<ul>
<template is="dom-repeat" items="[[data]]">
<li>
第 <strong>[[index]]</strong> 項,
值為 <strong>[[item]]</strong>
</li>
</template>
</ul>
</template>
<script>
Polymer({
is: 'demo-test',
properties: {
data: {
type: Array,
value: [ 'a', 'b', 'c', 'd' ]
}
},
append: function() {
// data.push(this.value); // 這麼寫是不行的
this.push('data', this.value)
}
});
</script>
</dom-module>
<demo-test></demo-test>
之前我們說過,Polymer 會將需要監控變化的數據作為一個訪問器屬性來設置,但如果改變數組的元素,實際上並沒有對數組本身有任何改動。當我們把一個數組賦值給 VM 時實際上是把元素復制過去,而不是把數組對象丟過去。也就是說,這個數組對象並不直接是 VM 的引用,操作這個數組對象是無法影響 VM 的,所以直接對數組做 push 只是對數據的 push。
雖然數組自己的 push 方法無法操作 VM,但 Polymer 自己也提供了一些直接操作 VM 的方法,比如上面例子中的 this.push 就是 Polymer 提供的。它的操作模板不是一個對象,而是 VM 上的一個訪問路徑(比如上面例子中 push 的第一個參數 'data' 就是 VM 中 data 訪問路徑)。
除了 push 之外還有 pop、shift 等一些類似原生方法的操作(但要注意他們不是元素方法)。雖然操作起來確實不太方便,但也不至於到惡心的程度,反正我是勉強能接受的。