Tag name: <amc:commandLink>

The commandLink component creates a link that, when pressed, will generate an action event. It may also contain a child image component to create a link that displays an image rather than text.

WM commandLink screenshot
A commandLink component running on Windows Mobile.

BB commandLink screenshot
A commandLink component running on BlackBerry.

<amc:commandLink text="Return to Portal"/>
<amc:commandLink>
  <amc:image source="return.png"/>
</amc:commandLink>

Attributes

Name Type Supports EL? Description
action String Yes Defines a reference to an action method sent by the command component, or the static outcome of an action.
actionListener oracle.adfnmc.el.MethodExpression Only EL Defines a method reference to an action listener.
align String Yes Specifies the horizontal alignment of an element with respect to the surrounding context. Valid values:
  • left (default): the component is rendered flush left.
  • center: the component is centered horizontally.
  • right: the component is rendered flush right.
The attribute is ignored and defaulted to left when the parent Panel Group Layout has a horizontal layout.

Note: On BlackBerry smartphones, if the attribute value is assigned by an EL expression, any changes to the value will not affect the visual appearance of the element once it is rendered.
backgroundColor String Yes Sets the color of a background to an RGB value (rgb(255,0,0)) or a hexadecimal number (#ff0000 or #f00). The default value is device-dependent.
disabled boolean Yes Specifies whether or not the component is disabled. Unlike a read-only component, a disabled component cannot receive focus.
focusable boolean Yes Specifies whether or not this component can acquire focus set to it by the user. Unlike disabled, clicking on a focusable component will cause the component to receive focus.
fontFamily String Yes Defines a prioritized list of font family names and/or generic family names for an element. The client will use the first value it recognizes. Valid values:
  • family-name: the name of a font-family, such as "times", "courier", "arial", and so on.
  • generic-family: the name of a generic-family, such as "serif", "sans-serif", "cursive", "fantasy", "monospace".
Note: Each value has to be separated with a comma, and a generic-family name should always be offered as the last alternative. Also, supported font type is limited by the mobile device operating system. Please verify if the specified fontFamily is supported on device or simulator.
fontSize int Yes Specifies the size of a font in points.
fontStyle String Yes Specifies how the characters in text should be displayed. Valid values:
  • normal: defines normal characters.
  • bold: defines thick characters.
  • italic: defines slanted characters.
  • underline: defines underlined characters.
Two or more styles can be combined by providing a space between them. For example, the following creates text that is bold and underlined:
fontStyle="bold underline".
foregroundColor String Yes Specifies the color of the foreground of an element. The color value can be an RGB value (rgb(255,0,0)) or a hexadecimal number (#ff0000 or #f00). The default value is device-dependent.
height int Yes Specifies the height of the component. Can be entered in pixels or as a percentage of its parent's height. A percentage value should be entered as a number followed by the "%" symbol. A number will be interpreted as a pixel value (as will a number followed by the text "px").
id String No Specifies the identifier for the component. The identifier must follow the following rules:
  • Must not be a zero-length String.
  • First character must be an ASCII letter (A-Za-z) or an underscore ('_').
  • Subsequent characters must be an ASCII letter or digit (A-Za-z0-9), an underscore ('_'), or a dash ('-').
rendered boolean Yes Specifies whether or not the component is rendered. When set to false, no output will be delivered for this component (the component will not in any way be rendered, and cannot be made visible).
text String Yes Specifies the textual label of the component.
verticalAlign String Yes Specifies the vertical alignment of a component with respect to the surrounding context. Valid values:
  • top: the component is rendered flush top.
  • middle: the component is centered vertically.
  • bottom: the component is rendered flush bottom.
This attribute is ignored and defaulted to top when the parent Panel Group Layout has a vertical layout.

Note: On BlackBerry smartphones, if the attribute value is assigned by an EL expression, any changes to the value will not affect the visual appearance of the element once it is rendered.
width int Yes Specifies the width of this component. Can be entered in pixels or as a percentage of its parent's width. A percentage value should be entered as a number followed by the "%" symbol. A number will be interpreted as a pixel value (as will a number followed by the text "px").