JSF 1.2 图像组件
另请参见
图像组件
提供了将图像(如 JPEG、GIF 或 PNG 文件)添加到 Visual Web JSF 页的方法。
-
此组件支持客户端 JavaScript 功能,您可以使用这些功能在客户端执行操作,而无需返回到服务器。有关此高级功能的详细信息,请选择“帮助”>“Javadoc 引用”>“项目 Woodstock 4.2 标记库”,然后导航至 webuijsf:image。
将图像放到可视设计器中的页面上时,您会看到一个包含图像字样的简单框。如果右键单击该框并选择“设置图像”,则会看到一个对话框,可以使用该对话框按以下三种方式来指定图像:
- 选择文件。您可以找到文件系统中的某个文件,然后单击“确定”。图像文件将被复制到项目中,您可以在中的 "<项目名称>" >“Web 页”> "resources" 下面看到该文件。通过选择该选项,可以将图像组件的
url 属性设置为 /resources/image-file。
- 输入 URL。输入文件 Web 位置的 URL。例如,输入以下 URL:
。
通过选择该选项,可以将图像组件的 url 属性设置为所输入的 URL。
- 设置主题图标。显示一个图标列表,这些图标位于与应用程序关联的主题中。在该列表中选择一个图标名称,以便在对话框中显示该名称。通过选择该选项,可以将图像组件的
icon 属性设置为所选的图标名称。
-
如果已设置了
url 属性,选择图标并不会改变组件外观,因为 url 属性的级别优先于 icon 属性。要使图标可见,则不能设置 url 属性。
将图像添加到页面上的另一种方法是,将其文件节点从文件资源管理器对话框拖到页面上。例如,在打开 Microsoft Windows 文件资源管理器并导航至 GIF 图像后,可以将其节点拖到页面上,然后将图像文件放到要在页面上显示的位置。IDE 会将该文件添加到 resources 目录中,该目录位于中的 "<项目名称>" >“Web 页”文件夹下。
将组件放到页面上后,可以选择该组件并在图像组件的“属性”窗口中编辑其属性。如有必要,请右键单击该组件并选择“属性”以显示“属性”窗口。除了上述用于指定要显示的图像的属性外,您还可以设置一些典型的属性,例如:
- id。图像组件的名称。在 JSP 文件中,该名称是该组件的
id 属性的值。在页面 Bean 中,该属性的值是 Image 对象的名称。
- alt。图像的替代文本。alt 文本描述 HTML 页中的图形元素,其中的文本可通过屏幕阅读器读取,并作为工具提示显示,当用户关闭 Web 浏览器中的图形显示时,将显示该文本。它相当于 HTML
<img> 标记的 alt 属性。
- align。图像在页面上相对于其上下文的位置。从下拉列表中选取一个位置,以便将图像与其他组件对齐。
- border。指定图像周围边框的宽度(以像素为单位)。该属性的缺省值取决于客户端浏览器。
也可以右键单击该组件,然后选择以下某个选项:
- 绑定到数据。打开一个对话框,通过该对话框可以将组件的
url 属性绑定到为其提供值的数据提供器或对象,以便动态地更新图像。有关详细信息,请参见“绑定到数据”对话框。
- 设置图像。打开一个对话框,通过该对话框可以将图像设置为文件或图标。在此对话框中指定图像后,可以设置相应的属性。
url 属性在文件中或 Web 的 URL 中指定图像。icon 属性在缺省主题中指定图标。
- 属性绑定。打开一个对话框,通过该对话框可以将
url 之外的组件属性绑定到其他对象或属性,这些对象或属性将自动更新此组件的属性。
- 添加绑定属性。该选项用于在组件中添加绑定属性。
- 注意:如果您打算使用 Java 代码编写组件脚本,则必须手动添加绑定属性,可使用值绑定表达式将该属性绑定到支持页面 Bean 的属性上。
- 删除绑定属性。该选项用于从组件中删除绑定属性。
- 另请参见
-
图像组件属性窗口
- 绑定组件属性
- 使用组件
- 组件任务:快速参考
- 关于 Visual Web 组件面板
法律声明