JSF 1.2 树节点组件属性窗口

另请参见

在  

• 缺省情况下，树节点组件是图像的容器。如果要编辑树节点的图像组件，请在可视设计器中选择树节点的图像部分。

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

常规

• id。类型：字符串
  页面 Bean 和 JSP 文件中的树节点组件的名称。

外观

• expanded。类型：布尔型
  如果选定，第一次显示树时将缺省展开树节点，以显示该节点的子节点。仅当树节点具有子节点时，该属性才具有可见效果。您还可以通过展开或关闭可视设计器中的节点设置或取消该属性。
• style。类型：字符串
  要应用到组件中的层叠样式表规则（CSS 级别 2）。例如：

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

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

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

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

• styleClass。类型：字符串
  呈现组件时应用的以空格分隔的 CSS2 样式类列表。必须在项目的样式表或主题的 CSS 文件中定义这些样式类。单击省略号按钮 (...)，将会看到一个列表，其中包含可添加到此属性中的所有样式。有关将 CSS 类和规则添加到项目的层叠样式表的信息，请参见 CSS 编辑器。
  • 有关已添加到此属性中的类为何没能对组件产生影响的说明，请参见上文中的 style 属性描述。
  • 如果将当前主题中的 CSS 样式类添加到项目 CSS 文件中并重新定义了样式类，则所做更改会影响到使用此样式类的所有组件。但是，您可以将自己的样式类添加到重新定义缺省样式类的项目 CSS 文件中，随后在将这些类添加到此属性时，所做更改只影响此组件的实例。
• text。类型：字符串
  描述树节点的标签。

行为

• target。类型：字符串
  要从中打开链接（在 url 属性中指定）的当前页面的框架。如果具有此名称的框架不存在，则会在新的窗口中呈现响应，除非用户将其覆盖。以下框架名称具有特殊的含义：
  • _blank - 在未命名的新窗口中呈现响应
  • _self - 在当前框架中呈现响应
  • _parent - 在直接父框架集中呈现响应
  • _top - 在完整的未划分框架的窗口中呈现响应
• toolTip。类型：字符串
  呈现为组件的 HTML title 属性，可以由屏幕阅读器读取并显示为工具提示。
  • 如果禁用该组件，则在大多数浏览器中将不显示工具提示。
• url。类型：字符串
  目标文档或资源的 URL。相当于 HTML 属性 href。如果设置了此属性的值，则在用户单击树节点时不会提交页面。通常，如果未设置此属性，则可以使用对应的 action 或 actionListener 方法来定义用户单击超级链接时发生的情况。有关详细信息，请参见上文中的 action 属性或下文中的 actionListener 属性。
• visible。类型：布尔型
  指示用户能否在呈现的 HTML 页面上看到组件。缺省情况下，将选定此属性。如果取消选择此属性，则组件的 HTML 代码将呈现在页面上，但该组件在浏览器中不可见，因为它被样式设置隐藏了。由于 HTML 代码呈现出来，因此在提交表单时仍然可以处理组件，而且在浏览器中查看源代码的用户可以看到 HTML 代码。此外，您的 Web 应用程序可以使用客户端 JavaScript 来显示或隐藏组件。
  • 如果需要完全隐藏组件（例如，由于它包含某些用户不应该看到的敏感信息），请取消选择 rendered 属性。

高级

• actionListenerExpression。类型：方法表达式
  用于表示操作侦听程序方法的方法表达式，该侦听程序方法会在用户激活此组件时收到通知。值必须是有效的 JSF 方法表达式（如 #{Page1.action_method}），并且其计算结果必须为公共方法的名称，该方法使用 ActionEvent 参数并且返回类型为 void。
• rendered。类型：布尔型
  如果选定该属性，将在任何后续页提交中呈现和处理树节点。如果未选定该属性，树节点将不出现在页面上，甚至不作为隐藏组件出现。可以将此属性绑定到确定何时呈现树节点的 JavaBeans 属性中。例如，机票预订表单可能只为经常乘坐飞机的人显示树节点，而不为一般大众显示它。要绑定此属性，请在可视设计器中右键单击组件并选择“使用绑定”，然后选择“全部”单选按钮显示所有属性，以便选择 rendered 属性。

事件

• action。指示用户选择节点时调用的方法的名称。如果将 action 属性绑定到某一 action 方法，则在用户选择节点时会提交页面。
  • 此属性的 JSP 标记为 actionExpression。

  要设置该属性，请在可视设计器中右键单击组件，然后选择“编辑 action 事件处理程序”。IDE 将为当前页面打开 Java 编辑器，并将光标放在相应操作方法中，该方法的缺省名称为 component-id_action。例如，对于 ID 为 treeNode1 的树节点，方法名称为 treeNode1_action。

另请参见

树节点组件

使用组件

组件任务：快速参考