Flower組件庫使用說明

Flower組件庫使用說明Tapestry中文有“錦”的意思，而中國有句人人皆知的成語“錦上添花”，希望我們的公共組件庫就像“錦”上的花兒一樣，所以給我們的組件庫起名為flower，哈哈Flower組件庫使用說明 1一、 普通組件 21、 WebInfo 22、 WebCtrl 23、 AjaxAny 44、 Tipster 5二、 Form類組件 51、 LookupCombo 5三、 頁面類組件 71、 Tree 72、 MiniWin 9四、 服務(wù) 111、 swallow 11五、 常用腳本 121、 /com/linkage/flower/tapestry/js/webctrl.js 12

普通組件WebInfo描述 使用webInfo組件，可以在頁面上保存一些頁面信息，比如：servlet的路徑、頁面的名稱等等。該組件還提供屬性otherInfo供界面開發(fā)時擴展用。參數(shù) 名稱類型方向是否必須默認(rèn)值描述tradeStatusStringinno預(yù)留,可以記錄當(dāng)前頁面是處于某種狀態(tài)或者步驟下otherInfoStringinno預(yù)留，供調(diào)用的界面擴展用Body:removedInformalparameters:forbiddenReservedparameters:none實例html: <spanjwcid=”@flower:WebInfo”/>javascript: varg=getTradeGlobal(); alert(g.servletPath);//獲取servletPathalert(g.pageName);//獲取當(dāng)前頁面名稱setErrow(true);//對當(dāng)前頁面設(shè)置錯誤標(biāo)記alert(existError());//檢查是否存在錯誤標(biāo)記alert(g.otherInfo)//獲取otherInfo信息alert(g.tradeStatus)//獲取tradeStatus信息WebCtrl描述 用來對web頁面進行一些常規(guī)的控制，比如：實時檢查界面輸入內(nèi)容的格式、為必輸項自動添加紅色的星號、為頁面中的submit、image添加鎖。 添加該組件后可以使用一系列的ajax方法:ajaxDirectLink/ajaxSwallow/AnyCall 該組件是編輯頁面最常規(guī)的組件，建議編輯界面都添加該組件。參數(shù)名稱類型方向是否必須默認(rèn)值描述verifyDataStringinnoyes實時檢查數(shù)據(jù)的格式是否正確checkMustFillStringinnoyes自動為必輸項添加紅色星號作為標(biāo)記lookupComboStringinnoyes為頁面上的LookupComb組件做初始化工作formAutoLockedStringinnono為頁面中的submit、image添加鎖Body:removedInformalparameters:forbiddenReservedparameters:none實例 html: <spanjwcid=”@flower:WebCtrl”/> 另外:對頁面中必輸項添加required=”true”屬性。比如<inputname=”name”required=”true”/>提交時調(diào)用verifyTradeData()方法，就可以進行檢查了對頁面中輸入項的數(shù)據(jù)格式需要做檢查的項添加checkdata屬性;比如<inputcheckdata=”isdigit,minlength=9”目前已有的檢查有："isalnum"（判斷是否為字母或者數(shù)字）,"isalpha"（判斷是否僅為字母）"isdigit"（判斷是否僅為數(shù)字）"islower"(僅能輸入小寫)"isupper"（僅能輸入大寫）"isinteger"(是整數(shù)，支持負(fù)數(shù))"isdouble"（是double支持小數(shù)、負(fù)數(shù)）"isemail"（是email）"ispsptid0"（是身份證）"isphone"（是電話）"thelength"（其長度有限制，限制值在=符號后輸入,如thelength=9）"minlength"（有最小長度限制）"maxlength"（有最大長度限制）"maxvalue"（有最大值限制）"minvalue"（有最小值限制）"isipaddr"(只能輸入ip地址)上面的檢查在不矛盾的情況下可以組合使用當(dāng)參數(shù)formAutoLocked=”yes”時，會自動控制頁面中submit/image按鈕只能點擊一次，點擊后自動鎖定表單，防止重復(fù)點擊。使用ajax調(diào)用方法，比如:ajaxDirectLink/ajaxSwallow/AnyCallAjaxAny描述 強大的AjaxAny組件，可以將任何頁面元素改造成支持Ajax操作的元素。他可以為頁面元素添加一個監(jiān)聽方法，當(dāng)某個事件被響應(yīng)時執(zhí)行這個監(jiān)聽方法。參數(shù) 名稱類型方向是否必須默認(rèn)值描述elementStringinnoHTMLtagusedtoinsertthiscomponentinitsparent'stemplate.listenerorg.apache.tapestry.IActionListenerinnoajax操作時所調(diào)用的監(jiān)聽方法parametersjava.lang.Objectinno傳遞的參數(shù)statefulbooleaninnofalseBody:renderedInformalparameters:allowedReservedparameters:action 實例 <inputjwcid=”@flower:AjaxAny”type=”button”listener=”ognl:listeners.aftersn”onclick=”ajaxDirectLink(this,’’,’custName,custId’)”name=”test”/> 上面方法可以實現(xiàn)點擊界面按鈕后調(diào)用ajax操作響應(yīng)webserver端aftersn事件.執(zhí)行后刷新界面上id為custName和custId的兩個部分. 關(guān)于實現(xiàn)ajax操作還有更簡單更強大的方法，見后面HYPERLINK第五部分常用腳本介紹。

