首先 要注意的是
struts2中tag支持jsp,freeMarker ,velocity
因此,tag也有三種形式
例如:
JSP下的form標簽: <s:form action="example">
velocity的form標簽: #sform ("action=example")
freeMarker下的form標簽: <@s.form action="example">
下面以JSP使用的標簽為例:
1 <s:head>
這個標簽用在<head></head>中,
將會引入struts tag用到的一些css和js文件
需要注意的是,如果任何ui tag或者ajax tag的theme屬性值是ajax
那么<s:head>必須有theme屬性 并且它的值是ajax
這將會額外地引入與ajax相關的js文件,比如dojo.js
2 <s:form>
類似于struts 1.x 的<html:form>
validate屬性:默認是false
如果設為true 那么struts2框架會自動生成一個javascript的驗證方法,
并且根據validation.xml的配置客戶端驗證。
如果這個頁面沒有<s:head>標簽將會產生js錯誤
namespace屬性:指定這個form需要提交到哪個namespace
3 <s:submit>
theme屬性:指明theme="ajax" 會使用ajax功能,通過異步方式傳輸數據
targets屬性:指定異步方式返回的數據顯示的位置 ,
例如<div id="div1"></div>....
<s:submit theme="ajax" targets="div1" name="nn"/>
formId屬性:允許遠程提交表單,
即<s:submit>標簽的位置并不在<s:form></s:form>范圍內
indicator屬性:指定一個indicator,例如<img id="indicator" src=...
在使用異步方式的時候,會產生一個表示正在loading的小圖片
4 <s:autocompleter>自動填充器
theme屬性:如果theme值是simple,表示使用普通方式。
如果是ajax表示使用異步方式
list屬性:指定使用的數據集合。
它的值可以是action中的一個屬性,直接在標簽中指定
例如:list="{'apple','banana','grape','pear'}"
indicator屬性: 指定一個indicator,theme屬性必須是ajax,否則沒有意義
href屬性:使用的數據集合從url中獲取,
例如href="%{exampleList}"表示使用了一個<s:url>已經定義過的url:
<s:url id="exampleList">
searchType屬性:默認是startstring,也可以指定為startword或者substring,
表示自動填充的查詢方式
delay屬性:指定動作等待多少毫秒
loadMinimumCount屬性:當loadOnTextChange為true時,
loadMinimumCount表示輸入了多少個字符后,才開始重新加載數據集合,
這時theme屬性必須是ajax,否則沒有意義
5 <s:actionerror />
作用大致相當于struts 1.x中的 <html:errors/>
類似的還有<s:actionmessage />
6 <s:fielderror>
字段驗證錯誤的報錯信息
<s:fielderror>
<s:param>field1</s:param>
<s:param>field2</s:param>
</s:fielderror>
表示只顯示field1,field2的錯誤信息,
如果沒有<s:param/>表示顯示全部
錯誤信息的內容由action的.properties文件指定
7 <s:textfield/>
輸入框
label屬性:顯示一段文字,
例如<s:textfield label="find"/>會自動生成HTML代碼:find:<input type="text"/>
labelposition屬性:top/left,顯示label的位置,
可以使用top將文字顯示在輸入框的上面
默認是left
8 <s:token />
生成一個令牌 ,防止用戶重復提交表單