一、表單標(biāo)簽的通用屬性
對于表單標(biāo)簽,分為兩種標(biāo)簽:form標(biāo)簽本身,和所有來包裝單個的表單元素的其他標(biāo)簽.form標(biāo)簽本身的行為不同于它內(nèi)部的元素,這是很重要的.在我們?yōu)樗斜韱螛?biāo)簽,包括form標(biāo)簽在內(nèi),提供一個參考手冊之前,我們必須先描述一些通用的屬性.
通用屬性
| 屬性 |
Theme |
數(shù)據(jù)類型 |
描述 |
| cssClass |
simple |
String |
定義 html class 屬性 |
| cssStyle |
simple |
String |
定義html style 屬性 |
| title |
simple |
String |
定義html title 屬性 |
| disabled |
simple |
String |
定義html disabled 屬性 |
| label |
xhtml |
String |
定義表單元素的label |
| labelPosition |
xhtml |
String |
定義表單元素的label位置(top/left),缺省為left |
| requiredposition |
xhtml |
String |
定義required 標(biāo)識相對label元素的位置 (left/right),缺省是 right |
| name |
simple |
String |
表單元素的name映射 |
| required |
xhtml |
Boolean |
在label中添加 * (true增加,否則不增加) |
| tabIndex |
simple |
String |
定義html tabindex 屬性 |
| value |
simple |
Object |
定義表單元素的value |
模板相關(guān)屬性
| 屬性 |
Theme |
數(shù)據(jù)類型 |
描述 |
| templateDir |
n/a |
String |
定義模板目錄 |
| theme |
n/a |
String |
定義theme名稱 |
| template |
n/a |
String |
定義模板名稱 |
Javascript相關(guān)屬性
| 屬性 |
Theme |
數(shù)據(jù)類型 |
描述 |
| onclick |
simple |
String |
html javascript onclick 屬性 |
| ondbclick |
simple |
String |
html javascript ondbclick 屬性 |
| onmousedown |
simple |
String |
html javascript onmousedown 屬性 |
| onmouseup |
simple |
String |
html javascript onmouseup 屬性 |
| onmouseover |
simple |
String |
html javascript onmouseover 屬性 |
| onmouseout |
simple |
String |
html javascript onmouseout 屬性 |
| onfocus |
simple |
String |
html javascript onfocus 屬性 |
| onblur |
simple |
String |
html javascript onblur 屬性 |
| onkeypress |
simple |
String |
html javascript onkeypress 屬性 |
| onkeyup |
simple |
String |
html javascript onkeyup 屬性 |
| onkeydown |
simple |
String |
html javascript onkeydown 屬性 |
| onselect |
simple |
String |
html javascript onselect 屬性 |
| onchange |
simple |
String |
html javascript onchange 屬性 |
Tooltip 相關(guān)屬性
| 屬性 |
數(shù)據(jù)類型 |
缺省值 |
描述 |
| tooltip |
String |
none |
設(shè)置此組件的tooltip |
| tooltipIcon |
String |
/webwork/static/tooltip/tooltip.gif |
tooltip圖標(biāo)的url |
| tooltipAboveMousePointer |
Boolean |
false |
在鼠標(biāo)光標(biāo)位置上放置tooltip.另外設(shè)置 tooltipOffseY 允許你設(shè)置從鼠標(biāo)光標(biāo)位置的垂直位移. |
| tooltipBgColor |
String |
#e6ecff |
tooltip的背景色. |
| tooltipBgImg |
String |
none |
背景圖片. |
| tooltipBorderWidth |
String |
1 |
tooltip邊框的寬度. |
| tooltipBorderColor |
String |
#003399 |
tooltip邊框的背景色 |
| tooltipDelay |
String |
500 |
顯示Tooltip的時間延遲(毫秒). 類似基于操作系統(tǒng)的tooltip的行為. |
| tooltipFixCoordinateX |
String |
not specified |
固定tooltip在指定的X坐標(biāo)上.例如和tooltipSticky屬性結(jié)合時很有用. |
| tooltipFixCoordinateY |
String |
not specified |
固定tooltip在指定的Y坐標(biāo)上.例如和tooltipSticky屬性結(jié)合時很有用. |
| tooltipFontColor |
String |
#000066 |
字體顏色. |
| tooltipFontFace |
String |
arial,helvetica,sans-serif |
字體,例如 verdana,geneva,sans-serif |
| tooltipFontSize |
String |
11px |
字體大小,例如 30px |
| tooltipFontWeight |
String |
normal |
Font weight. 可以是 normal 或者 bold |
| tooltipLeftOfMousePointer |
Boolean |
false |
在鼠標(biāo)光標(biāo)位置左側(cè)的Tooltip位置 |
| tooltipOffsetX |
String |
12 |
相對鼠標(biāo)光標(biāo)位置的水平位移. |
| tooltipOffsetY |
String |
15 |
相對鼠標(biāo)光標(biāo)位置的垂直位移. |
| tooltipOpacity |
String |
100 |
tooltip的透明度. 不透明度是行對透明度而言的.設(shè)置的值必須是一個介于0(完全透明)和100(不透明)之間的數(shù)字.Opera尚未支持. |
| tooltipPadding |
String |
3 |
內(nèi)部間隔,例如,邊框和內(nèi)容之間的空格,例如文字或者圖片 |
| tooltipShadowColor |
String |
#cccccc |
使用指定的顏色創(chuàng)建陰影. |
| tooltipShadowWidth |
String |
5 |
使用指定的寬度(距離)創(chuàng)建陰影. |
| tooltipStatic |
Boolean |
false |
就像基于操作系統(tǒng)的tooltip, tooltip不隨著鼠標(biāo)光標(biāo)移動而移動. |
| tooltipSticky |
Boolean |
false |
tooltip一直停留在它初始的位置,直到另外一個tooltip被激活,或者用戶點擊了文檔. |
| tooltipStayAppearTime |
String |
0 |
指定一個tooltip消失的時間間隔(毫秒),即時鼠標(biāo)還在相關(guān)的HTML元素上不懂,設(shè)置<=0,就和沒有定義一樣. |
| tooltipTextAlign |
String |
left |
調(diào)整包括標(biāo)題和tooltip內(nèi)容的文字位置.可以是right, left 或 justify |
| tooltipTitle |
String |
none |
標(biāo)題 |
| tooltipTitleColor |
String |
#ffffff |
title文字的顏色 |
| tooltipWidth |
String |
300 |
tooltip的寬度 |
二、表單標(biāo)簽
1、checkbox（復(fù)選框）
struts2的checkbox標(biāo)簽在使用的時候需要注意它的兩個屬性。value和fieldValue，在其他的標(biāo)簽中value是真實值。而在checkbox中，value如果為true，就表示復(fù)選框被選中；如果為false就表示不被選中。fieldValue才是此復(fù)選框?qū)?yīng)的真實的值。
<s:checkbox name="xingming" value="false" fieldValue="aaaaa" label="value=false" />
<s:checkbox name="xingming" value="true" fieldValue="aaaaa" label="value=true"/>
結(jié)果：
|
|
2、checkboxlist（復(fù)選框組）
<s:checkboxlist name="a" label="請選擇您喜歡的圖書" labelposition="top"
list="{'struts2.0','hibernate','spring'}"/>
<!--用Map對象生成多個復(fù)選框-->
<s:checkboxlist name="b" label="請選擇您喜歡的圖書" labelposition="top"
list="#{'struts2.0':'2006/10','hibernate':'2007/8','spring':'2008/9'}"
listKey="key" listValue="value"/>
| |
|
3、combobox（組合框）
combobox標(biāo)簽生成一個單行文本框和下拉列表框的組合，但值對應(yīng)一個請求參數(shù)。
<s:combobox label="請選擇您喜歡的圖書" theme="css_xhtml" labelposition="top"
list="{'struts2.0','hibernate','spring'}" size="20" maxlength="20" name="book"/>
結(jié)果：
4、select（下拉菜單）
<s:select label="請選擇您喜歡的書籍"
labelposition="top" name="books"
list="{'struts2.0','hibernate','spring','ajax'}"
multiple="true" size="2" required="true"/>
<s:select list="#{'struts':'aaaa','hibernate':'bbbb','spring':'cccc','ajax':'dddd'}"
listKey="key" listValue="value" label="選擇你喜歡的作者" labelposition="top"
name="b" />
結(jié)果：
5、doubleselect
doubleselect標(biāo)簽會生成一個級聯(lián)列表框，當(dāng)選擇第一個下拉列表，第二個下拉框的內(nèi)容也會隨之改變。
<s:set name="bs"
value="#{'數(shù)據(jù)標(biāo)簽':{'action','bean','date','set'},
'控制標(biāo)簽':{'iterator','append','subset'},'表單標(biāo)簽':{'select','checkbox','radio'}}"/>
<s:form action="x">
<s:doubleselect label="請選擇您喜歡的圖書" labelposition="top" size="3"
name="author" list="#bs.keySet()" multiple="false"
doubleName="book" doubleList="#bs[top]" doubleMultiple="false"
doubleSize="3"/>
</s:form>
結(jié)果：
6、optiontransferselect
<s:optiontransferselect
doubleList="{'javaScript','ajax','sql'}"
list="{'struts2.0','hibernate','spring'}"
name="cnbook" doubleName="enbook"
addAllToLeftLabel="全部向左移" addAllToRightLabel="全部向右移"
addToLeftLabel="向左移" addToRightLabel="向右移"
allowAddAllToLeft="true" allowAddAllToRight="true"
allowAddToLeft="true" allowAddToRight="true"
allowUpDownOnLeft="true"allowUpDownOnRight="true"
multiple="true" doubleMultiple="true"
emptyOption="true" doubleEmptyOption="true"
headerKey="cnKey" doubleHeaderKey="enKey"
headerValue="--選擇中文圖書--" doubleHeaderValue="--choose English book--"
allowSelectAll="true" selectAllLabel="全部選中"
leftTitle="中文圖書" rightTitle="Einglish books"
leftDownLabel="下移" rightDownLabel="下移"
leftUpLabel="上移" rightUpLabel="上移"
label="圖書管理"
>
</s:optiontransferselect>
結(jié)果：
|
7、radio
<s:radio name="a" label="選擇您喜愛的圖書" labelposition="top"
list="'struts','hibernate','spring'"/>
<s:radio name="b" label="選擇您喜愛的圖書" labelposition="top"
list="#{'struts':'111','hibernate':'222','spring':'333'}"
listKey="key" listValue="value"/>
<s:bean name="com.zzn.books.BookService" id="bs"/>
<s:radio name="c" label="選擇您喜愛的圖書" labelposition="top"
list="#bs.books" listKey="name" listValue="author"/>
結(jié)果：
8、optgroup
optgroup標(biāo)簽用于生成一個下拉列表框的選項組，因此，該標(biāo)簽必須放在<s:select.../>標(biāo)簽中使用。
<s:select name="book" label="選擇你喜歡的作者" labelposition="top"
list="#{'struts':'aaaa','hibernate':'bbbb','spring':'cccc','ajax':'dddd'}"
listKey="key" listValue="value" >
<s:optgroup label="Rod Johnson"
list="#{'aaaaaaaa':'bbbbbbbb'}"
listKey="key" listValue="value"/>
<s:optgroup label="David Flanagan"
list="#{'javaScript:The Definitive Guide':'David'}"
listKey="key" listValue="value"/>
</s:select>
結(jié)果：
|
|
9、token
這是一個防止多次提交表單的標(biāo)簽，能避免刷新頁面時多次提交，如果要該標(biāo)簽起作用，應(yīng)該在struts.xml中用TokenInterceptor攔截器或TokenSessionStoreInerceptor攔截器。
<s:tolen/>
10、head
該標(biāo)簽主要用于生成HTML主要頁面的HEAD部分。如果需要頁面中有用Ajax組件，使用一個帶theme=”ajax“屬性的head標(biāo)簽，就可以將標(biāo)準(zhǔn)Ajax的頭信息包含在頁面中。
<s:head theme="ajax"/>
11、updownselect
<s:updownselect name="a" label="請選擇您喜歡的圖書" labelposition="top"
moveUpLabel="向上移動"
list="{'struts2.0','hibernate','spring'}"/>
<s:updownselect name="b" label="請選擇您喜歡的圖書" labelposition="top"
moveDownLabel="向下移動" selectAllLabel="全部選擇"
list="#{'struts2.0':'2006/10','hibernate':'2007/8','spring':'2008/9'}"
listKey="key" listValue="value" emptyOption="true"/>
結(jié)果：
12、actionerror和actionmessage
actionerror和actionmessage這兩個標(biāo)簽用法完全一樣，都是負(fù)責(zé)輸出Action實例里封裝的信息，區(qū)別是actionerror標(biāo)簽負(fù)責(zé)輸出Action市里的getActionError()方法的返回值，而actionmessage標(biāo)簽負(fù)責(zé)輸出Action實例的getActionMessage()的返回值。
13、tree和treenode初步
注意：用這個標(biāo)簽加上<s:head theme="ajax"/>
<s:tree label="計算機(jī)圖書" id="book" theme="ajax"
showRootGrid="true" showGrid="true" treeSelectedTopic="treeSelected">
<s:treenode label="張孝祥" id="zxx" theme="ajax">
<s:treenode label="java教程" id="java" theme="ajax"/>
<s:treenode label="javascript寶典" id="javascript" theme="ajax"/>
<s:treenode label="j2ee詳解" id="j2ee" theme="ajax"/>
</s:treenode>
<s:treenode label="李剛" id="lg" theme="ajax" >
<s:treenode label="struts2.0" id="struts" theme="ajax"/>
<s:treenode label="spring" id="spring" theme="ajax"/>
<s:treenode label="hibernate" id="hibernate" theme="ajax"/>
</s:treenode>
<s:treenode label="David" id="d" theme="ajax" >
<s:treenode label="ajax" id="ajax" theme="ajax"/>
</s:treenode>
</s:tree>
13、datetimepicker（日歷控件）
<s:datetimepicker name="order.date" label="購買日期" toggleType="explode" value="today"/>
結(jié)果：