Tipster描述頁面添加本組件后，會自動給頁面中所有的有explain屬性的節(jié)點添加tip?？梢灾付╰ip的式樣，目前已有式樣若干，可以繼續(xù)增加?？梢灾付╰ip的寬度?？梢灾付撁嬷心膲K區(qū)域能夠進行tip，默認(rèn)是整個頁面都可以。參數(shù) 名稱類型方向是否必須默認(rèn)值描述typeStringinnodocTip提示的式樣，目前有docTip/staticTip/stickyTipwidthStringinno200docStringinnodocument作用范圍Body:removedInformalparameters:forbiddenReservedparameters:none實例 <spanjwcid=”@flower:Tipster”/> Form類組件LookupCombo描述 一個功能強大的下拉框?？梢燥@示多列，可以按名稱或者編碼進行匹配查找。支持鼠標(biāo)操作或者全鍵盤操作。方便定制皮膚。參數(shù) 名稱類型方向是否必須默認(rèn)值描述valuejava.lang.Objectcustomyessourcejava.lang.Objectinyes可以是IPropertySelectionModel類型，也可以是Idataset類型。如果是前者，那么titles、titleCodes，labelCode、valueCode不用輸入；否則需要輸入。titlesjava.lang.Stringinno名稱:150,編碼:80字段間逗號分割，每個字段以冒號分割成兩個部分，前半部分為標(biāo)題，后半部分為字段顯示時寬度。titleCodesjava.lang.Stringinnolabel,value標(biāo)題對應(yīng)在source中的編碼名稱labelCodejava.lang.Stringinnolabel名稱的編碼valueCodejava.lang.Stringinnovalue值得編碼promptjava.lang.Stringinno請選擇當(dāng)值為空時，界面顯示的提示信息disabledBooleanInNoFalse當(dāng)為true時，界面顯示一個輸入框boxHeightjava.lang.Stringinno180px彈出框的高度boxWidthjava.lang.Stringinno根據(jù)titles中的寬帶自動設(shè)置彈出框的寬度Body:removedInformalparameters:allowedReservedparameters:name、type、id實例 界面： <inputjwcid="jobTypeCode@flower:LookupCombo"source="ognl:getSysParam('td_s_jobtype',true)"value="ognl:custInfo.JOB_TYPE_CODE"/>

