JSF 1.2 常见任务组件属性窗口

另请参见

在使用可视设计器编辑的某个页面上或  

此 JavaServer Faces 1.2 组件具有以下属性。

常规

• id。类型：字符串
  页面 Bean 和 JSP 文件中的常见任务组件的名称。

外观

• icon。类型：字符串
  用于从主题中选取一个图像，而不是指定您自己的图像文件。如果要使用该图标，请确保未设置 imageURL 属性。CTS_OVERVIEW 键提供了可以用于表示此任务的概述信息的图像。
• imageHeight。类型：整型
  如果要覆盖所显示的图像的实际高度，可使用此属性设置图像的高度（以像素为单位）。此属性相当于 HTML <img> 标记的 height 属性。不是所有浏览器都具有此设置。
• imageURL。类型：字符串
  图像文件的相对路径。在设置此属性与 icon 属性的值时，前者比后者的优先级要高。如果单击省略号按钮 (...)，则可以键入 Web 中的图像文件的 URL、可以找到图像文件并将其导入项目中，或者可以将此属性绑定到 JavaBeans 属性来确定 URL，如 imageURL 属性编辑器中所述。
• imageWidth。类型：整型
  如果要超出所显示图像的实际宽度，请设置图像的宽度（以像素为单位）。此属性相当于 HTML <img> 标记的 width 属性。不是所有浏览器都具有此设置。
• infoLinkText。类型：字符串
  提供在信息框底部显示的信息链接的简短描述。只有定义了 infoLinkUrl 属性，此文本才会显示。如果希望用户看到此链接，则必须设置此属性。通常，此链接用于提供比信息框中可显示的内容更加详细的任务相关信息。
• infoText。类型：字符串
  提供用户可通过单击信息链接图标 显示的任务相关信息。此文本将显示在组件下方的信息框中。如果设置了该属性，将导致在常见任务组件右上角显示信息链接图标。
• infoTitle。类型：字符串
  提供当用户单击信息链接图标 时显示的信息框的标题。此标题将显示在组件下方的信息框中。如果设置了该属性，将导致在常见任务组件右上角显示信息链接图标。
• style。类型：字符串
  要应用到组件中的层叠样式表规则（CSS 级别 2）。例如：

     position: absolute; left: 288px; top: 312px

  您既可以直接输入值，也可以单击省略号 (...) 按钮以使用样式编辑器。

  • 此属性将覆盖此组件的主题或项目 CSS 文件中的所有设置。如果在此属性中指定的样式未生效，其原因是组件区域被具有不同样式设置的子组件遮盖住了。

  有关 CSS2 样式属性的列表，请参见以下 Web 页：
  

• styleClass。类型：字符串
  呈现组件时应用的以空格分隔的 CSS2 样式类列表。必须在项目的样式表或主题的 CSS 文件中定义这些样式类。单击省略号按钮 (...)，将会看到一个列表，其中包含可添加到此属性中的所有样式。有关将 CSS 类和规则添加到项目的层叠样式表的信息，请参见 CSS 编辑器。
  • 有关已添加到此属性中的类为何没能对组件产生影响的说明，请参见上文中的 style 属性描述。
• text。类型：字符串
  常见任务组件的标题。此属性的值缺省为 Common Task。

事件

• action。类型：方法绑定
  用户激活该组件时调用的操作方法。可以通过它调用此组件所表示的应用程序任务。

  如果设置了 action 属性，则激活此组件时会提交页面。此属性的 JSP 标记为 actionExpression。

  如果右键单击该组件，则可以选择“编辑 action 事件处理程序”，以定义此组件的操作方法并对该方法自动设置此属性的值。操作方法确定根据某些条件执行的应用程序操作。

行为

• infoLinkUrl。类型：字符串
  信息框底部的链接的 URL。通常，此 URL 链接到 Visual Web JSF 页，该页面可以提供比信息框中可显示的内容更加详细的任务相关信息。链接文本在 infoLinkText 属性中指定。必须设置该属性，用户才能看到此链接。
• target。类型：字符串
  将在其中打开此组件所执行的操作的框架。如果具有此名称的框架不存在，则会在新的窗口中呈现响应，除非用户将其覆盖。以下框架名称具有特殊的含义：
  • _blank - 在未命名的新窗口中呈现响应
  • _self - 在当前框架中呈现响应
  • _parent - 在直接父框架集中呈现响应
  • _top - 在完整的未划分框架的窗口中呈现响应
• toolTip。类型：字符串
  呈现为组件的 HTML title 属性，可以由屏幕阅读器读取并显示为工具提示。
  • 如果禁用该组件，则在大多数浏览器中将不显示工具提示。
• visible。类型：布尔型
  指示用户能否在呈现的 HTML 页面上看到组件。缺省情况下，将选定此属性。如果取消选择此属性，则组件的 HTML 代码将呈现在页面上，但该组件在浏览器中不可见，因为它被样式设置隐藏了。由于 HTML 代码呈现出来，因此在浏览器中查看源代码的用户可以看到 HTML 代码。此外，您的 Web 应用程序可以使用客户端 JavaScript 来显示或隐藏组件。
  • 如果需要完全隐藏组件（例如，由于它包含某些用户不应该看到的敏感信息），请取消选择 rendered 属性。

辅助功能

• tabIndex。类型：字符串
  （可选）按文档的 Tab 键顺序指定组件的位置。确定当用户使用 Tab 键在文档中移动时组件成为焦点的时间。该值必须为 0 至 32767 之间的整数。

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。

高级

• actionListenerExpression。类型：方法表达式
  用于表示操作侦听程序方法的方法表达式，该侦听程序方法会在用户激活此组件时收到通知。值必须是有效的 JSF 方法表达式（如 #{Page1.action_method}），并且其计算结果必须为公共方法的名称，该方法使用 ActionEvent 参数并且返回类型为 void。
• rendered。类型：布尔型
  如果选定该属性，将在任何后续页提交中呈现和处理组件。如果未选定该属性，则组件将不出现在页面中，甚至不作为隐藏组件出现。

另请参见

常见任务组件

使用组件

组件任务：快速参考