如何使用組件：

描述文件的位置

XML描述文件的位置由請(qǐng)求參數(shù)__xmlpath決定，比如：

http://simpleframework.net/t.do?__xmlpath=/demo/t.xml&p1=data1&p2=data2 

如果訪問的是JSP文件，則__xmlpath可以不定義，此時(shí)， XML描述文件的位置被默認(rèn)為和JSP文件同路徑并且同文件名的XML文件。

在Eclipse等IDE下，可以通過引入本地XMLSchema來(lái)加快開發(fā)及合法性驗(yàn)證：

<?xml version="1.0" encoding="UTF-8"?> 
<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xsi:noNamespaceSchemaLocation="/xsd/default/simple.xsd"> 
    ...  
</page> 

組件的定義

SimpleFramework的所有組件都是在XML描述文件中的components標(biāo)簽下定義的， 這有別于標(biāo)簽庫(kù) (TagLibs)，能更好的把展示(HTML/JSP)和定義(XML)進(jìn)行有效的分離。比如，定義一個(gè)樹組件：

<?xml version="1.0" encoding="UTF-8"?> 
<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xsi:noNamespaceSchemaLocation="/xsd/default/simple.xsd"> 
    <components> 
        <tree name="doc2Tree" containerId="doc2Tree"> 
        </tree> 
        ...  
    </components> 
</page>    

組件和頁(yè)面文檔元素的綁定

組件和頁(yè)面文檔元素的綁定是通過CSS Selector實(shí)現(xiàn)的，有了這種綁定關(guān)系， 一般來(lái)講，組件會(huì)對(duì)頁(yè)面DOM元素進(jìn)行如下可能性的增強(qiáng)：

為綁定的元素添加屬性和事件

為綁定的元素添加子元素

移動(dòng)綁定的元素到適合的位置

添加腳本支持

這種增強(qiáng)性的操作都是由SimpleFramework自動(dòng)完成的，客戶端只需要根據(jù)組件的差異來(lái)定義不同的綁定關(guān)系，如上述的樹組件，containerId屬性定義了基于ID的選擇器，這樣，組件生成的代碼為綁定的元素添加需要子元素(樹)。

通過Javascript調(diào)用組件

組件的調(diào)用是通過一個(gè)內(nèi)置的Javascript對(duì)象$Actions來(lái)完成的，更多關(guān)于$Actions的介紹請(qǐng)參考$Actions是什么。

$Actions是什么

$Actions是一個(gè)Javascript對(duì)象

$Actions是一個(gè)Javascript對(duì)象，是window的一個(gè)子對(duì)象，可以通過window.$Actions或則直接$Actions訪問。

$Actions的目標(biāo)及組件對(duì)象

$Actions的目標(biāo)是客戶端(瀏覽器)能通過Javascript來(lái)調(diào)用組件對(duì)象。絕大多數(shù)組件都會(huì)在$Actions里生成一個(gè)操作自己行為的組件對(duì)象，該組件對(duì)象可以通過$Actions["name"]訪問， name是組件的名稱，在組件描述文件中必須定義該名稱。

組件對(duì)象定義了自己的屬性及方法，可以通過Javascript來(lái)調(diào)用這些屬性及方法。比如刷新樹組件：

$Actions["treeName"].refresh(); 

$Actions["name"]()是組件的缺省函數(shù)，在大部分情況下，缺省函數(shù)體現(xiàn)了這個(gè)組件的主要特性，比如，$Actions["ajaxRequest"]()即發(fā)出一個(gè)AJAX請(qǐng)求; $Actions["treeName"]()即構(gòu)造了整棵樹。

$Actions.callSafely函數(shù)

$Actions定義了callSafely函數(shù)來(lái)安全的訪問組件對(duì)象。因?yàn)樵陧?yè)面裝載的時(shí)候，組件對(duì)象可能還沒生成，就有腳本開始調(diào)用該組件對(duì)象，通過callSafely函數(shù)可以確保組件對(duì)象已經(jīng)存在再開始調(diào)用。