5. 标签和主题

1.Struts标签

• Struts2中定义一组新的标签库，使用struts的标签库和JSTL类似。
• Struts2标签需要结合OGNL表达式一起使用，注意Struts2中对EL支持不太好。
• 使用Struts标签库需要先导库：<%@ taglib prefix="s" uri="/struts-tags" %>

2. 通用标签

1. property 标签

* **`property`** 标签可以输出对象栈中对象的属性，或者 map栈中的对象，**`value属性中的值，会被OGNL解析`**

• 示例：

<!--s:debug标签可以在页面中直接显示对象栈和Map栈的信息  -->
<s:debug></s:debug>

<!--s:property可以直接获取到对象栈中对象的属性  -->
<s:property value="username"/>

<!-- property可以获取到Map栈中的对象 -->
<s:property value="#session.username"/>

<s:property value="#request.username"/>

<!-- parameters的结构map<String,String[]> 
	一般我们在使用parameters都需要加索引
-->
<s:property value="#parameters.age[0]"/>


<%	request.removeAttribute("username"); %>
<!-- attr会从由小到大的属性从域中获取到属性：page request、值栈、session、application -->
<!-- map栈中常用的对象 request session application parameters attr -->
<s:property value="#attr.username"/>

2. url 标签

* 		• url 标签用来动态地创建一个 URL（`action、includeParams、method、nameSpace、value、var`）

3. param 标签

• param 标签用来把一个参数传递给包含着它的那个标签
  * name 参数名称
  * value 参数值
• 无论在给出 value 值时有没有使用 %{}, Struts 都会对它进行 ognl 求值
• 如果想传递一个 String 类型的字符串作为参数值, 必须把它用单引号括起来.
• 可以把 value 属性的值写在开始标签和结束标签之间. 利用这种方式来传递一个 EL 表达式的值

<!-- url 标签和 param 标签 -->
<!--s:url标签用来创建一个完整的URL地址 -->
<!-- 也可以将url放入到域中，通过var属性来指定属性名，然后就可以通过EL表达式使用URL地址 -->
<s:url value="/index.jsp" var="indexURL"></s:url>
${indexURL }

<br /> <br />
<!-- action可以指定要访问的目标action的name , namespace可以用来指定action的命名空间 -->
<s:url action="user_add" namespace="/pan" var="addURL">
	<!-- value 如果是字符串 OGNL 会强制进行解析，所以可以用 '' -->
	<s:param name="username" value="'panpan'"></s:param>
	<s:param name="age" value="18"></s:param>
	<s:param name="gender" value="'male'"></s:param>
</s:url>
${addURL }

4. set 标签

• set 标签用来在以下 Map 对象里创建一个键值对:
  * ValueStack 值栈的 ContextMap 值栈
  * Map 类型的 session 对象
  * Map 类型的 application 对象
  * Map 类型的 request 对象
  * Map 类型的 page 对象

<!-- set标签用来向域中设置一个属性 -->
<!-- value属性会自动被OGNL解析，指定要放入到域中的属性值 -->
<!-- var指定要放入到域中的属性名 -->
<!-- scope指定要放入到哪个域中 page request session application -->
<!-- 默认会对value 进行OGNL 解析，所以使用 '' -->
<s:set value="'testSetTagValue'" var="setTag" scope="request"></s:set>
属性: ${request.setTag }

5. push 标签

* push 标签的功能和 set 标签类似.
* push 标签将把一个**对象压入 ValueStack 而不是压入 ContextMap.** 
* push 标签在**标签起始时把一个对象压入栈, 标签结束时将对象弹出栈**.

<%
	User user =  new User("这是使用push 标签压入栈顶的值");
	request.setAttribute("user", user);
%>
<s:push value="#request.user">
	push栈顶的值： ${username }<br>
</s:push>
出了push标签，栈顶对象就被弹出： <s:property value="#request.username"/>

6. if, else 和 elseif 标签

• 这三个标签用来进行条件测试, 它们的用途和用法类似于 if, else 和 elseif 关键字. 其中 if 和 elseif 必须有 test 属性

