命令 - 超链接

在页面上创建可单击的超链接。可以通过它浏览至其它页面,或者对它进行编程以执行客户机端或服务器端操作。选择此组件将添加超链接组件和相关联的输出文本,它是一个可单独编辑的组件

设计时的组件

命令 - 超链接组件拖放到页面上:
“命令 - 超链接”组件按钮

命令 - 超链接组件在此页面上看起来为如下所示:
设计时的“命令 - 超链接”

运行时的组件

在运行时,命令 - 超链接组件在页面上看起来为如下所示:
运行时的“命令 - 超链接”

“属性”视图和“全部属性”视图

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

“命令 - 超链接”组件的这些常见属性显示在“属性”视图中的 h:commandLink参数辅助功能选项卡上。要获取完整的属性列表,请参阅全部命令 - 超链接属性表。用于添加参数和操作的其它配置选项位于 h:commandLinkh:commandLink> 参数选项卡上:

配置选项

描述

添加传递给操作的参数

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

单击以编写此链接执行的操作

切换至“快速编辑”视图,以便可以编写超链接要执行的操作。另外,可以根据操作和返回的结果来定义规则。

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

表 1. 全部“复选框组”属性

属性名称

在“属性”视图中表示为

描述

accesskey

辅助功能 > 访问键

将单个键盘键指定为访问键。在运行时按指定的访问键就可以使此组件具有焦点。

action

未表示

指定当单击组件时返回的值。此值被传递至缺省 NavigationHandler,后者将这个值参照应用程序配置文件中定义的一组导航规则进行比对。

actionListener

未表示

对操作进行响应的类的名称。此属性仅与可具有操作的组件相关,例如,按钮和链接。

binding

未表示

表示此组件的 UIComponent,通常在备份文件中。

charset

未表示

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

coords

未表示

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

dir

未表示

指定当在运行时呈示时组件的方向。值可以是:
  • ltr - 从左到右
  • rtl - 从右到左

hreflang

未表示

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

id

标识

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

immediate

未表示

如果为 true,则直接跳至生命周期的呈示阶段。

lang

未表示

指定组件的属性值和文本内容的基本语言。采用 ISO 标准语言缩写代码(例如,“en”表示英语,“en-US”表示美国英语,“fr”表示法语,而“de”表示徳语)。

rel

未表示

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

rendered

未表示

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

rev

未表示

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

shape

未表示

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

styleClass

样式:类

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

style

样式:属性

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

target

未表示

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

tabindex

辅助功能 > 跳进顺序索引

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

title

辅助功能 > 标题

指定标题文本,它在运行时以工具提示的形式显示在浏览器中。

type

未表示

指定按钮类型,提交复位,它提交或复位相关联的表单中的信息。

value

未表示

指定在运行时显示的组件的初始文本值。包含要显示的信息,它采用指定值或者指向动态值的指针的形式。

相关概念
使用 JavaServer Faces 创建数据访问 Web 应用程序
相关任务
创建 Faces 应用程序 - 概述
相关参考
Faces 组件参考
Faces 组件的属性
命令 - 按钮
反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.