标准的 JSF“链接操作”组件属性窗口
另请参见
在使用可视设计器编辑的某个页面上,选择 JavaServer Faces 链接操作组件的外部,或者在“导航”窗口中选择此组合组件的链接操作
部分时,将显示该组件的“属性”窗口。
- 链接操作组件包括嵌入在链接操作组件
中的输出文本组件
。在可视设计器中选择此组件时,它还会显示在“导航”窗口中,您可以在该窗口中选择要使用的组件部分。
此标准 JavaServer Faces 组件具有以下属性。
常规
- id。
类型:文本
页面 Bean 和 JSP 文件中链接操作组件的名称。
- target。
类型:字符串
要从中打开链接的当前页面的框架。
外观
- style。
类型:字符串
要应用到组件中的层叠样式表规则(CSS 级别 2)。此属性将覆盖项目 CSS 文件中的所有设置。例如:
position: absolute; left: 288px; top: 312px
您既可以直接输入值,也可以单击省略号 (...) 按钮以使用样式编辑器。
有关 CSS2 样式属性的列表,请参见以下 Web 页:
- styleClass。
类型:字符串
输入呈现组件时应用的以空格分隔的 CSS2 样式类列表。这些样式类必须在项目的样式表中进行定义。单击省略号按钮 (...),将会看到一个列表,其中包含可添加到此属性中的所有样式。有关将 CSS 类和规则添加到项目的层叠样式表的信息,请参见 CSS 编辑器。
- title。
类型:字符串
可以由屏幕阅读器读取并可以作为工具提示显示的有关链接操作的信息。
- 如果禁用该组件,则在大多数浏览器中将不显示工具提示。
事件
要设置事件属性,请在可视设计器中右键单击组件,然后选择“编辑事件处理程序”> "<事件名称>"。
- action。指示用户单击链接操作时调用的链接操作方法的名称。如果输入的方法名称(例如
CommandHyperlink1_action)在页面 Bean 中不存在,则 IDE 会将其添加到页面 Bean 中,并更新“应用程序操作”属性的值以指向该方法。
如果您只是希望在用户单击链接操作时显示另外一个页面,则不需要使用操作方法。最简单的操作是在导航编辑器中打开该页面,然后单击该页面并单击链接操作,最后拖到您希望链接操作打开的页面。有关详细信息,请参见设置静态页面导航。
如果希望链接操作能够根据某些条件确定要打开的页面,则需要使用操作方法。操作方法通常用于处理链接操作的单击操作,并返回指示一个页面(应用程序下一个显示的页面)导航条件名称的字符串。要定义此方法,通常可以在可视设计器中选择组件,在“导航”窗口中右键单击该组件的链接操作部分,然后选择“编辑事件处理程序”> "action"。该方法的缺省名称为 CommandHyperlink-id_action,其中 CommandHyperlink-id 是链接操作的 id 属性的值。有关详细信息,请参见设置动态页面导航。
JavaScript
- onblur。
类型:字符串
组件失去焦点时执行的 JavaScript。
- onclick。
类型:字符串
用户单击组件时执行的 JavaScript。
- ondblclick。
类型:字符串
用户双击组件时执行的 JavaScript。
- onfocus。
类型:字符串
组件获得焦点时执行的 JavaScript。
- onkeydown。
类型:字符串
组件具有焦点并按下某个键时执行的 JavaScript。
- onkeypress。
类型:字符串
组件具有焦点并按下及释放某个键时执行的 JavaScript。
- onkeyup。
类型:字符串
组件具有焦点并释放某个键时执行的 JavaScript。
- onmousedown。
类型:字符串
在鼠标光标位于组件上方且用户按下鼠标按钮时执行的 JavaScript。
- onmousemove。
类型:字符串
用户在组件中移动鼠标光标时执行的 JavaScript。
- onmouseout。
类型:字符串
在鼠标光标位于组件上方后用户将其从组件移开时执行的 JavaScript。
- onmouseover。
类型:字符串
用户将鼠标光标移动到组件上方时执行的 JavaScript。
- onmouseup。
类型:字符串
鼠标光标位于组件上方且用户释放鼠标按钮时执行的 JavaScript。
高级
- accesskey。
类型:字符串
激活此链接操作的键盘按键或快捷键。可以输入任何可在键盘上键入的有效字符。相当于 HTML <input> 标记的 accesskey 属性。
- action。
类型:方法绑定
请参见上述“事件”部分的 Action 属性,您应在该位置设置此值。如果设置了“事件”类别的 Action 属性或在可视设计器中右键单击“链接操作”并选择“编辑事件处理程序”> "action",则会设置此属性。如果使用导航编辑器将此页面上的链接操作链接到另一个页面,则也可以为您设置此属性。
- actionListener。
类型:方法绑定
用于表示操作侦听程序方法的方法绑定,该侦听程序方法会在用户激活此组件时收到通知。该值必须是一个有效的 JSF 方法绑定表达式(如 #{Page1.action_method}),并且其计算结果必须为公共方法的名称,该方法使用 ActionEvent 参数并且其返回类型为 void。例如,如果要调用不在页面 Bean 中的方法,则可以将方法绑定表达式直接键入此 actionListener 属性中。
- charset。
类型:字符串
此超级链接所链接到的文档或资源的字符编码。相当于 HTML <a> 标记的 charset 属性。可以在以下网址查看编码列表:
。
- coords。
类型:字符串
页面上热点的位置和形状,用于客户端图像映射。相当于 HTML <a> 标记的 coords 属性。值的数目和顺序取决于所定义的形状。可能的组合是:
- rect。左 x、上 y、右 x、下 y。
- 圆形。圆心 x、圆心 y、半径。
- poly。x1、y1、x2、y2、...、xN、yN。第一个 x 和 y 坐标对应该与最后一个坐标对相同,以闭合多边形。
坐标对应于对象的左上角。所有的值均为长度,并以逗号分隔。
- dir。
类型:字符串
文本未继承方向(例如,文本为英语,但页面原来的语言为希伯莱语)时的方向指示符。相当于 HTML <input> 标记的 dir 属性。
值可以为:
- hreflang。
类型:字符串
说明超级链接所链接到的文档或资源所用语言的代码。此属性的值与语言代码的值相同,如下面所述。
- immediate。
类型:布尔型
如果选定此属性,当用户激活链接操作时,将先执行页面 Bean 中的代码,然后再执行验证、更新模型值等操作。实际上,代码在服务器中立即执行,然后返回该页面。
immediate 操作的最常见示例是“取消”按钮。可以将其设置为 immediate 以跳过常规验证和更新步骤,但操作处理程序仍可以执行所需的操作。通常,操作处理程序将导航至先前的某个页面。在某些设计中,操作处理程序可能还会将信息消息放在队列中,例如“事务已取消”。还可以执行其他操作,例如,应用程序可能记录以下情况:用户填写了表单的一部分,并随后取消了该操作。
- lang。
类型:字符串
描述为组件生成的标记中所用语言的代码。相当于 HTML <input> 标记的 lang 属性。要选择语言代码,可以单击省略号按钮 (...) 打开属性编辑器。例如:
ar - 传统阿拉伯语
de - 德语en - 英语
es - 西班牙语
fr - 法语
ja - 日语
除了属性编辑器中可用的代码,还可以使用 ISO 标准名称输入其他代码。例如:
en-US - 美国英语
ja-JP - 日语
zh-guoyu - 普通话或标准汉语
zh-Hans - 简体中文脚本
zh-HanT - 繁体中文脚本
- rel。
类型:字符串
指定与所链接文档的关系。与 HTML rel 属性相同:是一个空格分隔的类型列表。可以是以下任一类型:
- 替代。出现链接的文档的替代版本。与 lang 属性一起使用时,它表示替代版本是文档的转换版本。
- 附录。文档集合中的附录。
- 书签。指向文档入口点的链接。
- 章。文档集合中的章。
- 目录。目录。
- 版权。当前文档的版权。
- 词汇表。当前文档的术语词汇表。
- 帮助。帮助文档。
- 索引。当前文档的索引。
- 下一个。文档序列中的下一个文档。
- 上一个。文档序列中的上一个文档。
- 节。文档集合中的节。
- 起点。文档集合中的第一个文档:集合的起点。
- 样式表。表示外部样式表。与链接类型“替代”一起使用,以便为用户提供可以选择的替代样式表。
- 子节。文档集合中的子节。
- rendered。
类型:布尔型
如果选定该属性,将在任何后续页提交中呈现和处理链接操作。如果未选定该属性,链接操作将不出现在页面中,甚至不作为隐藏组件出现。可以将此属性绑定到用于确定何时呈现该链接操作的变量。例如,机票预订表单可能只为经常乘坐飞机的人显示链接操作,而不为一般大众显示它。要绑定此属性,请在可视设计器中右键单击组件并选择“属性绑定”,然后选择“全部”单选按钮来显示所有属性,以便绑定呈现的属性。
- rev。
类型:字符串
指向文档中超级链接链接回此文档的反转类型链接。相当于 HTML 属性 rev,是一个空格分隔的类型列表。有关类型列表,请参见上述“关系”属性。
- shape。
类型:字符串
页面上热点的形状,用于客户端图像映射。相当于 HTML <a> 标记的 shape 属性。可能的值是:
- default。整个区域
- rectangle。矩形区域。
- circle。圆形区域。
- polygon。多边形区域。
- tabindex。
类型:字符串
(可选)按文档的 Tab 键顺序指定链接操作的位置,从而确定当用户使用 Tab 键在文档中移动时链接操作成为焦点的时间。该值必须为 0 至 32767 之间的整数。相当于 HTML <input> 标记的 tabindex 属性。
- type。
类型:字符串
此超级链接所链接到的资源的内容类型。相当于 HTML 属性 type,它是 MIME 类型,如 text/html、image/png、image/gif、video/mpeg、text/css 或 audio/basic。
- 另请参见
- 标准链接操作组件
- 使用组件
- 组件任务:快速参考
法律声明