各種框架都有把一個列表數據綁定到 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 等一些類似原生方法的操作(但要注意他們不是元素方法)。雖然操作起來確實不太方便,但也不至於到惡心的程度,反正我是勉強能接受的。