JSF标签使用参考手册.doc

JSF标签使用参考手册JSF标签使用参考手册V0.1文档信息标题JSF控件使用说明书创建日期2008-1-23更新日期2020-01-30文件名存放目录作者修订记录日期 描述作者版本号2008-1-23创建文档V0.1目录1前言71.1文档目的71.2文档范围71.3目标读者72控件说明82.1控件82.1.1控件描述82.1.2运行截图82.1.3示例代码82.1.4属性列表82.1.5应用案例82.1.6使用建议82.2控件82.2.1控件描述82.2.2运行截图82.2.3示例代码82.2.4属性列表92.2.5应用案例92.2.6使用建议92.3控件92.3.1控件描述92.3.2运行截图92.3.3示例代码92.3.4属性列表92.3.5应用案例102.3.6使用建议102.4控件102.4.1控件描述102.4.2运行截图102.4.3示例代码102.4.4属性列表102.4.5应用案例102.4.6使用建议102.5控件112.5.1控件描述112.5.2运行截图112.5.3示例代码112.5.4属性列表112.5.5应用案例112.5.6使用建议112.6控件112.6.1控件描述112.6.2运行截图112.6.3示例代码112.6.4属性列表112.6.5应用案例122.6.6使用建议122.7控件122.7.1控件描述122.7.2运行截图122.7.3示例代码122.7.4属性列表122.7.5应用案例122.7.6使用建议122.8控件122.8.1控件描述122.8.2运行截图122.8.3示例代码122.8.4属性列表132.8.5应用案例132.8.6使用建议132.9控件132.9.1控件描述132.9.2运行截图132.9.3示例代码132.9.4属性列表132.9.5应用案例142.9.6使用建议142.10控件142.10.1控件描述142.10.2运行截图142.10.3示例代码142.10.4属性列表142.10.5应用案例142.10.6使用建议142.11标签142.11.1控件描述142.11.2运行截图142.11.3示例代码142.11.4属性列表152.11.5应用案例152.11.6使用建议152.12标签152.12.1控件描述152.12.2运行截图152.12.3示例代码152.12.4属性列表152.12.5应用案例162.12.6使用建议162.13控件162.13.1控件描述162.13.2运行截图162.13.3示例代码162.13.4属性列表162.13.5应用案例162.13.6使用建议162.14控件162.14.1控件描述162.14.2运行截图162.14.3示例代码162.14.4属性列表172.14.5应用案例172.14.6使用建议172.15控件172.15.1控件描述172.15.2运行截图172.15.3示例代码172.15.4属性列表172.15.5应用案例182.15.6使用建议182.16控件182.16.1控件描述182.16.2运行截图182.16.3示例代码182.16.4属性列表182.16.5应用案例182.16.6使用建议182.17控件182.17.1控件描述182.17.2运行截图182.17.3示例代码182.17.4属性列表192.17.5应用案例192.17.6使用建议192.18组件192.18.1控件描述192.18.2运行截图192.18.3示例代码192.18.4属性列表192.18.5应用案例202.18.6使用建议202.19控件202.19.1控件描述202.19.2运行截图202.19.3示例代码202.19.4属性列表202.19.5应用案例202.19.6使用建议202.20控件202.20.1控件描述202.20.2运行截图202.20.3示例代码202.20.4属性列表212.20.5应用案例212.20.6使用建议212.21控件212.21.1控件描述212.21.2运行截图212.21.3示例代码212.21.4属性列表212.21.5应用案例212.21.6使用建议211 前言1.1 文档目的该文档旨在为中心界面开发工作组提供一套完整的JSF控件使用说明书。1.2 文档范围本文档列出界面开发小组在开发过程中需要使用的基本JSF控件，包括：l 控件描述l 控件使用的语法l 各控件标签及常用属性在JSP文件中的使用范例l 标签风格l 使用说明1.3 目标读者本文的主要读者为界面开发小组成员或其他对JSF感兴趣的开发人员。2 控件说明2.1 控件2.1.1 控件描述2.1.2 运行截图2.1.3 示例代码2.1.4 属性列表属性数据类型描述是否必须修改注：是否必须修改是说明此值在JSP页面中是否必须修改，视具体情况具体分析，下同。2.1.5 应用案例2.1.6 使用建议2.2 控件2.2.1 控件描述2.2.2 运行截图2.2.3 示例代码2.2.4 属性列表属性数据类型描述是否必须修改注：是否必须修改是说明此值在JSP页面中是否必须修改，视具体情况具体分析，下同。2.2.5 应用案例2.2.6 使用建议2.3 控件2.3.1 控件描述2.3.2 运行截图2.3.3 示例代码2.3.4 属性列表属性数据类型描述是否必须修改注：是否必须修改是说明此值在JSP页面中是否必须修改，视具体情况具体分析，下同。2.3.5 应用案例2.3.6 使用建议2.4 控件2.4.1 控件描述显示错误提示，当监控的内容提交时前端检查是否符合要求。2.4.2 运行截图2.4.3 示例代码输入名字：输入密码：2.4.4 属性列表属性数据类型描述是否必须修改idString此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。否forString监控目标组件是否满足要求.不满足时显示信息是styleClassString对应的样式文件的样式名称否showSummaryboolean确定是否显示消息概要的否注：是否必须修改是说明此值在JSP页面中是否必须修改，视具体情况具体分析，下同。2.4.5 应用案例2.4.6 使用建议1标签是对监控的内容提交时进行前端检查，所以使用它必须得有输入的内容，它的属性for用到的值就是输入框的id。2使用属性showSummary时要注意重复提示的问题，因为本身就是显示概要，尽量不要使用。2.5 控件2.5.1 控件描述2.5.2 运行截图2.5.3 示例代码2.5.4 属性列表属性数据类型描述是否必须修改注：是否必须修改是说明此值在JSP页面中是否必须修改，视具体情况具体分析，下同。2.5.5 应用案例2.5.6 使用建议2.6 控件2.6.1 控件描述2.6.2 运行截图2.6.3 示例代码2.6.4 属性列表属性数据类型描述是否必须修改注：是否必须修改是说明此值在JSP页面中是否必须修改，视具体情况具体分析，下同。2.6.5 应用案例2.6.6 使用建议2.7 控件2.7.1 控件描述2.7.2 运行截图2.7.3 示例代码2.7.4 属性列表属性数据类型描述是否必须修改注：是否必须修改是说明此值在JSP页面中是否必须修改，视具体情况具体分析，下同。2.7.5 应用案例2.7.6 使用建议2.8 控件2.8.1 控件描述2.8.2 运行截图2.8.3 示例代码2.8.4 属性列表属性数据类型描述是否必须修改注：是否必须修改是说明此值在JSP页面中是否必须修改，视具体情况具体分析，下同。2.8.5 应用案例2.8.6 使用建议2.9 控件2.9.1 控件描述2.9.2 运行截图2.9.3 示例代码2.9.4 属性列表属性数据类型描述是否必须修改注：是否必须修改是说明此值在JSP页面中是否必须修改，视具体情况具体分析，下同。2.9.5 应用案例2.9.6 使用建议2.10 控件2.10.1 控件描述2.10.2 运行截图2.10.3 示例代码2.10.4 属性列表属性数据类型描述是否必须修改注：是否必须修改是说明此值在JSP页面中是否必须修改，视具体情况具体分析，下同。2.10.5 应用案例2.10.6 使用建议2.11 标签2.11.1 控件描述2.11.2 运行截图2.11.3 示例代码2.11.4 属性列表属性数据类型描述是否必须修改注：是否必须修改是说明此值在JSP页面中是否必须修改，视具体情况具体分析，下同。2.11.5 应用案例2.11.6 使用建议2.12 标签2.12.1 控件描述2.12.2 运行截图2.12.3 示例代码2.12.4 属性列表属性数据类型描述是否必须修改注：是否必须修改是说明此值在JSP页面中是否必须修改，视具体情况具体分析，下同。2.12.5 应用案例2.12.6 使用建议2.13 控件 2.13.1 控件描述单选按钮，您可以使用 SelectOneRadio 来显示一个单选按钮选择集合。您可以包含一组单选选项和嵌套的选项组。2.13.2 运行截图输入页面：接收页面：2.13.3 示例代码进入错误页面，性别： 重新输入名字：重新输入密码： 2.13.4 属性列表属性数据类型描述是否必须修改idString此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。是styleClassString对应的样式文件的样式名称否dirString指明文本的显示方向，可能值为 “LTR”(left-to-right)和“RTL”（right-to-left）否accesskeyString存取传入的key否converterString将部件转向已注册的事件否renderedString指明部件是否可以提交，或是否可以处理后继状态否valueString组件的名称否styleString应用CSS类型否langString描述要显示的语言否onblurString当元素lose focus时所执行的javascript代码否onclickString当点击按钮时所执行的行为否onfocusString当元素收到focus时所执行的代码否onkeydownString在该元素上键入时所执行的代码否onkeyupString在该元素上释放键时所执行的代码否onkeypressString在该元素上释放或键入键时所执行的代码否onmousedownString在该元素上点击鼠标时所执行的代码否onmousemoveString当鼠标在该元素上移动时所执行的代码否onmouseoutString当鼠标移离元素时所执行的代码否onmouseoverString当鼠标移进元素时所执行的代码否onmouseupString当鼠标在元素上释放时所执行的代码否tabindexString该元素在文档上的制表位否onchangeString当元素失去focus或值由于得到gocus而被改变时所执行的代码否onselectString当元素上的文本被选择时所执行的代码否readonlyString指明部件是否可被修改否titleString描述部件生成的标记元素的信息否validatorString指向所绑定方法的校验器否requiredString用户是否必须提交值否valueChangeListenerString值变化监听器否disableString操作是否可进行否bindingString组件与后台bean相关联否immediateString对出发事件实时作出反应否sizeString可呈现的最大数量否disabledClassStringCSS style class to apply to the rendered label on disabled options.否enableClassStringCSS style class to apply to the rendered label on enabled options.否注：是否必须修改是说明此值在JSP页面中是否必须修改，视具体情况具体分析，下同。2.13.5 应用案例2.13.6 使用建议1 使用标签一般和标签一起用，后者一般是所选单选框的列项，这样才体现多选一的功能。2 标签确认所传的值是属性value的值。2.14 控件2.14.1 控件描述2.14.2 运行截图2.14.3 示例代码2.14.4 属性列表属性数据类型描述是否必须修改注：是否必须修改是说明此值在JSP页面中是否必须修改，视具体情况具体分析，下同。2.14.5 应用案例2.14.6 使用建议2.15 控件2.15.1 控件描述2.15.2 运行截图2.15.3 示例代码2.15.4 属性列表属性数据类型描述是否必须修改注：是否必须修改是说明此值在JSP页面中是否必须修改，视具体情况具体分析，下同。2.15.5 应用案例2.15.6 使用建议2.16 控件2.16.1 控件描述此标签是一个类似超链接的标签，点击之后弹出一个新的页面功能，它和commandButton标签有所不同。2.16.2 运行截图跳转页面：2.16.3 示例代码public String findTrueWeb() trythis.showDialog(true,true,/ch3/err.jsf,400,200);catch(IOException e)System.out.print(跳转错误);return null;这是跳转的错误页 重新输入名字：重新输入密码： 2.16.4 属性列表属性数据类型描述是否必须修改注：是否必须修改是说明此值在JSP页面中是否必须修改，视具体情况具体分析，下同。属性列表属性数据类型描述是否必须修改idString此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。是styleClassString对应的样式文件的样式名称否dirString指明文本的显示方向，可能值为 “LTR”（left-to-right）和“RTL”（right-to-left）否accesskeyString一个主键，通常与系统定义的元主键组合在一起，以关注某个元素否actionString是一个动作，提交到bean中的方法否actionListenerString当用户出发事件时，调用对应绑定的代码否charsetString超链接指定资源的编码性质否coordsString外形是长方形，圆形或多边形的元素的坐标否hreflangString超链接指定的资源的语言否renderedString指明部件是否可以提交，或是否可以处理后继状态否immediateString对出发事件实时作出反应否styleString应用CSS类型否 langString描述要显示的语言否onblurString当元素lose focus时所执行的javascript代码否targetString显示通过超链接所取得的资源否ondblclickString当在按钮上双击时所执行的代码否onfocusString当元素收到focus时所执行的代码shapeString区域外形否onfocusString当元素收到focus时所执行的代码否onkeydownString在该元素上键入时所执行的代码否onkeyupString在该元素上释放键时所执行的代码否onkeypressString在该元素上释放或键入键时所执行的代码否onmousedownString在该元素上点击鼠标时所执行的代码否onmousemoveString当鼠标在该元素上移动时所执行的代码否onmouseoutString当鼠标移离元素时所执行的代码否onmouseoverString当鼠标移进元素时所执行的代码否onmouseupString当鼠标在元素上释放时所执行的代码否revString从href指定的锚到当前文档的倒转链接否relString当前文档和href属性指定链接之间的关系否typeString按钮的类型。可能值为submit reset.否tabindexString指定标签索引的数字值否注：是否必须修改是说明此值在JSP页面中是否必须修改，视具体情况具体分析，下同。2.16.5 应用案例2.16.6 使用建议1. 属性action是标签commandLink用的最多的属性，它是一个动作，提交到bean中的方法，然后根据bean的方法找到相应的路径来实现跳转。2. 属性value也是用的较多的，它是要点击的显示的链接。2.17 控件2.17.1 控件描述2.17.2 运行截图2.17.3 示例代码2.17.4 属性列表属性数据类型描述是否必须修改注：是否必须修改是说明此值在JSP页面中是否必须修改，视具体情况具体分析，下同。属性数据类型描述是否必须修改idString此属性是组件标识符。此属性的值在当前JSP页面中要求是唯一的。是styleClassString对应的样式文件的样式名称否dirString指明文本的显示方向，可能值为 “LTR”（left-to-right）和“RTL”（right-to-left）否accesskeyString存取传入的key否converterString将部件转向已注册的事件否renderedString指明部件是否可以提交，或是否可以处理后继状态否valueString组件的名称否styleString应用CSS类型否 langString描述要显示的语言否onblurString当元素lose focus时所执行的javascript代码否onclickString当点击按钮时所执行的行为否onfocusString当元素收到focus时所执行的代码否onkeydownString在该元素上键入时所执行的代码否onkeyupString在该元素上释放键时所执行的代码否onkeypressString在该元素上释放或键入键时所执行的代码否onmousedownString在该元素上点击鼠标时所执行的代码否onmousemoveString当鼠标在该元素上移动时所执行的代码否onmouseoutString当鼠标移离元素时所执行的代码否onmouseoverString当鼠标移进元素时所执行的代码否onmouseupString当鼠标在元素上释放时所执行的代码否tabindexString该元素在文档上的制表位否onchangeString当元素失