使用Struts Dojo插件.docx
- 文档编号:3644109
- 上传时间:2022-11-24
- 格式:DOCX
- 页数:42
- 大小:444.55KB
使用Struts Dojo插件.docx
《使用Struts Dojo插件.docx》由会员分享,可在线阅读,更多相关《使用Struts Dojo插件.docx(42页珍藏版)》请在冰豆网上搜索。
使用StrutsDojo插件
使用StrutsDojo插件
要想使用这个插件里的标签,你必须按照以下步骤进行。
(1)把下面这条taglib指令添加到JSP页面的顶部:
<%@taglibprefix="sx"uri="/struts-dojo-tags"%>
(2)把StrutsDojo插件复制到你的WEB-INF/lib子目录里。
这个插件已被收录在本书的lib子目录里。
(3)在每个页面的顶部写出head标签。
现在,让我们一起去看看StrutsDojo插件里的标签。
27.4 head标签
head标签将被呈现为用来下载Dojo文件和配置Dojo本身的JavaScript代码。
使用了其他Dojo标签的每一个JSP页面都必须包含这个标签。
表27-1列出了head标签的属性。
表27-1 head标签的属性
名字
数据类型
默 认 值
说明
baseRelativePath
String
/struts/dojo
Dojo插件的安装路径
cache
boolean
true
是否让浏览器缓存Dojo文件
compressed
boolean
true
是否使用Dojo文件的压缩版本
debug
boolean
false
是否使用Dojo的调试模式
extraLocales
String
Dojo使用的其他地理时区的清单,
以逗号作为分隔符
locale
String
覆盖Dojo的默认地理时区设置
parseContent
boolean
false
在寻找组件(widget)时是否
分析整个文档
compressed属性(默认值是true)用来表明是否使用Dojo文件的压缩版本。
使用压缩版本可以节省加载时间,但生成的代码比较难以阅读。
如果是在开发模式下,建议大家把这个属性设置为false,这样比较便于你阅读本章讨论的标签所呈现出来的代码。
在开发模式下,你还应该把debug属性设置为true,把cache属性设置为false。
把debug属性设置为true将使得Dojo把警告消息和出错消息显示在页面的底部。
综上所述,你在开发模式下使用的head标签应该是下面这样:
headdebug="true"cache="flase"compressed="false"/> 在正式发布的应用程序里,head标签应该是下面这样: head/> 27.5 div标签 这个标签将被呈现为一个可以动态地加载Web内容的HTMLdiv元素。 用这个标签呈现出来的div元素还有一个内部计时器,其用途是让div元素每隔一段给定的时间就重新加载一次它的内容。 使用div标签无需编程就可以实现一个滚动广告区。 这个标签的属性列在表27-2里。 表27-2 div标签的属性 名字 数据类型 默 认 值 说明 afterNotifyTopics String 将在请求之后(如果请求成功的话) 发表的话题清单;话题之间使用逗 号作为分隔符 autoStart boolean true 是否自动启用计时器 beforeNotifyTopics String 将在请求之前发表的话题清单, 话题之间使用逗号作为分隔符 closable boolean false 当把div标签放在一个选项卡式的 面板元素里时,是否显示一个Close按钮 delay integer 在获取动态Web内容之前等待的毫秒数 errorNotifyTopics String 将在请求之后(如果请求失败的话) 发表的话题清单,话题之间使用逗号 作为分隔符 errorText String 在请求失败时显示的出错消息的文本 executeScripts boolean false 是否执行动态Web内容里的JavaScript代码 formFilter String 用来过滤表单字段的函数 formId String 其字段将被传递为请求参数的 表单的标识符 handler String 用来对请求进行处理的JavaScript函数 highlightColor String 用来对targets属性所指定元素 进行突出显示的颜色 highlightDuration integer 2000 对targets属性所指定元素进行 突出显示的持续时间(以毫秒为单位)。 这个属性只在highlightColor属性 有一个值时才起作用 href String 用来获取动态Web内容的URL indicator String 服务器正在对请求进行处理时 显示的元素的标识符 javascriptTooltip boolean false 是否使用JavaScript来生成浮动提示框 listenTopics String 将触发远程调用的话题 loadingText String Loading... 正在加载Web内容时显示的提示消息的文本 notifyTopics String 在请求之前和之后以及在发生错 误时将发表的话题的清单,话题 之间使用逗号作为分隔符 openTemplate String 用来打开被呈现HTML文件的模板 parseContent boolean true 是否分析返回的动态Web内容以寻找组件 preload boolean true 是否在加载页面的同时加载动态Web内容 refreshOnShow boolean false 是否要在div元素变得可见时加 载动态Web内容。 这个属性只 在div标签在一个tabbedpanel 元素里时才起作用 separateScripts boolean true 是否要为每个标签单独创建一个 范围来运行脚本代码 showErrorTransportText boolean true 是否显示出错消息 (续) 名字 数据类型 默 认 值 说明 showLoadingText boolean false 是否在加载动态Web内容时在 目标区域显示“正在加载”消息 startTimerListenTopics String 将启动计时器工作的话题 stopTimerListenTopics String 将停止计时器工作的话题 transport String XMLHttpTra- nsport 用来传递相关请求的传输对象 updateFreq integer 动态内容的刷新频率 (以毫秒为单位) div标签还继承了本书第5章列出的所有标签都有的共同属性。 我们为这个标签准备了3个例子。 27.5.1 示例程序1 代码清单27-1里的Div1.jsp页面使用了一个div标签来每隔3秒自动刷新一次。 href属性指定返回动态Web内容的服务器位置,updateFreq属性指定以毫秒为单位的刷新频率。 因为autoStart属性的默认值是true,所以内部计时器将自动启动。 代码清单27-1 Div1.jsp页面 这个标签有一个很有意思的功能,它能以指定颜色突出显示被呈现出来的div元素,然后逐渐消退。 你可以使用它的highlightColor属性来指定突出显示的颜色。 27.5.3 示例程序3 代码清单27-3给出的Div3.jsp页面演示了如何使用div标签来发表一个话题。 代码清单27-3 Div3.jsp页面 这个div标签的内部计时器被设置成每隔两秒关闭一次,在每次关闭其内部计时器时,这个标签将发表一个updateCounter话题,而这个话题又被赋值给了它的afterNotifyTopics属性。 我们还使用了Dojo插件的subscribe方法来订阅这个话题,让某个特定的函数在这个div标签每次发表这个话题时运行。 与updateCounter话题相关联的那个函数将增加一个计数器并改变第二个div标签的内容。 27.6 a标签 a标签将被呈现为一个HTML页面链接,点击这个链接将发出一个Ajax请求。 这个标签的target属性用来指定一个元素(通常是一个div元素)来显示相关的Ajax响应。 如果嵌套在某个表单的内部,这个标签将在用户点击该链接时提交该表单。 表27-3列出了a标签的属性。 表27-3 a标签的属性 名字 数据类型 默 认 值 说明 afterNotifyTopics String 将在请求之后(如果请求成功的话)发表的话题清单,话题之间使用逗号作为分隔符 ajaxAfterValidation boolean false 如果验证成功,是否发出一个异步请求。 这个属性只在validation属性被设置为true时才起作用 beforeNotifyTopics String 将在请求之前发表的话题清单,话题之间使用逗号作为分隔符 errorNotifyTopics String 将在请求之后(如果请求失败的话)发表的话题清单,话题之间使用逗号作为分隔符 errorText String 在请求失败时显示的出错消息的文本 executeScripts boolean false 是否执行动态Web内容里的JavaScript代码 formFilter String 用来过滤表单字段的函数 formId String 其字段将被传递为请求参数的表单的标识符 handler String 用来对请求进行处理的JavaScript函数 highlightColor String 用来对targes属性所指定的元素进行突出显示的颜色 (续) 名字 数据类型 默 认 值 说明 highlightDuration integer 2000 对targets属性所指定的元素进行突出显示的持续时间(以毫秒为单位)。 这个属性只在highlightColor属性有一个值时才起作用 href String 用来提取动态Web内容的URL indicator String 服务器正在对请求进行处理时显示的元素的标识符 javascriptTooltip boolean false 是否使用JavaScript来生成浮动提示框 listenTopics String 将触发远程调用的话题 loadingText String Loading... 正在加载Web内容时显示的提示消息的文本 notifyTopics String 在请求之前和之后以及在发生错误时将发表的话题的清单,话题之间使用逗号作为分隔符 openTemplate String 用来打开被呈现的HTML文件的模板 parseContent boolean true 是否分析返回的动态Web内容以寻找部件 separateScripts boolean true 是否要为每个标签单独创建一个范围来运行脚本代码 showErrorTransportText boolean true 是否显示出错消息 showLoadingText boolean false 是否在加载动态Web内容时在目标区域显示“正在加载”消息 targets String 其内容将被刷新的元素清单;元素之间使用逗号作为分隔符 transport String XMLHttpTransport 用来传递相关请求的传输对象 validate boolean false 是否进行Ajax验证 a标签还继承了本书第5章列出的所有标签都有的共同属性。 例如,代码清单27-4里的A.jsp页面使用了一个a标签来填充div元素div1和div2。 代码清单27-4 A.jsp页面 27.7 submit标签 submit标签将呈现为一个能够以异步方式提交一个表单的提交按钮。 这个标签有3种呈现类型可供选择,程序员只需把相应的值赋给它的type属性即可。 这3种渲染类型如下所示。 input: 把submit标签渲染为 button: 把submit标签渲染为 image: 把submit标签渲染为 类似于a标签,submit标签也有一个target属性,其用途是给出将用来显示表单处理结果的元素。 submit标签的属性如表27-4所示。 此外,submit标签还继承了本书第5章列出的所有标签都有的共同属性。 表27-4 submit标签的属性 名字 数据类型 默 认 值 说明 afterNotifyTopics String 将在请求之后(如果请求成功的话)发表的话题清单,话题之间使用逗号作为分隔符 ajaxAfterValidation boolean false 如果验证成功,是否发出一个异步请求。 这个属性只在validation属性被设置为true时才起作用 beforeNotifyTopics String 将在请求之前发表的话题清单,话题之间使用逗号作为分隔符 errorNotifyTopics String 将在请求之后(如果请求失败的话)发表的话题清单,话题之间使用逗号作为分隔符 errorText String 在请求失败时显示的出错消息的文本 executeScripts boolean false 是否执行动态Web内容里的JavaScript代码 formFilter String 用来过滤表单字段的函数 formId String 其字段将被传递为请求参数的表单的标识符 handler String 用来对请求进行处理的JavaScript函数 highlightColor String 用来对targets属性所指定元素进行突出显示的颜色 highlightDuration integer 2000 对targets属性所指定元素进行突出显示的持续时间(以毫秒为单位)。 这个属性只在highlightColor属性有一个值时才起作用 href String 用来提取动态Web内容的URL indicator String 服务器正在对请求进行处理时显示的元素的标识符 javascriptTooltip boolean false 是否使用JavaScript来生成浮动提示框 listenTopics String 将触发远程调用的话题 loadingText String Loading... 正在加载Web内容时显示的提示消息的文本 method String 对应着HTMLsubmit元素的method属性 notifyTopics String 在请求之前和之后以及在发生错误时将发表的话题的清单,话题之间使用逗号作为分隔符 parseContent boolean true 是否分析返回的动态Web内容以寻找部件 separateScripts boolean true 是否要为每个标签单独创建一个范围来运行脚本代码 (续) 名字 数据类型 默 认 值 说明 showErrorTransportText boolean true 是否显示出错消息 showLoadingText boolean false 是否在加载动态Web内容时在目标区域显示“正在加载”消息 src String image类型的提交按钮的图片来源 targets String 其内容将被刷新的元素清单,元素之间使用逗号作为分隔符 transport String XMLHttp Transport 用来传递相关请求的传输对象 type String input 提交按钮的类型,可取值是input、image和botton validate boolean false 是否进行Ajax验证 submit标签既可以嵌套在它将提交的表单内部,也可以放在该表单的外部。 下面这个submit标签嵌套在一个表单的内部: 而下面这个submit标签出现在它将提交的表单的外部。 此时,程序员需要使用formId属性来指定将被它提交的那个表单。 27.8 bind标签 bind标签用来把一个事件和一个事件处理程序关联起来,或是把一个对象的事件和一个话题关联起来,而这意味着我们可以让任何一个元素(哪怕它是一个非Ajax组件)发表一个话题。 可以出现在bind标签内部的属性列在表27-5里。 表27-5 bind标签的属性 名字 数据类型 默 认 值 说明 afterNotifyTopics String 将在请求之后(如果请求成功的话)发表的话题清单,话题之间使用逗号作为分隔符 ajaxAfterValidation boolean false 如果验证成功,是否发出一个异步请求。 这个属性只在validation属性被设置为true时才起作用 beforeNotifyTopics String 将在请求之前发表的话题清单,话题之间使用逗号作为分隔符 errorNotifyTopics String 将在请求之后(如果请求失败的话)发表的话题清单,话题之间使用逗号作为分隔符 errorText String 在请求失败时显示的出错消息的文本 (续) 名字 数据类型 默 认 值 说明 events String 将被关联的事件清单,事件之间使用逗号作为分隔符 executeScripts boolean false 是否执行动态Web内容里的JavaScript代码 formFilter String 用来过滤表单字段的函数 formId String 其字段将被传递为请求参数的表单的标识符 handler String 用来对请求进行处理的JavaScript函数 highlightColor String 用来对targets属性所指定的元素进行突出显示的颜色 highlightDuration integer 2000 对targets属性所指定的元素进行突出显示的持续时间(以毫秒为单位)。 这个属性只在highlightColor属性有一个值时才起作用 href String 用来提取动态Web内容的URL indicator String 服务器正在对请求进行处理时显示的元素的标识符 listenTopics String 将触发远程调用的话题 loadingText String Loading... 正在加载Web内容时显示的提示消息的文本 notifyTopics String 在请求之前和之后以及在发生错误时将发表的话题的清单,话题之间使用逗号作为分隔符 separateScripts boolean true 是否要为每个标签单独创建一个范围来运行脚本代码 showErrorTransport- Text boolean true 是否显示出错消息 showLoadingText boolean false 是否在加载动态Web内容时在目标区域显示“正在加载”消息 sources String 将被关联的元素的标识符,标识符之间使用逗号作为分隔符 targets String 其内容将被刷新的元素清单,元素之间使用逗号作为分隔符 transport String XMLHttp Transport 用来传递相关请求的传输对象 validate boolean false 是否进行Ajax验证 bind标签还继承了本书第5章列出的所有标签都有的共同属性。 例如,如下所示的bind标签将把b1提交按钮的onclick事件与一个名为MyAction.action的Ajax调用操作和一个名为div1的div元素的刷新操作关联起来。 下面这个bind标签将导致b2按钮的onclick事件发表一个myTopics话题。 27.9 datetimepicker标签 datetimepicker标签将被呈现为一个日历表或一个时间表。 用这个标签呈现出来的日历表(左)和时间表(右)如图27-1所示。 (点击查看大图)图27-1 日历表和时间表 datetimepicker标签的属性如表27-6所示。 表27-6 datetimepicker标签的属性 名字 数据类型 默 认 值 说明 adjustWeeks boolean false 是否调整每个月份里的行数。 如果这个属性的值是false,每个月份都将固定显示为6个星期 dayWidth String narrow 用来确定标题里的日期名称;可取值是narrow、abbr和wide displayFormat String 用来给出UnicodeTechnicalStandart#35技术标准所定义的日期/时间格式之一 displayWeeks integer 6 将显示的星期的个数 endDate Date 2941-10-12 这个标签所能显示的最晚日期 formatLength String short 显示日期/时间值时使用的格式类型,可取值是short、medium、long和full javascriptTooltip boolean false 是否使用JavaScript来生成浮动提示框 language String 将使用的语言,默认值是浏览器的默认语言 startDate Date 1492-10-12 这个标签所能显示的最早日期 staticDisplay boolean false 是否只能查看和选择当前月份里的日期 toggleDuration integer 100 以毫秒为单位的切换持续时间 toggleType String plain 下拉清单的切换类型,可取值有plain、wipe、explode和fade type String date 这个标签将呈现为日历表还是时间表,可取值是date和time valueNotifyTopics String 将在用户选中一个日期/时间值时被发表的话题清单,话题之间使用逗号作为分隔符 weekStartsOn integer 0 一个星期的第一天。 0代表星期日,6代表星期六 datetimepicker标签还继承了本书第5章列出的所有标签都有的共同属性。 d
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 使用Struts Dojo插件 使用 Struts Dojo 插件
![提示](https://static.bdocx.com/images/bang_tan.gif)