链接

创建与具有指定标签文本的指定 URL 的标准超链接。将此按钮拖至页面上时,将调用一个窗口,而您将在该窗口中输入链接的 URL 和可选标签。选择此组件可添加超链接和相关联的输出文本,即,添加一个可编辑的单独组件。

设计时的组件

限制: 要从 HTML 文件链接到 Faces JSP 文件,请在 HTML 页面中将所引用的文件名由 <filename>.jsp 更改为 <filename>.faces。请不要将实际的 Faces JSP 文件扩展名重命名。如果在 HTML 文件中在将引用的链接更改为 .faces 扩展名,则链接构建器将无法工作。

链接组件拖放到页面上:

“链接”组件按钮

将会提示您输入链接的 URL 和标签:

“链接”组件“配置 URL”窗口

链接组件在页面上看起来如下所示:

设计时的“链接”

运行时的组件

在运行时,链接组件在页面上看起来如下所示:

运行时的“链接”

属性视图和全部属性视图

组件的“属性”视图显示可以对组件设置的最常见属性集,并且根据组件的不同,您还可以看到用于添加控件、操作或其他组件的选项。要打开“属性”视图,请单击窗口 > 显示视图 > 属性

“链接”组件的这些常见属性显示在“属性”视图中的 hx:outputLinkEx参数辅助功能选项卡上。要获取完整的属性列表,请参阅全部链接属性表。用于传递参数的其他配置选项位于 hx:outputLinkEx> 参数选项卡上:
表 1. 链接配置选项

配置选项

描述

添加传递给操作的参数

指定组件要将哪些参数传递给操作。

“全部属性”视图显示可以对组件设置的全部属性的表,包含可以从“属性”视图访问的那些属性。要切换至“全部属性”视图,请单击“属性”视图右上角的全部属性图标 “全部属性”图标

表 2. 全部链接属性

属性名称

在“属性”视图中表示为

描述

accesskey

辅助功能 > 访问键

将单个键盘键指定为访问键。在运行时按指定的访问键可以使此组件具有焦点。在运行时按 ALT + 指定的访问键可以使此组件具有焦点,如果组件是一种按钮,则执行此组件。

binding

未表示

该表达式将组件的实例(通常为用户界面组件)与 Bean 属性(通常在备份文件中)绑定。

charset

未表示

超链接所指定的资源的字符编码。

coords

未表示

屏幕上热点的位置和形状,在客户端图像映射中使用。

converter

未表示

指定值所转换至的数据类型。JavaServer Faces 实现提供了一组“转换器”实现,可以使用它们来将组件数据转换为其处理器不支持的类型。

dir

未表示

指定当在运行时呈示时组件的方向。值可以是:
  • ltr - 从左到右
  • rtl - 从右到左
如果未指定方向,则使用适合于对组件进行编码的方向。

hreflang

未表示

此超链接指定的资源的语言代码。

id

标识

对组件指定一个名称。它在 JSP 内应该是唯一名称。

lang

未表示

组件的值和文本内容所用的语言。如果语言被忽略,则它会从包含标记(特别是视图)继承。指定为符合 ISO 标准的语言缩写代码。例如,“en”表示英语,“en-US”表示美国英语,“fr”表示法语,而“de”表示徳语。
注: 此选项不是“翻译”组件中的文本,而是标识组件的语言以便搜索、排序、整理以及类似操作能够正确完成。

mimeType

未表示

用于在将 src 与二进制数据绑定时声明媒体 MIME 类型。

rel

未表示

从当前文档至此超链接指定的锚点的关系。此属性的值是以空格分隔的链接类型列表。

rendered

未表示

可设置为 true 或 false:
  • false - 将不会在运行时向浏览器呈示组件。
  • true - 将呈示组件。这是缺省值。

rev

未表示

从此超链接指定的锚点至当前文档的反向链接。此属性的值是以空格分隔的链接类型列表。

shape

未表示

设置链接的形状:
  • rect
  • circle
  • poly

styleClass

样式:类

当呈示此元素时要应用的以空格分隔的 CSS 样式类列表。此值必须作为生成标记上的类属性来传递。定义所选组件的类,例如,样式表。这可以通过手工完成,也可以通过单击按钮并从窗口中选择期望的类来完成。

样式

样式:属性

指定组件的 CSS 样式信息,例如,style="font-size : 8pt ; color : red"。定义所选组件的属性,例如,字体和颜色。这可以通过手工完成,也可以通过单击按钮并从窗口中选择期望的属性来完成。

target

未表示

指定当单击超链接时应将页面装入至的框架集中的目标框架:
  • 新窗口
  • 同一框架
  • 父框架
  • 全屏

tabindex

辅助功能 > 跳进顺序索引

指定 JSP 中按跳进顺序排列的组件的位置。此值必须是 0 与 32767 之间的某个数。

title

辅助功能 > 标题

指定标题文本,它在运行时以工具提示的形式显示在浏览器中。如果未指定备用文本,则浏览器将使用标题文本作为组件的备用文本。

类型

未表示

指定按钮类型,如提交复位纯文本

url

未表示

指定组件应使用的 URL。

value

未表示

指定链接所连接至的文档。此值可以是包含文档文件名的字符串,也可以是文档的二进制数据。指定二进制数据是结合设置 MIME 类型属性来完成的。此值可以是字符串(用基本 64 位编码)、byte[] 或 java.io.InputStream 对象。指定二进制数据时,绑定表达式的值必须能够在浏览器发送回至服务器以获取文档的后续请求中进行自行计算。

相关概念
数据表组件
相关任务
对 Faces JSP 文件添加超链接
使用带有 Faces JSP 页的导航规则
相关参考
按钮 - 命令
链接 - 命令

反馈