xmlplus組件設計系列之樹(Tree)(9)
樹形組件是一種具有層級結構的組件,廣泛應用于各種場景。本章會實現(xiàn)一個簡單的樹形組件,盡管功能有限,但你可以通過擴展它來實現(xiàn)自己所需要的樹形組件。
數(shù)據(jù)源
樹形組件的數(shù)據(jù)源可以是 JSON 格式的數(shù)據(jù)對象,也可以是具有 XML 結構的數(shù)據(jù)或者是其它的具有層級結構的數(shù)據(jù)。本章將采用具有如下 JSON 格式的數(shù)據(jù)對象。
var data = { name: 'My Tree', children: [ { name: 'hello' }, { name: 'world' }, { name: 'child folder', children: [ { name: 'alice' } ] } ] };
上述數(shù)據(jù)源中,name 值會作為樹結點的名稱顯示,含 children 的數(shù)組代表節(jié)點的子級。
遞歸結構的設計
由 HTML 中的列表元素 ul 以及 li 組合而成對象具有天然的樹形結構,我們不妨采用它們作為構建樹形組件的基本元素。樹形組件的最外層必然是一個 ul 元素,所以我們可以暫時定義樹形組件如下:
Tree: { xml: `<ul id='tree'> <Item id='item'/> </ul>` }
這里的未定義的組件 Item 是一個需要遞歸定義的子項組件,它會根據(jù)提供的數(shù)據(jù)遞歸地生成子孫對象。下面是一種可能的設計:
Item: { xml: `<li id='item'> <div id='content'> <span id='neme'/><span id='expand'/> </div> <ul id='entries'/> </li>`, map: { defer: "entries" } }
注意,上面的 neme 對象是用于顯示 name 屬性的。expand 對象用于展開或者關閉子級對象 entries。子級對象 entries 被設置為需要延遲實例化,只有當用戶點擊 expand 對象展開子級時,該對象才會實例化。
數(shù)據(jù)的加載與渲染
如上一節(jié)所述,我們設定了子級對象 entries 需要延遲實例化。所以,在給子項 Item 提供的數(shù)據(jù)設置接口不應該立馬對 entries 實例化。下面我們先給出數(shù)據(jù)接口函數(shù)。
Item: { // css, xml, map 項同上 fun: function (sys, items, opts) { var data; function val(value) { data = value; sys.neme.text(data.name); data.children && data.children.length && sys.expand.show().text(" [+]"); } return { val: val }; } }
該接口函數(shù) val 只是設置了當前節(jié)點相關的內容。下面我們來偵聽 expand 對象的點擊事件,并適時地完成組件對象 entries 的實例化。
Item: { // css, xml, map 項同上 fun: function (sys, items, opts) { var data, open; sys.expand.on("click", function () { open = !open; sys.expand.text(open ? " [-]" : " [+]"); open ? (sys.entries.show() && load()) : sys.entries.hide(); }); function load() { if ( sys.entries.children().length == 0 ) for ( var item of data.children ) sys.add.before("Item").value().val(item); } function val(value) { data = value; sys.neme.text(data.name); data.children && data.children.length && sys.expand.show().text(" [+]"); } return { val: val }; } }
上述代碼中包含一個 open 參數(shù),該參數(shù)記錄了當前節(jié)點的是否處于展開狀態(tài)以供相關的偵聽器使用。
動態(tài)添加節(jié)點
現(xiàn)在我們對上述組件進行一個小的擴展,使得它支持動態(tài)添加樹節(jié)點的功能。首先,我們在對象 entries 的子級添加一個觸發(fā)按鈕,并命名為 add。
Item: { xml: "<li id='item'> <div id='content'> <span id='neme'/><span id='expand'/> </div> <ul id='entries'> <li id='add'>+</li> </ul> </li>", map: { defer: "entries" } }
其次,需要偵聽 add 對象的點擊事件,在偵聽器中完成對象的添加。
Item: { // css, xml, map 項同前 fun: function (sys, items, opts) { var data, open; sys.item.on("click", "http://*[@id='add']", function () { var stuff = {name: 'new stuff'}; data.children.push(stuff); sys.add.before("Item").value().val(stuff); }); // 其余代碼同前 } }
這里需要注意,對 add 對象的偵聽不能采取直接式的偵聽:sys.add.on("click",...),而應該使用代理的方式,否則會報錯。因為其父級屬于延遲實例化的組件,在 entries 對象未實例化之間,add 對象并不可見。
完整的樹形組件
綜合以上的內容,現(xiàn)在給出一個完整版本的樹形組件:
Tree: { css: `#tree { font-family: Menlo, Consolas, monospace; color: #444; } #tree, #tree ul { padding-left: 1em; line-height: 1.5em; list-style-type: dot; }`, xml: `<ul id='tree'> <Item id='item'/> </ul>`, fun: function (sys, items, opts) { return items.item; } }, Item: { css: "#item { cursor: pointer; }", xml: `<li id='item'> <div id='content'> <span id='neme'/><span id='expand'/> </div> <ul id='entries'> <li id='add'>+</li> </ul> </li>`, map: { defer: "entries" }, fun: function (sys, items, opts) { var data, open; sys.item.on("click", "http://*[@id='add']", function () { var stuff = {name: 'new stuff'}; data.children.push(stuff); sys.add.before("Item").value().val(stuff); }); sys.expand.on("click", function () { open = !open; sys.expand.text(open ? " [-]" : " [+]"); open ? (sys.entries.show() && load()) : sys.entries.hide(); }); function load() { if ( sys.entries.children().length == 1 ) for ( var item of data.children ) sys.add.before("Item").value().val(item); } function val(value) { data = value; sys.neme.text(data.name); data.children && data.children.length && sys.expand.show().text(" [+]"); } return { val: val }; } }
在實際應用中的樹形組件會比這里的功能更豐富些,你可以在上述代碼的基礎上進一步的改進,比如添加些 ICON 圖標、讓子項成為可拖動的等等。但在改進過程中盡量避免代碼的復雜化,適當?shù)貏冸x些代碼出來封裝成組件是非常有必要的。
本系列文章基于 xmlplus 框架。如果你對 xmlplus 沒有多少了解,可以訪問 www.xmlplus.cn。這里有詳盡的入門文檔可供參考。
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持腳本之家。
相關文章
iframe自適應寬度、高度 ie6 7 8,firefox 3.86下測試通過
近期需要一個iframe自適應高度的東西,在網上找了很多,都不能用……一看大體的日期都是大概 2008年前后的其他近期的基本都是以前的轉載,所以只好自己動手了。2010-07-07JavaScript面試出現(xiàn)頻繁的一些易錯點整理
通過幾個常見面試開始,討論針對一個題目的分析思路,就有了下面這篇文章,本文主要給大家整理總結介紹了關于JavaScript面試中會頻繁出現(xiàn)的一些易錯點,對大家具有一定的參考學習價值,需要的朋友們下面隨著小編來一起看看吧。2018-03-03javascript控制Div層透明屬性由淺變深由深變淺逐漸顯示
控制Div層透明屬性,由淺變深逐漸顯示,由深變淺逐漸消失,具體實現(xiàn)代碼如下,喜歡的朋友可以感受下2013-11-11javascript 判斷數(shù)組是否已包含了某個元素的函數(shù)
javascript判斷數(shù)組是否已包含了某個元素的js函數(shù),方便數(shù)組的判斷。2010-05-05