組件有式樣文件lookupcombo.css,需要手工添加至所調(diào)用的頁面中。組件提供兩個js的事件:onchanging和onrealvaluechange。頁面類組件Tree描述 強大而又使用簡單的樹組件。一個ajax方法生成的樹?？梢远ㄖ茦涞氖綐?。n多擴展功能。數(shù)據(jù)源采用IDataset，方便易用。參數(shù)名稱類型方向是否必須默認(rèn)值描述idStringinyesactionStringinyes監(jiān)聽方法名稱，在此監(jiān)聽方法中獲取樹的所有數(shù)據(jù)treeTypeStringinnoalai_tree_normal可以定制樹的式樣及特效Body:removedInformalparameters:forbiddenReservedparameters:none實例<divjwcid="@flower:Tree"id="prodType"action="choiceProductType"/> publicvoidchoiceProductType(IRequestCyclecycle)throwsException{IDatasetdsSource=ProductManager.getProductTypeTree(pd,"0000");IDatadaParam=newDataMap();daParam.put("KEY","PRODUCT_TYPE_CODE");daParam.put("TEXT","PRODUCT_TYPE_NAME");daParam.put("PARENT_KEY","PARENT_PTYPE_CODE");IDatadaEvent=newDataMap();daEvent.put("ondblclick","RecordTheNode(srcNode)");Tree.initSortedTree(cycle,dsSource,daParam,daEvent);}java:提供下面兩種方法生成樹。/***對已經(jīng)排序過的樹進行生成，該方法在頁面類中被調(diào)用*@paramcycle*@paramsource已經(jīng)排序后的數(shù)據(jù)源*@paramparamkey可以設(shè)置:"KEY","TEXT","PARENT_KEY","EXE_CATEGORY","EXE_ARG","CHECK_BOX","CHECKED","ICO"*@parameventkey可以設(shè)置:"onclick","ondblclick","onselect"......*/publicstaticvoidinitSortedTree(IRequestCyclecycle,IDatasetsource,IDataparam,IDataevent);/***先對數(shù)據(jù)源進行排序，再初始化生成樹.如果數(shù)據(jù)源已經(jīng)排序，可使用initSortedTree方法*@paramcycle*@paramsource尚未排序的數(shù)據(jù)源*@paramparamkey可以設(shè)置:"KEY","TEXT","PARENT_KEY","EXE_CATEGORY","EXE_ARG","CHECK_BOX","CHECKED","ICO","ROOT"*@parameventkey可以設(shè)置:"onclick","ondblclick","onselect"......*@paramsortFields用來排序的字段*@seecom.linkage.core.jwcs.html.tree#initSortedTree*/publicstaticvoidinitTree(IRequestCyclecycle,IDatasetsource,IDataparam,IDataevent,String[]sortFields)MiniWin描述 使用MiniWin組件可以很方便的將java端的提示、詢問、禁止等信息在前臺以浮動窗口的形式顯示給用戶，并根據(jù)用戶的點擊“確定”“取消”來執(zhí)行相關(guān)的js方法。參數(shù)名稱類型方向是否必須默認(rèn)值描述messageStringinyesXml格式的字符串，可以用WebMessager來生成這個字符串Body:removedInformalparameters:forbiddenReservedparameters:none實例html:<spanjwcid=”@flower:MiniWin”message=”ognl:messageXml”>java:publicWebMessagerwebMessager;publicStringgetMessageXml(){webMessager.getMessageXml();}voida….(){ webMessager.showScriptError("服務(wù)號碼最小長度不能低于5!","$('developStaffId').value='';return;");}

服務(wù)swallow描述 Tapestry自帶服務(wù)比如page/direct等返回的都是html模板的信息。在開發(fā)中有時需求前后臺交互一些非頁面模板類的信息，而是一個字符串或者xml格式再或者是任何一種自定義格式的信息。 那么使用swallow服務(wù)就可以很方便的解決這個問題。

常用腳本/com/linkage/f