struts2基础——标签
一、通用标签
1.s:property （读取值栈中对象的属性值）
属性：value:指定OGNL表达式；default:OGNL表达式返回为 null 时，使用默认值；escape：是否对 HTML 特殊字符进行转义
e1:读取对象栈中对象的属性值
<s:property value="[1].userName"/>
e2:访问Map栈，读取Session域中对象的属性值
<s:property value="#session.sessionKey"/>
e3:访问Map栈，通过attr读取域对象中的属性值
<s:property value="#attr.requestAttrKey"/>
e4:若不指定 value 值，则返回栈顶对象
2.s:url（创建一个 url 地址字符串）
属性：value:创建 url 地址字符串；action:带有 ContextPath 和 .action 后缀
e1:通过value属性创建URL地址字符串
<s:url value="url"/> <!-- url--> <s:url value="/url"/> <!-- /struts2/url 带有 ContextPath-->
e2:通过action属性创建URL地址字符串
<s:url action="actionUrl"/> <!-- /struts2/actionUrl.action 不需要再次指定 / -->
e3:通过action属性和namespace属性以及method属性创建URL地址字符串
<s:url action="acitonUrl" namespace="test" method="dynamicMethod"/> <!-- test/acitonUrl!dynamicMethod.action -->
e4:创建带请求参数的URL地址字符串
<s:url value="/urlParam"> <s:param name="userId" value="'zsmj'"/> </s:url> <!-- /struts2/urlParam?userId=zsmj --> <!-- 1.s:param 标签：给父标签传递参数 2.value：若不加单引号，则从值栈中查找，若值栈中找不到则不添加该参数；加单引号按字符串输出 -->
e5:创建包含GET方式传递过来的请求参数的URL地址字符串
<s:url value="/urlParam" includeParams="get" />
e6:创建不包含contextPath的URL地址字符串
<s:url value="/urlParam4" includeContext="false"/>
3.s:set（将键值对存入域对象）
属性：var:存入域对象中的 name 值；value:存入域对象中的 value 值； scope:域对象的范围；其他两个属性都是过时的
e1:将attrName01="attrValue01"存入Session域
<s:set var="attrName01" value="'attrValue01'" scope="session"/> <s:property value="#session.attrName01" />
e2:默认存入 request 域中
e3:value 可以为 OGNL 表达式，值为对应值栈中的值
<s:set value="#attr.attrName01" var="attrName03"/> <s:property value="#attr.attrName03"/>
4.s:push（将一个对象临时压入栈顶，标签结束后弹出）
属性：value:要压入栈顶的对象，可以为 OGNL 表达式 对应的值栈中的值
<s:push value="'pushObj'"> <s:property/> <!-- pushObj --> </s:push> <s:property/> <!-- com.nucsoft.struts2.helloworld.TestTagAction@7202555 -->
5.s:if、s:elseif、s:else
属性：test: 布尔值
e1:传入以age为键的请求参数，根据age的不同值测试不同分支条件
<s:if test="#parameters.age[0]>18">大于18岁了</s:if> <s:elseif test="#parameters.age[0]<18">小于18岁</s:elseif> <s:else>等于18岁了</s:else>
6.s:iterator（遍历数组、Collection集合、Map集合，将遍历得到的每一个结果放入栈顶，本次循环结束时弹出）
属性：value:要遍历的内容；var:将遍历得到的值以字符串的形式放入请求域，如果不指定则放入栈顶；status:IteratorStatus类型，会放入到请求域中；begin:遍历开始索引位置；end:遍历结束索引位置，包含；step:步长，指定负数则倒序遍历。
e1:遍历集合
<s:iterator value="#attr.list"> <s:property/> </s:iterator>
e2:遍历Map
<s:iterator value="#attr.map"> <s:property value="key"/> <s:property value="value"/> </s:iterator>
7.s:sort（对数组、Collection集合或Map集合中的元素进行排序）
属性：
source:要比较的集合对象
var:将排序好的集合对象放入pageScope，若不指定，则存入值栈栈顶
comparator：比较器对象
8.s:date（格式化日期）
属性：
name:指定一个 OGNL 表达式，用于读取要格式化的日期对象
format:日期格式字符串，如"dd/MM/yyyy"
var:若有值，则以此值为key，存放到域对象中，若没指定，则输出。
9.s:a（创建一个超链接）
属性：
href:将指定字符串原封不动的作为超链接的 href 值，不支持EL 表达式，如要从值栈中获取数据，可以使用强制 OGNL 解析，%{OGNL表达式}%
value:不加 /，和 href 一样，加 / ，自动加入 ContextPath
二、表单标签
1.总览
|
Struts2标签名 |
对应的HTML元素 |
|
s:form |
form |
|
s:textfield |
input type=”text” |
|
s:password |
input type=”password” |
|
s:hidden |
input type=”hidden” |
|
s:submit |
input type=”submit” |
|
s:textarea |
textarea |
|
s:radio |
input type=”radio” |
|
s:select |
select/option |
|
s:optiongroup |
optiongroup/option |
|
s:checkboxlist |
input type=”checkbox” |
|
s:checkbox |
单一的input type=”checkbox” |
2.表单标签的通用属性
|
属性名 |
类型 |
作用 |
|
label |
String |
指定一个表单元素在XHTML和Ajax主题下的行标，在simple主题下无效 |
|
name |
String |
指定一个表单元素的name属性值，一个输入元素的name属性将被自动映射（或注入）到一个Action类中由setXxx()方法定义的属性 |
|
value |
String |
指定一个表单元素的value属性值 |
|
cssClass |
String |
指定一个表单元素的class属性值 |
|
cssStyle |
String |
指定一个表单元素的style属性值 |
|
title |
String |
指定一个表单元素的title属性值 |
|
disabled |
String |
指定一个表单元素的disabled属性值 |
|
labelPosition |
String |
指定一个表单元素在XHTML和Ajax主题下的行标位置，可选值[top|left] |
|
key |
String |
这个输入字段所代表的属性的名字，name和label属性的快捷方式 |
|
required |
boolean |
在XHTML主题中，指定该属性是否加* |
|
requiredPosition |
String |
指定一个表单元素的*的位置，可选值[left|right] |
|
tabIndex |
String |
指定HTML标签的tabindex属性 |
3.s:form 标签
|
属性名 |
类型 |
默认值 |
作用 |
|
action |
String |
当前action |
当前表单提交的目标Action |
|
enctype |
String |
—— |
表单的enctype属性 |
|
method |
String |
POST |
表单提交的请求方式 |
|
namespace |
String |
当前namespace |
目标Action所从属的命名空间 |
|
acceptcharset |
String |
—— |
当前表单所接受的字符集，多个字符集用逗号或空格隔开 |
|
onsubmit |
String |
—— |
用于绑定onsubmit事件的句柄 |
|
openTemplate |
String |
—— |
用来打开这个表单的模板 |
|
portletMode |
String |
—— |
在用户提交这个表单后将显示的portlet模式 |
|
target |
String |
—— |
表单的target的属性 |
|
validate |
boolean |
false |
在XHTML/Ajax主题下是否进行客户端输入验证 |
|
windowState |
String |
—— |
用户提交表单后将显示的窗口状态 |
4.s:textfield标签（生成一个单行文本框）
|
属性名 |
类型 |
默认值 |
作用 |
|
maxlength |
int |
—— |
生成文本框后最多能容纳多少个字符 |
|
readonly |
boolean |
false |
生成的文本框是否为只读 |
|
size |
int |
—— |
生成的文本框的宽度 |
|
key |
可以同时代替 name 和 label 属性 |
5.s:password标签（生成一个密码框）
说明：扩展自 s:textfield ，多了一个 showPassword 属性，为 布尔型，决定要不要显示输入的密码
6.s:hidden 标签（用于生成一个表单隐藏域）
7.s:submit标签（用于生成表单提交按钮）
|
属性名 |
类型 |
默认值 |
作用 |
|
align |
String |
right |
XHTML/Ajax主题下控制提交按钮的对齐方向 |
|
type |
String |
input |
XHTML/Ajax主题下控制提交按钮的显示方式，可选值[input|button|image] |
|
src |
String |
—— |
当type=image时，使用src属性指定图片路径 |
8.s:textarea标签（用于生成多行文本域）
|
属性名 |
类型 |
默认值 |
作用 |
|
cols |
int |
—— |
textarea标签的cols属性 |
|
rows |
int |
—— |
textarea标签的rows属性 |
|
readonly |
boolean |
false |
指定当前元素是否为只读 |
9.有选择功能的标签的通用属性
list属性：指定用于生成多选框的list集合
listKey属性：指定生成的多选框的value属性
listValue属性：指定每一个多选框旁边的说明文字
name属性：指定生成的多选框的name属性
如果list属性读取的是一个Map，则可以由Map的键生成多选框的value属性，Map的值生成多选框旁边显示的文字，所以此时不需要指定listKey和listValue属性。
10.s:radio标签（生成一组单选按钮）
<s:radio list="#{'male':'男','female':'女'}" name="gender" label="性别"></s:radio>
11.s:select标签（生成下拉列表）
|
属性名 |
类型 |
默认值 |
作用 |
|
emptyOption |
boolean |
false |
指定是否在标题下面插入一个空白选项 |
|
headerKey |
String |
—— |
选项列表中第一个选项的键 |
|
headerValue |
String |
—— |
选项列表中第一个选项的值 |
|
multiple |
boolean |
false |
指定是否多选 |
|
size |
int |
—— |
同时显示在页面里的选项个数 |
10.s:optiongroup标签（示选项的分组，每个分组有自己数据的来源）
<s:optgroup label="opt01" list="#{'aa':'AA','bb':'BB' }"></s:optgroup> <s:optgroup label="opt02" list="#{'aa':'AA','bb':'BB' }"></s:optgroup>
11. s:checkboxlist标签（生成一组多选框）
<s:checkboxlist list="#request.cities" listKey="cityId" listValue="cityName" name="love" label="喜爱的城市"> </s:checkboxlist>
12.s:checkbox标签（在页面上提供一个勾选框，用于提交一个布尔值，典型的应用是“是否同意”）
<s:checkbox name="married" label="婚否"></s:checkbox> <input type="checkbox" name="married" value="true" id="userAction_married"/> <input type="hidden" id="__checkbox_userAction_married" name="__checkbox_married" value="true" /> <label for="userAction_married" class="checkboxLabel">婚否</label>
