显示错误

提交页面时显示由服务器生成的错误消息。通常将此组件绑定至其它输入组件。

设计时的组件

显示错误组件拖放到页面上:
“显示错误”组件按钮

显示错误组件在页面上看起来为如下所示:
设计时的“显示错误”

运行时的组件

在运行时,根据正在显示其错误的组件不同,显示错误组件也不相同。

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

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

“显示错误”组件的这些常见属性显示在“属性”视图中的 h:message 选项卡上。要获取完整的属性列表,请参阅全部显示错误属性表。

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

表 1. 全部“显示错误”属性

属性名称

在“属性”视图中表示为

描述

binding

未表示

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

errorClass

未表示

与组件关联的备用 CSS 类名。使用这些类名的情况可从名称确定。

errorStyle

未表示

CSS 类的样式修饰符。

fatalClass

未表示

与组件关联的备用 CSS 类名。使用这些类名的情况可从名称确定。

fatalStyle

未表示

CSS 类的样式修饰符。

for

显示有关组件的错误消息

指定想要捕获的输入字段的标识并显示错误消息。

id

标识

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

infoClass

未表示

与组件关联的备用 CSS 类名。使用这些类名的情况可从名称确定。

infoStyle

未表示

CSS 类的样式修饰符。

rendered

未表示

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

showDetail

未表示

指定是否显示错误的详细部分。

showSummary

未表示

指定是否显示消息的总结。

style

样式:属性

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

styleClass

样式:类

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

title

未表示

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

tooltip

未表示

指定是否以工具提示的形式显示消息的详细信息部分。

warnClass

未表示

与组件关联的备用 CSS 类名。使用这些类名的情况可从名称确定。

warnStyle

未表示

CSS 类的样式修饰符。

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