Tag Name: <a2:url />

Description

This tag is used to create a URL

This tag is used to create a URL.

You can use the "param" tag inside the body to provide additional request parameters.

When includeParams is 'all' or 'get', the parameter defined in param tag will take precedence and will not be overriden if they exists in the parameter submitted. For example, in Example 3 below, if there is a id parameter in the url where the page this tag is included like http://://editUser.action?id=3333&name=John the generated url will be http://:/context>/editUser.action?id=22&name=John cause the parameter defined in the param tag will take precedence.

• action (String) - (value or action choose either one, if both exist value takes precedence) action's name (alias)
• value (String) - (value or action choose either one, if both exist value takes precedence) the url itself
• scheme (String) - http scheme (http, https) default to the scheme this request is in
• namespace - action's namespace
• method (String) - action's method, default to execute()
• encode (Boolean) - url encode the generated url. Default is true
• includeParams (String) - The includeParams attribute may have the value 'none', 'get' or 'all'. Default is 'get'. none - include no parameters in the URL get - include only GET parameters in the URL (default) all - include both GET and POST parameters in the URL
• includeContext (Boolean) - determine wheather to include the web app context path. Default is true.

Examples

  <-- Example 1 --> <a:url value="editGadget.action"> <a:param name="id" value="%{selected}" /> </a:url> <-- Example 2 --> <a:url action="editGadget"> <a:param name="id" value="%{selected}" /> </a:url> <-- Example 3--> <a:url includeParams="get" > <:param name="id" value="%{'22'}" /> </a:url>  

Attributes

Name	Required	Default	Type	Description
includeParams	false	get	Object/String	The includeParams attribute may have the value 'none', 'get' or 'all'.
scheme	false		Object/String	Set scheme attribute
value	false		Object/String	The target value to use, if not using action
action	false		Object/String	The action generate url for, if not using value
namespace	false		Object/String	The namespace to use
method	false		Object/String	The method of action to use
encode	false	true	Boolean	whether to encode parameters
includeContext	false	true	Boolean	whether actual context should be included in url
portletMode	false		Object/String	The resulting portlet mode
windowState	false		Object/String	The resulting portlet window state
portletUrlType	false		Object/String	Specifies if this should be a portlet render or action url
anchor	false		Object/String	The anchor for this URL
id	false		Object/String	id for referencing element. For UI and form tags it will be used as HTML id attribute