将按钮 - 命令组件拖放到页面上:
设计时页面上的按钮 - 命令组件:
运行时页面上的按钮 - 命令组件:
组件的“属性”视图显示可以对组件设置的最常见属性集,并且根据组件的不同,您还可以看到用于添加控件、操作或其他组件的选项。要打开“属性”视图,请单击
。“按钮 - 命令”组件的这些常用属性显示在“属性”视图中的 hx:commandExButton、显示选项、参数和辅助功能选项卡上。要获取完整的属性列表,请参阅全部按钮 - 命令属性表。用于添加参数和操作的其他配置选项显示在 hx:commandExButton 和 hx:commandExButton> 参数选项卡上:
配置选项 |
描述 |
---|---|
添加传递给操作的参数 |
指定组件要将哪些参数传递给操作。 |
单击以编写此按钮执行的操作的代码 |
切换至“快速编辑”视图,以便可以编写命令按钮要执行的操作的代码。另外,还可以根据操作和返回的结果来定义规则。 |
“全部属性”视图显示可以对组件设置的全部属性的表,包含可以从“属性”视图访问的那些属性。要切换至“全部属性”视图,请单击“属性”视图右上角的全部属性图标 。
属性名称 |
在“属性”视图中表示为 |
描述 |
---|---|---|
accesskey |
辅助功能 > 访问键 |
将单个键盘键指定为访问键。在运行时按指定的访问键可以使此组件具有焦点。在运行时按 ALT + 指定的访问键可以使此组件具有焦点,如果组件是一种按钮,则执行此组件。 |
action |
未表示 |
指定当单击组件时返回的值。此值传递至缺省导航处理程序,然后根据在应用程序配置文件中定义的一组导航规则对此值进行匹配。 |
actionListener |
未表示 |
该表达式指向一个带有 ActionEvent 参数和“void”返回类型的方法。 |
alt |
辅助功能 > 备用文本 |
指定组件的备用文本。例如,如果元素在不支持表单的浏览器中和在设置为不显示图像的浏览器中不能正常呈示,则显示此备用文本。 |
binding |
未表示 |
该表达式将组件的实例(通常为用户界面组件)与 Bean 属性(通常在备份文件中)绑定。 |
confirm |
提示文本 |
指定要显示的文本,此文本在按 commandExButton 时请求确认。如果未对此属性设置值,将不会显示“确认”对话框。 |
converter |
未表示 |
指定值所转换至的数据类型。JavaServer Faces 实现提供了一组“转换器”实现,可以使用它们来将组件数据转换为其处理器不支持的类型。 |
dimage |
类型 > 图像:禁用的图像 |
指定当组件被禁用时要显示的图像。 |
dir |
未表示 |
指定当在运行时呈示时组件的方向。值可以是:
|
disabled |
未表示 |
如果 disabled 设置为 true,则在运行时将显示组件,但它不起作用。如果留空,则缺省值为 false。 |
himage |
类型 > 图像:鼠标经过时的图像 |
指定当用户的鼠标指针经过组件时将显示的图像。 |
id |
标识 |
对组件指定一个名称。它在 JSP 内应该是唯一名称。 |
image |
类型 > 图像:正常图像 |
指定组件中要显示的图像的 URL/URI。 |
immediate |
未表示 |
如果为 true,则直接跳至生命周期的呈示阶段。 |
lang |
未表示 |
组件的值和文本内容所用的语言。如果语言被忽略,则它会从包含标记(特别是视图)继承。指定为符合 ISO 标准的语言缩写代码。例如,“en”表示英语,“en-US”表示美国英语,“fr”表示法语,而“de”表示徳语。
注: 此选项不是“翻译”组件中的文本,而是标识组件的语言以便搜索、排序、整理以及类似操作能够正确完成。
|
pimage |
类型 > 图像:鼠标经过时的图像 |
指定当用户单击组件时要显示的图像。 |
readonly |
未表示 |
指定组件的初始值不可更改。 |
rendered |
未表示 |
可设置为 true 或 false:
|
size |
未表示 |
指定组件的初始宽度。除文本输入组件外,宽度以像素数给出。对于文本输入组件,这个值表示字符数。 |
styleClass |
样式:类 |
当呈示此元素时要应用的以空格分隔的 CSS 样式类列表。此值必须作为生成标记上的类属性来传递。定义所选组件的类,例如,样式表。这可以通过手工完成,也可以通过单击按钮并从窗口中选择期望的类来完成。 |
样式 |
样式:属性 |
指定组件的 CSS 样式信息,例如,style="font-size : 8pt ; color : red"。定义所选组件的属性,例如,字体和颜色。这可以通过手工完成,也可以通过单击按钮并从窗口中选择期望的属性来完成。 |
tabindex |
辅助功能 > 跳进顺序索引 |
指定 JSP 中按跳进顺序排列的组件的位置。此值必须是 0 与 32767 之间的某个数。 |
title |
辅助功能 > 标题 |
指定标题文本,它在运行时以工具提示的形式显示在浏览器中。如果未指定备用文本,则浏览器将使用标题文本作为组件的备用文本。 |
类型 |
类型 |
指定按钮类型,如提交、复位或纯文本。 |
value |
输入 > 文本:按钮标签 |
指定在命令按钮中要显示的文本。 |