xmlplus組件設計系列之路由（ViewStack)（7），xmlplusviewstack

xmlplus組件設計系列之路由（ViewStack)（7），xmlplusviewstack

在瀏覽器端，對路由的理解一般是根據不同的 URL 完成頁面的切換。在伺服器端，則是根據不同的 URL 請求回饋相關的頁面。在本章，我們廣義的組件路由的定義：根據接收到的不同命令，組件對象呈現出不同的子級頁面。在這裡將介紹與路由相關的一個組件，即視圖棧 ViewStack。

視圖棧初步

該組件在《文檔》部分的最後一個章節《延遲執行個體化》已經出現過了。這裡將對一些細節部分進行解讀。下面再次給出該組件的源碼。

ViewStack: {  xml: "<div id='viewstack'/>", fun: function (sys, items, opts) {  var args, children = this.children(),   table = children.call("hide").hash(),   ptr = table[opts.index] || children[0];  if (ptr) ptr = ptr.trigger("show").show();  this.on("switch", function ( e, to ) {   table = this.children().hash();   if ( !table[to] || table[to] == ptr ) return;   e.stopPropagation();   args = [].slice.call(arguments).slice(2);   ptr.trigger("hide", [to+''].concat(args)).hide();   ptr = table[to].trigger("show", [ptr+''].concat(args)).show();  });  return Object.defineProperty({}, "selected", { get: function() {return ptr;}}); }}

從靜態介面看，該組件允許提供靜態參數 index，該參數是組件 ViewStack 某一兒子組件對象的名稱，它用於指出哪一個子級組件會被最先呈現。請看下面的樣本。

Example1: { xml: `<ViewStack index='bar'>    <button id='foo'>foo</button>    <button id='bar'>bar</button>   </ViewStack>`}

該樣本中，ViewStack 包含一值為 bar 的屬性 index，表明組件在執行個體化時，組件對象 bar 會最先呈現。而預設情況下，該組件的第一個子級組件會作為初始顯示對象。再從動態介面看，該組件的函數項匯出了一個名為 selected 的唯讀屬性，該屬性用於指示當前顯示的子級組件對象。

通過事件切換目標組件對象

對於子級組件對象之間切換，該組件的函數項並未匯出相關的介面，而是通過接收 switch 事件來完成切換。請看下面的樣本。

Example2: { xml: "<ViewStack id='viewstack'>\    <button id='foo'>foo</button>\    <button id='bar'>bar</button>\   </ViewStack>" fun: function (sys, items, opts) {  sys.viewstack.on("click", "*", function(e) {   var to = this + '' == "foo" ? "bar" : "foo",    data = "hello, world";   this.trigger("switch", [to, data]);  });  sys.foo.on("show", function (e, prev, data) {   console.log("previous page is " + prev, "from data is " + data);  });  sys.bar.on("hide", function (e, prev, data) {   console.log("previous page is " + prev, "from data is " + data);  }); }}

對於該樣本，當使用者點擊文字時，文字會在 foo 和 bar 之間切換，也即兩個頁面之間切換，切換是通過相應子級對象派發 switch 事件進行的。另外，組件 ViewStack 在切換頁面時，還會對本次顯示的頁面派發事件 show，以及對本次隱藏的頁面派發事件 hide，相關頁面可以根據需要選擇偵聽與否。並且在偵聽函數中，可以獲知前一顯示頁面 ID 以及所傳輸的相關資料。

動態添加與移除子級對象

組件 ViewStack 支援動態添加與移除子級的組件對象，請看下面的一個樣本。

Example3: { xml: "<ViewStack id='viewstack'>\    <button id='foo'>foo</button>\   </ViewStack>" fun: function (sys, items, opts) {  var xml = "<button id='bar'>bar</button>";  sys.viewstack.append(xml).trigger("switch", "bar"); }}

該樣本中，函數項中動態添加了一個子級組件，並且通過派發事件 switch 將當前顯示的視圖切換為剛新添加的視圖。

最佳化配置

組件 ViewStack 一般配合組件的延遲執行個體化功能使用。對於一些比較複雜的組件，這樣有助於加快顯示應用的初始頁面。下面做簡單示範。

Example4: { xml: `<ViewStack>    <button id='foo'>foo</button>    <button id='bar'>bar</button>    <button id='alice'>alice</button>   </ViewStack>` map: { defer: "bar alice" }}

此樣本中，ViewStack 子級包含三個子組件，其中組件對象 bar 和 alice 被設定為需要延遲執行個體化，只有當這兩組件對象的 show 函數得到調用時，它們才真正開始執行個體化。

與 HTML5 History API 的配合使用

這裡我們看看如何讓組件 ViewStack 與 HTML5 History API 的配合使用。下面是一個簡單的例子。

Example5: { xml: `<ViewStack id='example'>    <button id='foo'>foo</button>    <button id='bar'>bar</button>    <button id='alice'>alice</button>   </ViewStack>`, fun: function (sys, items, opts) {  sys.example.on("show", "button", function (e, prev) {   window.history.pushState({name: this + ""}, null, "/" + this);  });  window.addEventListener("popstate", function(e) {   sys.example.trigger("switch", e.state.name);  }); }}

該樣本的關鍵點在於，當視圖棧組件對象的子級頁面發生變更時，使用函數 pushState 記錄下來；另外需要偵聽瀏覽器的 popstate 事件，當使用者點擊「前進」、「後退」按鈕時，完成相應頁面的切換。這種技術非常適合在單頁應用中完成無重新整理跳轉，可以給使用者帶來非常好的體驗。

本系列文章基於 xmlplus 架構。如果你對 xmlplus 沒有多少瞭解，可以訪問 www.xmlplus.cn。這裡有詳盡的入門文檔可供參考。

以上就是本文的全部內容，希望對大家的學習有所協助，也希望大家多多支援幫客之家。