trswcm6.5及以上二次開發(fā)-008屬性面板

1、修訂序號(hào)變更日期變更動(dòng)作變更內(nèi)容詳情描述版本1.2010-04-25DEV2新建新建本文檔1.02.2011-01-12修改1 添加了修改頁，以后本文檔有修改時(shí)請(qǐng)?zhí)顚懶薷男畔ⅰ?. 列表頁面屬性面板1.1. 概述WCM65 的列表頁面右側(cè)通常會(huì)有三塊面板，其中第三塊面板中的信息是當(dāng)前選中的一些屬性信息，因此也稱其為屬性面板，在屬于面板上，能快速方便的查閱和修改當(dāng)前對(duì)象的一些基本信息，提高了系統(tǒng)的使用效率。關(guān)于屬性面板的數(shù)據(jù)來源在文檔 TRSWCM65 二次開發(fā)-操作面板中已經(jīng)詳細(xì)敘述了，常用的屬性面板數(shù)據(jù)來源的處理方式有兩種，一種是以發(fā)送服務(wù)的方式來獲取數(shù)據(jù)，一般會(huì)convertor 到一個(gè)_

2、findbyid.jsp 頁面。另一種是面板的時(shí)候?qū)⒖刂茢?shù)據(jù)來源的 url 參以下描述的幾個(gè)場(chǎng)景。下面數(shù)直接指向一個(gè) jsp 頁面。無論是那個(gè)方式，都會(huì)遇到就實(shí)際需求中常見的幾種使用場(chǎng)景來一一操作。1.2. 實(shí)戰(zhàn)示例修改的文件：對(duì)于 WCM 現(xiàn)有的普通對(duì)象，一般是修改下面描述的文件，app_ findbyid.js， 其中對(duì)象名稱見TRSWCM6.5- 目錄結(jié)構(gòu).doc ， 比如文檔為，那么就是app_ findbyid.jsp。但也有一些是例外的，如工作列表，短消息，模板變量，這些都是通過 js 畫出來的，見TRSWCM6.5 二次開發(fā)-操作面板實(shí)戰(zhàn)的場(chǎng)景 3，而上面的這 2 中情況都是有操

3、作面板里面的 js 代碼決定的，在相應(yīng)對(duì)象的操作面板的 js 中（ 見TRSWCM6.5 二次開發(fā)- 操作面板文件說明）， 搜索wcm.PageOper.registanels，找到單個(gè)對(duì)象的，代碼中加粗的部分，決定了詳細(xì)信息面板的代碼文件所在，如 template 的為：那么模板的詳細(xì)信息面板的文件就是 template_ findbyid.jsp模板變量的為：templateArg : title : String.format(wcm.LANGOPER_TITLE_OBJ, sName), displayNum : 7,detail : function(cmsobjs, opt) va

4、r obj = cmsobjs.ge(0);return getEditInfo(obj);template : title : String.format(wcm.LANGOPER_TITLE_OBJ, sName), displayNum : 7,url : ?serviceid=wcm61_template&methodname=jFindbyid,那么模板變量的詳細(xì)信息面板就是通過 js 畫出來的，詳見TRSWCM6.5 二次開發(fā)-操作面板的描述。場(chǎng)景一 可編輯的輸入框類型在的屬性面板中，有些屬性是可以直接在輸入框中進(jìn)行修改的，例如文檔列表中文檔標(biāo)題。下圖是某篇文檔的屬性面板，其中文檔

5、標(biāo)題“我來新建下”在樣式上是深藍(lán)色，點(diǎn)擊一下會(huì)呈現(xiàn)為一個(gè)輸入框，在輸入框中輸入新的標(biāo)題后，當(dāng)此輸入框失去焦點(diǎn)的時(shí)候，會(huì)自動(dòng)將新的標(biāo)題信息提交保存起來。以上可輸入修改的這種效果怎么實(shí)現(xiàn)呢？修改方法：在對(duì)應(yīng)的 jsp 頁面中添加如下的代碼參數(shù)說明和示例代碼如下：/*約定的布局+樣式的方式*DIV 中套 span。，其中 div 的樣式 attribute_row 是固定的，添加上這樣的樣式，底層會(huì)認(rèn)為該元素是對(duì)象的一個(gè)屬性元素。如果是一些主要屬性，可以在 Div 中上添加樣式 main_attr，屬性內(nèi)容就會(huì)呈現(xiàn)深藍(lán)色。*當(dāng) Span 的樣式是 wcm_attr_value 的時(shí)候，底層會(huì)認(rèn)為這是

6、一個(gè)顯示屬性值的元素*當(dāng) DIV 的樣式中包含樣式 editable 時(shí)，底層會(huì)認(rèn)為此屬性值是可以修改的，點(diǎn)擊此屬性值元素的時(shí)候，會(huì)將其變?yōu)榭删庉嫷臓顟B(tài)，同時(shí)修改完后，當(dāng)此輸入框失去焦點(diǎn)的時(shí)候，自動(dòng)將新的內(nèi)容保存*屬性值對(duì)應(yīng)的 dom 元素 span 中可以指定哪些屬性呢？必須指定哪些屬性呢？*必須指定的屬性:_fieldName：字段名屬性決定了保存的時(shí)候，是保存到數(shù)據(jù)庫中的那個(gè)字段。,場(chǎng)景二 只允許查看的類型有些屬性在屬性面板只是顯示值，但不需要修改，例如下圖中文檔的屬性面板中的創(chuàng)建用戶、創(chuàng)建時(shí)間、所屬欄目。_fieldValue:字段值屬性的使用是這樣的，保存的時(shí)候，如果當(dāng)前元素是 in

7、put類型的，則取其 value，如果不是，則取屬性_fieldValue 的值，當(dāng)然底層框架會(huì)屬性_fieldValue 的值，保證該值為設(shè)置值。*額外可以添加的屬性：Validation：對(duì)該屬性值的校驗(yàn)的控制?？梢詫?duì)其類型，長(zhǎng)度等進(jìn)行校驗(yàn)。_serviceId 和_methodName:之前 講到在輸入框失去焦點(diǎn)的時(shí)候，系統(tǒng)會(huì)自動(dòng)保存，對(duì)于這個(gè)保存，在這詳細(xì)介紹下， 是采用發(fā)送服務(wù)的方式進(jìn)行保存的，當(dāng) span元素中不指定_serviceId 和_methodName 的時(shí)候，默認(rèn)發(fā)送到的服務(wù)名是在_list.js 中指定的 PageContext.serviceId，方法名為 save

8、，如果有特殊的需求，可以在 span 中用這兩個(gè)屬性指定服務(wù)名和方法名。*/String sEditable = bCanEdit?editable:readonly;div class=attribute_row doctitle main_attr首頁標(biāo)題:span class=wcm_attr_value _fieldName=DOCTITLE_fieldValue= validation=max_len:200,type:string,desc:首頁標(biāo)題 validation_desc=首頁標(biāo)題 _serviceId=wcm61_methodName=&;修改方法： 在 對(duì) 應(yīng) 的 j

