JSF 1.2 图像组件属性窗口
另请参见
在使用可视设计器编辑的某个页面上选择图像组件 时,将显示该组件的“属性”窗口。
图像组件的大多数属性既是 JSP 属性,又是页面 Bean 中 Image Java 组件的属性。
此 JavaServer Faces 1.2 组件具有以下属性。
常规
id。 类型:字符串
页面 Bean 和 JSP 文件中图像组件的名称。
外观
align。 类型:字符串
图像在页面上相对于其上下文的位置。从下拉列表中选取一个位置,以便将图像与其他组件对齐。
border。 类型:整型
指定图像边框的宽度(以像素为单位)。该属性的缺省值取决于客户端浏览器。
height。 类型:整型
如果要覆盖所显示的图像的实际高度,可使用此属性设置图像的高度(以像素为单位)。在 HTML 中,该属性相当于 <img> 标记的 height 属性。不是所有浏览器都具有此设置。
icon。 类型:字符串
用于从主题中选取一个图像,而不是指定您自己的图像文件。如果要使用图标而不使用图像文件,请确保未设置 url 属性。 style。 类型:字符串
要应用到组件中的层叠样式表规则(CSS 级别 2)。例如:
position: absolute; left: 288px; top: 312px
您既可以直接输入值,也可以单击省略号 (...) 按钮以使用样式编辑器 。
此属性将覆盖此组件的主题或项目 CSS 文件中的所有设置。如果在此属性中指定的样式未生效,其原因是组件区域被具有不同样式设置的子组件遮盖住了。
有关 CSS2 样式属性的列表,请参见以下 Web 页:
styleClass。 类型:字符串 呈现组件时应用的以空格分隔的 CSS2 样式类列表。必须在项目的样式表或主题的 CSS 文件中定义这些样式类。单击省略号按钮 (...),将会看到一个列表,其中包含可添加到此属性中的所有样式。有关将 CSS 类和规则添加到项目的层叠样式表的信息,请参见 CSS 编辑器 。
有关已添加到此属性中的类为何没能对组件产生影响的说明,请参见上文中的 style 属性描述。
url。 类型:字符串
图像文件的路径,或绑定到提供图像路径的对象的表达式。在设置此属性与 icon 属性时,前者比后者的优先级要高。如果单击省略号按钮 (...),则可以绑定到一个对象,或者提供一个值并找到一个图像文件,然后将其导入到项目中。也可以指向 Web 上某个图像的 URL。例如,文件引用可能为 /resources/image-file.gif,指向图像的 URL 可能为
。
width。 类型:整型
如果要超出所显示图像的实际宽度,请设置图像的宽度(以像素为单位)。在 HTML 中,该属性相当于 <img> 标记的 width 属性。不是所有浏览器都具有此设置。
行为
toolTip。 类型:字符串
呈现为组件的 HTML title 属性,可以由屏幕阅读器读取并显示为工具提示。
如果禁用该组件,则在大多数浏览器中将不显示工具提示。
visible。 类型:布尔型
指示用户能否在呈现的 HTML 页面上看到组件。缺省情况下,将选定此属性。如果取消选择此属性,则组件的 HTML 代码将呈现在页面上,但该组件在浏览器中不可见,因为它被样式设置隐藏了。由于 HTML 代码呈现出来,因此在提交表单时仍然可以处理组件,而且在浏览器中查看源代码的用户可以看到 HTML 代码。此外,您的 Web 应用程序可以使用客户端 JavaScript 来显示或隐藏组件。
如果需要完全隐藏组件(例如,由于它包含某些用户不应该看到的敏感信息),请取消选择 rendered 属性。
辅助功能
alt。 类型:字符串
图像的替代文本。alt 文本描述 HTML 页中的图形元素,其中的文本可通过屏幕阅读器读取,并作为工具提示显示,当用户关闭 Web 浏览器中的图形显示时,将显示该文本。它相当于 HTML <img> 标记的 alt 属性。
longdesc。 类型:字符串
包含此图形说明的 Web 页的 URL。在 HTML 中,此属性是生成的 <img> 标记的 longdesc 属性。
JavaScript
onClick。 类型:字符串
用户单击组件时执行的 JavaScript。
onDblClick。 类型:字符串
用户双击组件时执行的 JavaScript。
onMouseDown。 类型:字符串
在鼠标光标位于组件上方且用户按下鼠标按钮时执行的 JavaScript。
onMouseMove。 类型:字符串
用户在组件中移动鼠标光标时执行的 JavaScript。
onMouseOut。 类型:字符串
在鼠标光标位于组件上方后用户将其从组件移开时执行的 JavaScript。
onMouseOver。 类型:字符串
用户将鼠标光标移动到组件上方时执行的 JavaScript。
onMouseUp。 类型:字符串
鼠标光标位于组件上方且用户释放鼠标按钮时执行的 JavaScript。
高级
hspace。 类型:整型
指定插入到图像左侧和右侧的空白区域的大小(以像素为单位)。尚未指定缺省值,但通常它是一个很小的非零值。
rendered。 类型:布尔型
如果选定该属性,将在任何后续页提交中呈现和处理图像。如果未选定该属性,图像则不会出现在页面中,甚至不作为隐藏组件出现。
vspace。 类型:整型
指定插入到图像上面和下面的空白区域的大小(以像素为单位)。尚未指定缺省值,但通常它是一个很小的非零值。
另请参见
图像组件
使用组件
组件任务:快速参考
法律声明