You see the Properties window for an Image component when you select the component on a page that you are editing in the Visual Designer.
Most of the Image component's properties are both JSP attributes and properties of the Image Java component in the page bean.
This component has the following properties.
General
id. Type: String
The name of the Image component in the page bean and the JSP file.
Appearance
align. Type: String
The position of the image relative to its context on the page. Pick a position from the drop down list to align the image with other components.
border. Type: int
Specifies the width of the border around the image in pixels. The default value for this property depends on the client browser.
height. Type: int
Sets the height of the image in pixels if you want to override the actual height of the displayed image. In HTML, this equivalent is the height attribute of the <img> tag. Not all browsers respond to this setting.
icon. Type: String
Enables you to pick an image from the theme rather than specifying your own image file. Make sure that the url property is not set if you want to use an icon rather than an image file.
style. Type: String
Cascading Style Sheet rules (CSS level 2) to be applied to the component. For example:
position: absolute; left: 288px; top: 312px
You can enter values directly or click the ellipsis (...) button to use the Style Editor.
This property overrides any settings in the theme or the project CSS file for this component. If a style specified in this property does not appear to take effect, it is because an area of the component is obscured by a child component that has different style settings.
For a list of CSS2 style attributes, see the web page at
styleClass. Type: String A space-separated list of CSS2 style classes to be applied when the component is rendered. The style classes must be defined in the project's style sheet or in the theme's CSS file. If you click the ellipsis button (...), you see a list of all styles you can add to this property. For information on adding CSS classes and rules to the project's cascading style sheet, see CSS Editor.
See the note above under the style property description for an explanation of why a class added to this property might appear to have no effect on the component.
url. Type: String
The path to an image file, or an expression binding to a object that provides the path to the image. This property has precedence over the icon property if both properties are set. If you click the ellipsis button (...), you can bind to an object, or you can provide a value and navigate to an image file and import it into the project. You can also point to a URL for an image on the Web. For example, a file reference might be /resources/image-file.gif, and a URL that points to an image might be
.
width. Type: int
Sets the width of the image in pixels if you want to override the actual width of the displayed image. In HTML, the equivalent is the width attribute of the <img> tag. Not all browsers respond to this setting.
Behavior
toolTip. Type: String
Rendered as the HTML title attribute of the component, which is readable by a screen reader and can be displayed as a tool tip.
If the component is disabled, the tooltip will not display in most browsers.
visible. Type: boolean
Indicates whether or not the component can be seen by the user on the rendered HTML page. This property is selected by default. If you deselect this property, the component's HTML code is rendered on the page, but the component is not visible in the browser because it is hidden by a style setting. Because the HTML code is rendered, the component can still be processed on form submissions, and users who view source in the browser can see the HTML code. In addition, your web application can use client-side JavaScript to show or hide the component.
If you need to completely hide the component, for example, because it contains sensitive information that certain users should not see, deselect the rendered property.
Accessibility
alt. Type: String
The alternate text for the image. The alt text describes the graphic element in the HTML page, is readable by screen readers, can display as a tool tip, and displays when the user has display of images turned off in the web browser. It is equivalent to the HTML attribute alt of the <img> tag.
longdesc. Type: String
The URL of a web page that has a description for this graphic. In HTML, this property is the longdesc attribute of the generated <img> tag.
JavaScript
onClick. Type: String
JavaScript to be executed when the user clicks the component.
onDblClick. Type: String
JavaScript to be executed when the user double-clicks the component.
onMouseDown. Type: String
JavaScript to be executed when the mouse cursor is over the component and the user presses down on the mouse button.
onMouseMove. Type: String
JavaScript to be executed when the user moves the mouse cursor within the component.
onMouseOut. Type: String
JavaScript to be executed when the user moves the mouse cursor away from the component after it has been over the component.
onMouseOver. Type: String
JavaScript to be executed when the user moves the mouse cursor onto the component.
onMouseUp. Type: String
JavaScript to be executed when the mouse cursor is over the component and the user releases the mouse button.
Advanced
hspace. Type: int
Specifies the amount of white space in pixels to be inserted to the left and right of the image. The default value is not specified but is generally a small, non-zero size.
rendered. Type: boolean
If selected, the image is to be rendered and processed on any subsequent page submission. If not selected, the image does not appear on the page at all, not even as a hidden component.
vspace. Type: int
Specifies the amount of white space in pixels to be inserted above and below the image. The default value is not specified but is generally a small, non-zero size.