9、sp 頁面 （ 例如_findbyid.jsp, 例 如 文 檔 列 表 的 是 在app_ findbyid.jsp。）中添加如下的代碼。參數(shù)說明和示例代碼如下：場(chǎng)景三 下拉選擇框可修改類型修改方法：在對(duì)應(yīng)的 jsp 頁面中添加如下的代碼參數(shù)說明和示例代碼如下/*約定的布局+樣式的方式*DIV 中套 span。，其中 div 的樣式 attribute_row 是固定的，添加上這樣的樣式，底層會(huì)認(rèn)為該元素是對(duì)象的一個(gè)屬性元素。*當(dāng) DIV 的樣式中包含樣式 readonly 時(shí)，底層會(huì)認(rèn)為此屬性值是不可以修改的。*div 中的樣式 descinfo 表示這是描述信息，控制信息的顯示位置以及字

10、體效果。*當(dāng) Span 的樣式是 wcm_attr_value 的時(shí)候，底層會(huì)認(rèn)為這是一個(gè)顯示屬性值的元素在 span 元素上添加 select 樣式，用來控制其顯示效果。*必須指定的屬性:_fieldName：字段名屬性決定了保存的時(shí)候，是保存到數(shù)據(jù)庫中的那個(gè)字段。_fieldValue:字段值屬性的使用是這樣的，保存的時(shí)候，如果當(dāng)前元素是 input類型的，則取其 value，如果不是，則取屬性_fieldValue 的值，當(dāng)然底層框架會(huì)屬性_fieldValue 的值，保證該值為設(shè)置值。_selec：只有指定了該屬性，底層框架才能識(shí)別這是一個(gè)下拉選擇框。該值必須為已經(jīng)定義好了一個(gè)的 se

11、lect 元素的 name/*約定的布局+樣式的方式*DIV 中套 span。，其中 div 的樣式 attribute_row 是固定的，添加上這樣的樣式，底層會(huì)認(rèn)為該元素是對(duì)象的一個(gè)屬性元素。*當(dāng) DIV 的樣式中包含樣式 readonly 時(shí)，底層會(huì)認(rèn)為此屬性值是不可以修改的。*div 中的樣式 descinfo 表示這是描述信息，控制信息的顯示位置以及字體效果。*當(dāng) Span 的樣式是 wcm_attr_value 的時(shí)候，底層會(huì)認(rèn)為這是一個(gè)顯示屬性值的元素里層 span 中的樣式 value 的作用是控制內(nèi)容顯示為灰色，但是只有在該 span 元素是樣式 descinfo 所在元素的

12、子元素才能起到效果。*/span title=文檔:&;創(chuàng)建者:創(chuàng)建時(shí)間：RecID:&;用戶創(chuàng)建于場(chǎng)景四 在多個(gè)屬性之間分割線修改方法：在對(duì)應(yīng)的 jsp 頁面中添加如下的代碼，代碼示例如下：/該 div 添加的樣式必須為 attrbute_row_sep*額外可以添加的屬性：Validation：對(duì)該屬性值的校驗(yàn)的控制?？梢詫?duì)其類型，長(zhǎng)度等進(jìn)行校驗(yàn)。_serviceId 和_methodName:之前 講到在輸入框失去焦點(diǎn)的時(shí)候，系統(tǒng)會(huì)自動(dòng)保存，對(duì)于這個(gè)保存，在這詳細(xì)介紹下， 是采用發(fā)送服務(wù)的方式進(jìn)行保存的，當(dāng) span元素中不指定_serviceId 和_methodName 的時(shí)候，默認(rèn)發(fā)送到的服務(wù)名是在_list.js 中指定的 PageCo