Struts2标签库之Ajax标签---详细标签介绍 2010-08-31 20:09 DIV标签
Div标签在页面中生成一个HTML的div标签，标签的内容可以通过ajax异步请求来获取，以实现局部内容更新。Div标签属性如下：
1. handler：指定处理请求的Javascript函数名；
2. formId：指定表单的Id，表单的字段将被序列化并作为参数传递； 3. formFilter：指定用于过滤表单字段的Javascript函数名； 4. loadingText：指定当处理正在处理时显示的文本，如果异步请求发
生错误则错误信息将显示在div内容中，如果不想显示错误信息，可以将showErrorTransportText属性设置为false，如果想定制这个错误消息，可以使用errorText属性； 5. errorText：指定当请求失败时显示的文本；
6. refreshListenTopic：指定主题名，当该主题事件发布时，div内容
将重载； 7. startTimerListenTopics：指定主题名列表，当指定主题事件发布时，
启动定时器； 8. stopTimerListenTopics：指定主题名列表，当指定主题事件发布时，
停止定时器； 9. executeScripts：如果为true，则服务器返回的内容中的Javascript
代码将被执行； 10. updateFreq：指定自动更新div内容的时间间隔，以毫秒为单位，如
果autoStart属性设置为false，则此属性无效； 11. delay：指定第一个异步请求开始之前等待的时间，以毫秒为单位； 12. autoStart：指定页面加载后是否自动启动定时器。 Submit标签
Submit标签用于异步提交表单，或者使用异步请求返回的文本更新HTML表单元素，一般是div元素。如果submit标签使用在form中，则不需要指定href属性，此时这个表单将异步提交；如果是在form标签外使用submit标签，你需要使用formId指定form表单，使用href属性指定异步请求资源的地址，如果
需要过滤表单字段，可以使用formFilter属性。 Submit标签的常用属性：
1. targets：逗号分隔的HTML元素id列表，这些元素的内容将被更新； 2. handler：指定处理请求的JavaScript函数名；
3. formId：指定表单id，表单的字段将被序列化作为参数传递； 4. formFilter：指定过滤表单字段的Javascript函数名；
5. loadingText：指定请求正在处理时，targets属性指定的表单元素显
示的内容； 6. errorText：请求失败时targets属性指定的表单元素显示的文本； 7. refreshListenTopic：指定主题名，当指定的主题事件发生时，
targets属性指定的表单元素将被更新； 8. executeScripts：如果为true，请求返回内容中的JavaScript将被
执行； 9. src：为image类型的提交按钮指定图片路径，对input和button类
型的提交按钮无效； a标签
a标签与submit标签类似，可以用于异步提交表单，或者使用异步请求返回的文本更新HTML元素的内容。 常用属性：
1. targets：逗号分隔的HTML元素id列表，这些元素的内容将被更新； 2. handler：指定处理请求的JavaScript函数名；
3. formId：指定表单id，表单的字段将被序列化作为参数传递； 4. formFilter：指定过滤表单字段的Javascript函数名；
5. loadingText：指定请求正在处理时，targets属性指定的表单元素显
示的内容； 6. errorText：请求失败时targets属性指定的表单元素显示的文本；
7. refreshListenTopic：指定主题名，当指定的主题事件发生时，
targets属性指定的表单元素将被更新； 8. executeScripts：如果为true，请求返回内容中的JavaScript将被
执行； tabbedPanel标签
tabbedPanel标签生成一个包含标签页(tab)的Panel，Panel上的标签页可以是静态的，也可以是动态的。每个标签页都是一个ajax主题的div标签，并且作为标签页使用的div标签只能在tabbedPanel标签中使用，并使用label属性指定标签页的标题。
需要注意的是tabbedPanel标签是在simple主题中，不要将tabbedPanel标签的theme属性设置为ajax，但每一个标签页的div都应该是ajax主题的。 TabbedPanel标签常用的属性：
1. closeButton：指定关闭按钮放置的位置，可选的值是”tab”
和”pane”，但有什么区别暂时没搞懂；这个属性已经不推荐使用了； 2. selectedTab：指定默认选中的标签页的id，默认为第一个标签页；这个属性也已经不推荐使用； 3. doLayout：布尔型，默认为false，指定tabbedPanel标签是否为固
定高度，如果为false，则tabbedPanel标签页的高度为选中的标签页的高度，否则需要指定标签页的高度； 4. labelposition：指定标签页放置的位置，可选的值有top、right、
botton和left，默认为top。 autocompleter标签
autocompleter标签输出一个组合框，由文本输入框和下拉列表框组成，它在页面加载的时候通过异步请求来加载它的选项，并可以基于用户在输入框中输入的内容来给出建议的选项。如果通过action来响应autocompleter的异步请求，那么action的响应必须是格式正确的JSON串，格式为：[[“text1”,”value1”], [“text2”, “value2”]?]。
在表单中使用autocompleter标签的话，在表单提交时会产生两个请求参数：一个是name属性名参数，其值是下拉列表中显示的内容；另一个是
“${name}Key”，其值是下拉列表中的选项值。如果在action中两个参数都需要接收的话，就应该为两个参数分别定义属性名。
autocompleter常用的属性：
1. autoComplete：设置是否自动完成文本框中的输入内容，默认值为
false； 2. forceValidOption：指定文本框中的输入内容是否必须匹配下拉列表
的选项，如果不匹配的话，文本框中的内容将会在失去焦点时被清空。默认值为false； 3. delay：指定开始搜索下拉框中的内容之前延迟的时间，心ms为单位； 4. searchType：指定输入文本和下拉列表选项的匹配方式，可选的值有：
startstring、startword和substring。默认值为startstring； 5. dropdownHeight：设置下拉框的高度，以像素为单位，默认值为120； 6. dropdownWidth：设置下拉框的宽度，以像素为单位，默认与文本框
的宽度一样； 7. formId：指定表单的id，表单的字段将被序列化作为参数传递； 8. formFilter：指定用于过滤表单字段的JavaScript函数名； 9. value：当主题是simple时，设置标签的默认值。当标签的主题为
simple时，则失去了ajax功能，但提示和自动完成功能还是有的； 10. list：指定用于生成下拉列表框中的选项的集合，可以是List或Map； 11. loadOnTextChange：指定当用户在文本中输入文本时，是否重新加载
下拉列表框中的选项； 12. loadMinimCount：指定用户在文本框中输入多少个字符后，才会开始
重新加载下拉框的选项。默认值为3。使用该属性时需要将loadOnTextChange设置为true； 13. showDownArrow：是否显示下拉箭头，默认为true。 tree和treenode标签
tree标签输出一个树形组件，treenode标签在树形组件里绘制树节点。这两个标签都有一个label属性，tree标签的label属性指定树的标题，treenode标签的label属性指定节点的标题。
使用tree和treenode标签构建动态树的时候，如下几个属性是必须的：
1. rootNode：作为顶层树节点的对象，该属性的值可以是一个OGNL表
达式；
2. nodeIdProperty：指定节点id的对象； 3. nodeTitleProperty：指定节点title的对象；
4. childCollectionProperty：指定根节点对象中的一个集合属性，该
集合包含了作为子节点的对象。