This documentation supports the 22.1 version of Action Request System.
To view an earlier version, select the version from the Product version menu.

Button fields

Button fields are control fields used to execute active links.

Button field 

Error rendering macro 'include'

com.atlassian.renderer.v2.macro.MacroException: No page title provided.

 supports Regular and Flat button fields.

  • Regular buttons have borders and background and might or might not contain images. These buttons are used on forms that require a user to perform an action. For example:
    • Buttons associated with an edit field, such as a calendar pop-up button, a menu drop-down button, or a rich text editor
    • Buttons inside pop-up menus
    • Buttons inside tables, including attachment pools, status history, and alert lists
    • Buttons inside table columns
  • Flat buttons do not have borders or background, but they do contain images. These buttons are used in toolbars and other places that require an icon to act as a button. These buttons can also be used for images that do not act as a button (for example, a logo on a page).

    Error rendering macro 'include'

    com.atlassian.renderer.v2.macro.MacroException: No page title provided.

     provides built-in styles for buttons and the capability for applications to specify multiple images for a button and change the appearance of buttons depending on the states. The button states are as follows:
    • Default
    • Mouse over
    • On click
    • Disabled
    • Read only
      The appearance of Flat buttons changes based on the values set for the following properties in

      Error rendering macro 'include'

      com.atlassian.renderer.v2.macro.MacroException: No page title provided.

      .
  • When the Display as Flat Image property value is set to True for a Button field, a new property named Mouseover Effect is available with the following values—None, Pointer Cursor, and Button.
    The Flat button style depends on the value set for the Mouseover Effect property.
    • If the property is set to Pointer Cursor or Button, the cursor changes to pointer style when you click or hover the mouse on the button.
    • If the property is set to None, the cursor remains in default style when you click or hover the mouse on the button.
  • A property named Disabled Image has been added to store the images for the disabled state of the button.
    If an image is not specified for the Disabled Image property, the image specified for the image property will continue to be used for the disabled state, but it will be greyed-out.
    Buttons look different in the mouse-over and on-click states.
    Following are the appearance changes that occur on the button field for different user actions.

    Change with a user action

    Regular button appearance change?

    Flat button appearance change?

    Cursor change on mouse-over

    Yes Pointer style

    Yes Pointer style when the Mouseover Effect property value is set to Pointer Cursor or Button. Otherwise, default style.

    Style change on mouse-over

    Yes

    Button background appears only when the Mouseover Effect property value is set to Button.

    Style change on click

    Yes

    Button background appears only when the Mouseover Effect property value is set to Button.

    Style change when disabled

    Yes Default style with arrow cursor Dimmed

    Yes Default style with arrow cursor Dimmed

The button appearance changes are applied to all system-level components, such as dialog boxes, and to all complex components in

Error rendering macro 'include'

com.atlassian.renderer.v2.macro.MacroException: No page title provided.

, such as tables.

Buttons can be displayed as URLs and then associated with an Open Window active link action to simulate a hyperlink that opens a new window. (To add a real URL that links to a web page, see Adding a URL to a trim text field.)

Was this page helpful? Yes No Submitting... Thank you

Comments