Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Configuring a Button control

Updated on December 13, 2022
Applicable to Theme Cosmos applications

Provide users with a familiar way of triggering actions in their applications by using Button controls. For example, users can click a Button control to submit a form that they complete, which creates an intuitive workflow that does not require training.

Before you begin: Add a Button control to the layout.

For more information, see Adding UI components to a view.

Note the following accessibility best practices:
  • Ensure that captions use descriptive, user-friendly text.
  • Avoid helper text and try to clearly describe the action in the caption.
  • Use the Strong format for primary actions but do not overuse it.
  1. Open the view with the control that you want to edit.
    For more information, see Accessing views in your application.
  2. In the configuration pane on the right side of the window, hover over the control, and then click the Edit icon.
  3. In the Button caption list, select the text that appears on the button:
    • To set the button caption manually, select Text, and then, in the Text field, enter the caption.
    • To display a property value as a button caption, select Property reference, and then select the property that you want to link to the button.
    Note: Non-autogenerated sections also support parameters as a caption source.
  4. To make it possible for users to trigger the button's activity by using shortcut keys, include an ampersand immediately before a letter in the caption text to designate that letter as the shortcut key.
    For example: Enter &History as the caption text to allow application users to press ALT + H to access work item history.
  5. Add an action to the button.
    For more information, see Adding action sets to a control.
  6. Optional: To display the control as a floating button on mobile devices, on the Presentation tab, select Set as Floating Action Button (FAB).
    Floating action buttons disappear from the canvas preview.
  7. Click Apply.
What to do next: Configure the remaining settings. For more information, see Configuring common control settings.
  • Previous topic Adding custom attributes for version 1 DX API to auto-generated controls
  • Next topic Specifying presentation options for a Button control

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us