输出 - 格式化文本

将格式化消息输出至页面。消息被定义为可以来自于数据存储器(例如,数据库)或 bean 的静态文本和动态数据的组合。

设计时的组件

输出 - 格式化文本组件拖放到页面上:
“输出 - 格式化文本”组件按钮

输出 - 格式化文本组件在页面上看起来为如下所示:
设计时的“输出 - 格式化文本”

运行时的组件

在运行时,输出 - 格式化文本组件在页面上看起来为如下所示:
运行时的“输出 - 格式化文本”

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

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

“图像”组件的这些常见属性显示在“属性”视图中的 h:outputFormat 选项卡上。要获取完整的属性列表,请参阅全部输出 - 格式化文本属性表。用于添加参数的其它配置选项位于 h:outputFormat 选项卡上。

表 1. “输出 - 格式化文本”配置选项

配置选项

描述

添加参数值以替换值字符串中的每个 {n}

允许您指定“输出消息”参数的名称和值。您也可以使用“除去”按钮除去某些项,还可以使用“上移”和“下移”按钮来更改这些项在面板中的顺序。

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

表 2. 全部“输出 - 格式化文本”属性

属性名称

在“属性”视图中表示为

描述

binding

未表示

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

converter

未表示

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

escape

未表示

指定是将 HTML 格式转义(False)还是将 HTML 标记呈示为 HTML(True)。

id

标识

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

immediate

未表示

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

rendered

未表示

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

style

样式:属性

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

styleClass

样式:类

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

title

未表示

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

value

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

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