| NetUI Tag Library Documentation (Version 1.0.1) | ||||||
DETAIL: Syntax | Description | Attributes | Example | Tag Info |
FRAMES NO FRAMES |
Generates a hyperlink with a clickable image.
Syntax |
<netui:imageAnchor
[accessKey="string_accessKey"]
[action="string_action"]
[align="string_align"]
[alt="string_alt"]
[border="integer_pixelBorder"]
[charSet="string_charset"]
[clientAction="string_clientAction"]
[coords="string_coordinates"]
[dir="string_dir"]
[disableSecondClick="boolean_disableSecondClick"]
[formSubmit="boolean_formSubmit"]
[height="integer_height"]
[href="string_href"]
[hrefLang="string_hreflang"]
[hspace="integer_hspace"]
[imageStyle="string_imagestyle"]
[imageStyleClass="string_imageclass"]
[ismap="string_isMap"]
[lang="string_lang"]
[linkName="string_linkName"]
[location="string_location"]
[longdesc="string_longdesc"]
[onBlur="string_onBlur"]
[onClick="string_onClick"]
[onDblClick="string_onDblClick"]
[onFocus="string_onFocus"]
[onKeyDown="string_onKeyDown"]
[onKeyPress="string_onKeyPress"]
[onKeyUp="string_onKeyUp"]
[onMouseDown="string_onMouseDown"]
[onMouseMove="string_onMouseMove"]
[onMouseOut="string_onMouseOut"]
[onMouseOver="string_onMouseOver"]
[onMouseUp="string_onMouseUp"]
[popup="boolean_popup"]
[rel="string_rel"]
[rev="string_rev"]
[rolloverImage="string_rolloverImage"]
[shape="string_shape"]
[src="string_src"]
[style="string_style"]
[styleClass="string_styleClass"]
[tabindex="string_tabIndex"]
[tagId="string_tagId"]
[target="string_action"]
[targetScope="string_targetScope"]
[title="string_title"]
[type="string_type"]
[usemap="string_useMap"]
[value="string_value"]
[vspace="string_vspace"]
[width="integer_pixelWidth"] >
... JSP content ...
</netui:imageAnchor>
Description |
Generates a hyperlink with a clickable image. Provides support for image rollovers.
The <netui:imageAnchor> tag must have one of five attributes to correctly create the hyperlink:
action
- an action method invoked by clicking the hyperlinkhref
- an URL to go tolinkName
- an internal place in the page to move toclientAction
- the action to run on the clienttagId
- the ID of the tagformSubmit
- indicates whether or not the enclosing Form should be submitted
JavaScript
If the formSubmit
attribute is set to true
and no
onClick
attribute is set, the following JavaScript function will be written to the HTML page.
This JavaScript function will be referenced by the onclick
attribute of the generated image
anchor tag.
function anchor_submit_form(netuiName, newAction) { for (var i=0; i<document.forms.length; i++) { if (document.forms[i].id == netuiName) { document.forms[i].method = "POST"; document.forms[i].action = newAction; document.forms[i].submit(); } } }
It is possible to write a custom onClick
JavaScript event handler that would
do additional work, for example form validation, and still submit the form correctly. To
accomplish this, reference a JavaScript function in the onClick
attribute:
<netui:imageAnchor formSubmit="true" onClick="SubmitFromAnchor();return false;"> View Results </netui:imageAnchor>
And add the referenced JavaScript function to the page:
function SubmitFromAnchor() { // implement custom logic here for(var i=0; i<document.forms.length; i++) { // submit to the action /aWebapp/formPost.do if (document.forms[i].action == "/aWebapp/formPost.do") { document.forms[i].method="POST"; document.forms[i].action="/aWebapp/formPost.do"; document.forms[i].submit(); } } }
This will cause the JavaScript function to be executed before posting the form.
Attributes | ||
accessKey |
The keyboard navigation key for the element. The following values are not recommended because they are often used by browsers: A, C, E, F, G,
H, V, left arrow, and right arrow |
|
action |
The action method to invoke. The action method must be in the Controller file of the Page Flow directory. |
|
align |
The alignment of the image. |
|
alt |
The alternative text of the image |
|
border |
The border size around the image |
|
charSet |
The character set. |
|
clientAction |
The action (NetUI JavaScript) to run on the client. |
|
coords |
The coordinates. |
|
dir |
Specifies the direction of text. ( LTR | RTL ) |
|
disableSecondClick |
Boolean. If disableSecondClick is set to true,
the anchor will disable itself after being clicked. |
|
formSubmit |
Boolean. If formSubmit is set to true, and the <netui:anchor> tag
is within a <netui:form> tag,
then the form data will be submitted to the method named in the
<netui:form> tag's action attribute. |
|
height |
The image height |
|
href |
The URL to go to. |
|
hrefLang |
The HREF lang. |
|
hspace |
The horizontal spacing around the image. |
|
imageStyle |
For legacy documents. Specifies style information for the contained image. When the tag library is running in legacy mode, this will override the style attribute. If this is not set, and style is set,
then it will be applied to the image. |
|
imageStyleClass |
For legacy documents. The style class (a style sheet selector). When the tag library is running in legacy mode, this will override the styleClass
attribute. If this is not set, and styleClass is set, then it will be applied to
the image. |
|
ismap |
The server-side map declaration. |
|
lang |
Sets the language code for the base language of an element's attribute values and text content. |
|
linkName |
An internal place on the page to go to. |
|
location |
Location within the URI to visit. |
|
longdesc |
Specifies a link to the the long description. |
|
onBlur |
The onBlur JavaScript event. |
|
onClick |
The onClick JavaScript event. |
|
onDblClick |
The onDblClick JavaScript event. |
|
onFocus |
The onFocus JavaScript event. |
|
onKeyDown |
The onKeyDown JavaScript event. |
|
onKeyPress |
The onKeyPress JavaScript event. |
|
onKeyUp |
The onKeyUp JavaScript event. |
|
onMouseDown |
The onMouseDown JavaScript event. |
|
onMouseMove |
The onMouseMove JavaScript event. |
|
onMouseOut |
The onMouseOut JavaScript event. |
|
onMouseOver |
The onMouseOver JavaScript event. |
|
onMouseUp |
The onMouseUp JavaScript event. |
|
popup |
Boolean. If popup is set to true,
the anchor will open a popup window. |
|
rel |
The relationship between the current document and the target Url. |
|
rev |
Describes a reverse link from the anchor specified to the current document. |
|
rolloverImage |
The URI of the rollover image. |
|
shape |
The shape. |
|
src |
The image source URI |
|
style |
Specifies style information for the current element. |
|
styleClass |
The style class (a style sheet selector). |
|
tabindex |
The tabIndex of the rendered HTML tag. This attribute determines the position of the rendered HTML tag in the sequence of tags that the user may advance through by pressing the TAB key. |
|
tagId |
String value. Sets the For example, assume that some tag's <netui:textBox tagId="foo" /> Then the following JavaScript function will return the real id attribute rendered in the browser: lookupIdByTagId( "foo", this ) To get a <netui:form> element and all of its children elements in JavaScript, use
the same JavaScript function <netui:form tagId="bar" > Then the following JavaScript function will return the <netui:form> element and its children (packaged as an array). document[lookupIdByTagId( "bar", this )] To retreive the value entered into a <netui:textBox> within the <netui:form> tag, use the following JavaScript expression. document[lookupIdByTagId("bar", this)][lookupIdByTagId("foo", this)].value The second parameter ensures that the JavaScript function
begins its search within the correct Portlet scope. Pass the
JavaScript keyword |
|
target |
The window target. |
|
targetScope |
The target scope in which the associated action's page flow resides. |
|
title |
The title. |
|
type |
The type. |
|
usemap |
The client-side image map declaration |
|
value |
Set the text of the anchor, overriding the body content. |
|
vspace |
The vertical spacing around the image. |
|
width |
The image width. |
Example |
In this sample, an <netui:imageAnchor> shows "top.jpg" at 25 x 25 pixels and navigates to index.jsp when clicked.
<netui:imageAnchor href="index.jsp" src="top.jpg" height="25" width="25" />
Tag Information | |
Tag Class | org.apache.beehive.netui.tags.html.ImageAnchor |
TagExtraInfo Class | None |
Body Content | JSP |
Display Name | None |
|
||||||
DETAIL: Syntax | Description | Attributes | Example | Tag Info |
FRAMES NO FRAMES |