<!-- if elseif else  -->
<s:if test="#parameters.age[0]<14">
	<h3>你还是个小毛孩！</h3>
</s:if>
<s:elseif test="#parameters.age[0]<30">
	<h3>你是一个精壮的汉子！</h3>
</s:elseif>
<s:else>
	<h3>你已经是个老家伙了！</h3>
</s:else>

7. iterator 标签

• iterator 标签用来遍历一个集合，value属性指向的一个集合，它会被ONGL解析
• iterator 标签会将集合中的每个元素，分别放入值栈的栈顶，我们可以直接通过属性名来读取集合
• status 属性可以获取到一个遍历状态的对象
  * even 是否是一个偶数行
  * odd 是否是一个奇数行
  * index 获取当前元素的索引
  * count 获取当前元素的数量

<%
	List<City> cities = new ArrayList<City>();
	
	cities.add(new City(2,"上海"));
	cities.add(new City(3,"广州"));
	cities.add(new City(5,"东莞"));
	cities.add(new City(4,"深圳"));
	cities.add(new City(1,"北京"));

	request.setAttribute("cities", cities);
%>
<!-- s:iterator可以用来遍历一组集合 -->
<!-- iterator标签会将集合中的每个元素，分别放入值栈的栈顶 -->
<!-- status可以用来获取当前遍历的状态 -->
<s:iterator value="#request.cities" status="st">
	${st } --  ${st.even }--${st.index} --${st.count } -- ${id } - ${name } <br />
</s:iterator>

8. sort 标签

• sort 标签用来对一个可遍历对象里的元素进行排序.

public class CityComparator implements Comparator<City> {
	@Override
	public int compare(City o1, City o2) {
		return o1.getId().compareTo(o2.getId());
	}
}

<s:iterator value="#request.cities" status="st">
	${id } - ${name } <br />
</s:iterator>

<br /> <br />
<%
	CityComparator comparator = new CityComparator();
	request.setAttribute("comparator", comparator);
%>
<!-- sort标签可以用来给一个集合进行排序 -->
<!-- comparator指定排序的类，source指定被排序的集合   var指定新集合的名字 -->
<s:sort comparator="#request.comparator" source="#request.cities" var="cities_2"></s:sort>
<s:iterator value="#attr.cities_2"  status="st">
	${id } - ${name } <br />
</s:iterator>

9. date 标签

• date 标签用来对 Date 对象进行排版
  *
  * • format 属性的值必须是 java.text.SimpleDateFormat 类里定义的日期/时间格式之一.

<%
	Date date = new Date();
	session.setAttribute("date", date);
%>
s:date 标签用来对 Date 对象进行排版
<br/><br/>
<s:date name="#session.date" format="yyyy-MM-dd hh:mm:ss" var="date2"/>
<br/>
date: ${date2 }![Alt text](./1480317206572.png)

10. a 标签

	• a 标签将呈现为一个 HTML 连接. 这个标签可以接受 HTML 语言中的 a 元素所能接受的所有属性. 

<!-- a标签可以用来生成一个超链接，和HTML里a一个意思 -->
<s:a href="test">超链接1</s:a>

<br /> <br />
<s:a action="user_update" namespace="/atguigu">超链接1</s:a>

3. Form 表单标签

• 表单标签将在 HTML 文档里被呈现为一个表单元素
• 使用表单标签的优点:
  • 表单回显
  • 对页面进行布局和排版
• 标签的属性可以被赋值为一个静态的值或一个 OGNL 表达式. 如果在赋值时使用了一个 OGNL 表达式并把它用 %{} 括起来, 这个表达式将会被求值.

