New Image Anchor Dialog

Use this dialog to create a new image anchor. An image anchor is like an anchor, except that a clickable image replaces clickable text. The <netui:imageAnchor> tag supplies the source code for an image anchor.

How To Open This Dialog

In the Page Flow perspective, from the JSP Design Palette drag and drop the image anchor icon into the source view of a JSP page. The image anchor icon is in the section labeled NetUI.

How To Use This Dialog

There are four different modes to this dialog, controlled from the Anchor Type dropdown field. Each mode presents a different set of available fields. These modes are:

Action: Creates an image anchor that invokes an action method in the page flow Controller class.
The following fields are presented in Action mode:

Image Path: the path to the clickable image.
Action: the action method to be invoked.
Parameters: parameters/value pairs will be passed to the action method as Java parameters.

If the following values are entered into the dialog:

The following NetUI tag set will be created:
```
    <netui:imageAnchor action="getCustomers" src="images/myImages.gif">
        <netui:parameter name="param1" value="value1" />
    </netui:imageAnchor>
```
The final HTML will be rendered as follows:
```
    <a href="/CustomerCare/customerManagement/getCustomers.do?param1=value1"><img src="/images/myImages.gif"></a>
```
Clicking the link will invoke the following action:
```
    @Jpf.Action(...)
    public Forward getCustomers(String param1) {
        ...
    } 
```
Hyperlink: Creates an image anchor that links to an URL.
The following fields are presented in Hyperlink mode:

Image Path: the path to the clickable image.
URL: the URL (relative or absolute) to link to.
Parameters: parameters/value pairs will added to the URL's query string (the portion of the URL appended after the '?').

If the following values are entered into the dialog:

The following NetUI tag set will be created:
```
     <netui:imageAnchor href="somePage.jsp" src="images/myImage.gif">
         <netui:parameter name="param1" value="value1" />
    </netui:imageAnchor>
```
The following HTML will be rendered (where "CustomerCare" is the project name and "customerManagement" is the path to the page flow):
```
<a href="/CustomerCare/customerManagement/somePage.jsp?param1=value1"><img src="/CustomerCare/customerManagement/images/myImage.gif"></a>
```
Named Anchor: Creates a link to a named anchor on the same page.
If the following values are entered into the dialog:

The following NetUI tag set will be created:
```
    <netui:imageAnchor linkName="subsection1" src="images/myImage.gif"></netui:imageAnchor>
```
The following HTML will be rendered (where "CustomerCare" is the project name and "customerManagement" is the path to the page flow):
```
    <a href="#subsection1"><img src="/CustomerCare/customerManagement/images/myImage.gif"></a>
```
Basic Anchor: Creates an incomplete <netui:imageAnchor> tag. Only the src attribute on the tag is specified in this mode. The user must manually edit the source to complete the tag. At least one of the following attributes must be specified for HTML to be rendered: action, href, linkName, clientAction, tagId, or formSubmit.