WOHyperlink

Last modified by Pascal Robert on 2012/01/30 22:04

Introduction

WOHyperlink generates a hypertext link in an HTML document.

If you use Project Wonder, WOHyperlink is automatically patched with ERXHyperlink.

Usage


WOHyperlink { action=aMethod | href=aURL; | pageName=aString; | directActionName=anActionName; [actionClass=className;] [fragmentIdentifier=anchorFragment;] [string=aString;] [target=frameName;] [disabled=aBoolean;] [secure=aBoolean;] [queryDictionary=aDict;]...}

Bindings

action

Action method to invoke when this element is activated. The method must return a WOElement.

href

URL to direct the browser to when the link is clicked.

pageName

Name of WebObjects page to display when the link is clicked.

directActionName

The name of the direct action method (minus the "Action" suffix) to invoke when this element is activated. Defaults to "default".

actionClass

The name of the class in which the method designated in directActionName can be found. Defaults to DirectAction.

fragmentIdentifier

Named location to display in the destination page.

string

Text displayed to the user as the link. If you include any text between the <WEBOBJECT ...> and </WEBOBJECT> tags for this element, the contents of string is appended to that text.

target

Frame in a frameset that will receive the page returned as a result of the user's click.

disabled

If evaluates to true , the content string is displayed, but the hyperlink is not active.

secure

Changes the URL prefix from http to https when WebObjects generates URLs for component actions and direct actions for this element. For this attribute to have any effect, you must provide bindings either for the action, directAction, actionClass, or pageName attribute (respecting the valid combinations).

queryDictionary

Takes a dictionary that should be appended to the hyperlink's URL after a question mark character. The dictionary must be correctly encoded and will be merged with any existing query dictionary for a particular session ID.

Examples

Java methods

WOD-style

Inline bindings (WOOGNL)

Related documents

ERXHyperlink