<!-- s:form标签用来创建一个表单，作用和html里的form类似 -->
<!-- form标签会自动为action指向的路径加上项目名，同时默认请求方式就是post，不用手动指定 -->
<!-- 表单标签，可以自动回显 , 可以自动从值栈获取到和name属性值相同的属性的值，并在表单中回显-->
<s:form action="/testForm">
	<!-- 表单隐藏域 -->
	<s:hidden name="id"></s:hidden>

	<!-- s:textfield用于创建一个表单文本框，name属性和表单项的name属性一样，label是表单项前边的提示文字 -->
	<s:textfield name="username" label="用户名"></s:textfield>
	
	<!--s:password 密码框  -->
	<s:password name="password" label="密码"></s:password>
	
	<!-- 你最喜欢的城市 -->
	<!-- 可以为单选按钮设置一个list，list指向一个List集合或Map集合 -->
	<!-- 如果是list集合，则默认使用集合的对象作为表单的value属性，和显示的文字 -->
	<!-- 如果我们希望手动指定表单的value和显示的文字
		则需要指定listKey和listValue
		listKey指定value属性
		listValue指定显示的文字
	 -->
	<s:radio name="city" list="#request.cities" label="你最喜欢的城市" listKey="id" listValue="name"></s:radio>
	
	<!-- 可以通过OGNL手动创建一个List 形式如下 {'male','female'} -->
	<!-- 可以手动创建一个Map,那么map的key将会作为标签的value属性，而map的值，将会作为标签提示文字 -->
	<s:radio label="性别" name="gender" list="#{'male':'男','female':'女'}"></s:radio>
	
	<!-- s:checkboxlist用来创建一组多选框 -->
	<s:checkboxlist label="爱好" name="hobby" list="#{'ppq':'乒乓球','lq':'篮球','ymq':'羽毛球' }"></s:checkboxlist>
	
	<!-- s:select可以用来创建一个下拉列表 -->
	<!-- headerValue可以指定默认值，headerKey指定默认值的value属性 -->
	<s:select headerKey="" headerValue="请选择..." label="你最喜欢的明星" name="star" list="#{'fbb':'范冰冰','cls':'苍老师','tw':'汤唯' }">
		<!--s:optgroup 可以对下拉框中的选项进行分组  -->
		<s:optgroup label="女明星" list="#{'fbb':'范冰冰','cls':'苍老师','tw':'汤唯' }"></s:optgroup>
		<s:optgroup label="男明星" list="#{'wyz':'吴彦祖','ldh':'刘德华','pcj':'潘长江' }"></s:optgroup>
	</s:select>
	
	<s:textarea name="desc" label="自我介绍"></s:textarea>
	
	<!-- 当只需要上传一个boolean类型的值，这个值要不是true，要不是false，这时我们就是用 s:checkbox-->
	<!-- 这个标签，当你勾选时会发送一个true作为参数，当你没勾选时会传一个false -->
	<s:checkbox name="agree" label="是否同意网站协议"></s:checkbox>
	
	<s:submit value="注册"></s:submit>

</s:form>

4. 主题

• 默认情况下, form 标签将呈现为一个 HTML form 元素和一个 table 元素.

  • 每一种输入标签都将呈现为一个带标号的输入元素, 而这个输入元素将被包含在一个 tr 元素和 td 元素的内部

• 主题

  • 主题: 为了让所有的 UI 标签能够产生同样的视觉效果而归集到一起的一组模板. 即风格相近的模板被打包为一个主题
    • simple: 把 UI 标签翻译成最简单的 HTML 对应元素, 而且会忽视行标属性
    • xhtml: xhtml 是默认的主题. 这个主题的模板通过使用一个布局表格提供了一种自动化的排版机制.
    • css_xhtml: 这个主题里的模板与 xhtml 主题里的模板很相似, 但它们将使用 css 来进行布局和排版
    • ajax: 这个主题里的模板以 xhtml 主题里德模板为基础, 但增加了一些 Ajax 功能.

• 修改主题:

  • 通过 UI 标签的 theme 属性
  • 在一个表单里, 若没有给出某个 UI 标签的 theme 属性, 它将使用这个表单的主题
  • 在 page, request, session 或 application 中添加一个 theme 属性
  • 可以在struts.xml文件通过修改常量的方式来配置，会修改整个项目的默认主题。

<constant name="struts.ui.theme" value="simple"></constant>