• /
  • Log in

Button

Buttons are used throughout the product to provide users a way to complete an action. Try to not overuse buttons in your experience. This will help users know exactly what action you would like them to take. Never use more than one primary button in your experience.

Primary Capabilities — the buttons can

  • perform one action
  • perform multiple actions, if multiple buttons are present.

Usage

import { Button } from 'nr1'

Examples

Props

ariaControlsstring

Pass the id string of the element the Button controls when it's used to expand or open a panel. Use it along with ariaExpanded.

ariaExpandedboolean

Use it along with ariaControls to indicate the element the Button controls is expanded.

Check ariaControls prop example.

ariaLabelstring

Use it to describe better the context of the component's action or in buttons displaying only an icon for users on screen readers.

childrennode
DEFAULT
null

Content to render inside the button.

classNamestring

Appends class names to the component.

Should be used only for positioning and spacing purposes.

disabledboolean
DEFAULT
false

Use the disabled state for a button prior to a user filling out the required fields of a form or when a user must complete some other task before the button can be enabled.

iconTypeenum

Icon to display.

<One of
Button.ICON_TYPE.DATAVIZ__DATAVIZ__AREA_CHART,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__BAR_CHART,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__CHART,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__CHART__A_ADD,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__CHART__A_EDIT,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__CHART__A_REMOVE,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__DASHBOARD,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__DASHBOARD__A_ADD,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__DASHBOARD__A_EDIT,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__DASHBOARD__A_FILTER,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__DASHBOARD__A_REMOVE,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__LINE_CHART,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__PIE_CHART,
Button.ICON_TYPE.DATE_AND_TIME__DATE_AND_TIME__DATE,
Button.ICON_TYPE.DATE_AND_TIME__DATE_AND_TIME__DATE__A_ADD,
Button.ICON_TYPE.DATE_AND_TIME__DATE_AND_TIME__DATE__A_REMOVE,
Button.ICON_TYPE.DATE_AND_TIME__DATE_AND_TIME__TIME,
Button.ICON_TYPE.DATE_AND_TIME__DATE_AND_TIME__TIME__A_ADD,
Button.ICON_TYPE.DATE_AND_TIME__DATE_AND_TIME__TIME__A_REMOVE,
Button.ICON_TYPE.DOCUMENTS__DOCUMENTS__ATTACHMENT,
Button.ICON_TYPE.DOCUMENTS__DOCUMENTS__DOCUMENTATION,
Button.ICON_TYPE.DOCUMENTS__DOCUMENTS__EMAIL,
Button.ICON_TYPE.DOCUMENTS__DOCUMENTS__EMAIL__V_ALTERNATE,
Button.ICON_TYPE.DOCUMENTS__DOCUMENTS__FILE,
Button.ICON_TYPE.DOCUMENTS__DOCUMENTS__FILE__A_ADD,
Button.ICON_TYPE.DOCUMENTS__DOCUMENTS__FILE__A_REMOVE,
Button.ICON_TYPE.DOCUMENTS__DOCUMENTS__FOLDER,
Button.ICON_TYPE.DOCUMENTS__DOCUMENTS__FOLDER__A_ADD,
Button.ICON_TYPE.DOCUMENTS__DOCUMENTS__FOLDER__A_REMOVE,
Button.ICON_TYPE.DOCUMENTS__DOCUMENTS__NOTES,
Button.ICON_TYPE.DOCUMENTS__DOCUMENTS__NOTES__A_ADD,
Button.ICON_TYPE.DOCUMENTS__DOCUMENTS__NOTES__A_EDIT,
Button.ICON_TYPE.DOCUMENTS__DOCUMENTS__NOTES__A_REMOVE,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__ANOMALIES,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__CLUSTER,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__CLUSTER__A_INSPECT,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__CLUSTER__S_DISABLED,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__CLUSTER__S_ERROR,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__CLUSTER__S_OK,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__CLUSTER__S_WARNING,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__CPU,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__DESKTOP,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__DESKTOP__S_DISABLED,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__DESKTOP__S_ERROR,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__DESKTOP__S_OK,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__DESKTOP__S_WARNING,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__MEMORY,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__MOBILE,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__MOBILE__A_CHECKED,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__MOBILE__S_DISABLED,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__MOBILE__S_ERROR,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__MOBILE__S_OK,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__MOBILE__S_WARNING,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__NETWORK,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__NETWORK__A_INSPECT,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__NETWORK__S_DISABLED,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__NETWORK__S_ERROR,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__NETWORK__S_OK,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__NETWORK__S_WARNING,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__SERVER,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__SERVER__A_ADD,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__SERVER__A_CONFIGURE,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__SERVER__A_EDIT,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__SERVER__A_INSPECT,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__SERVER__A_PAUSE,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__SERVER__A_REMOVE,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__SERVER__S_DISABLED,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__SERVER__S_ERROR,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__SERVER__S_OK,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__SERVER__S_WARNING,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__HARDWARE__STORAGE,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__KUBERNETES__K8S_CLUSTER,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__KUBERNETES__K8S_CONTAINER,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__KUBERNETES__K8S_DEPLOYMENT,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__KUBERNETES__K8S_MASTER_NODE,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__KUBERNETES__K8S_NAMESPACE,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__KUBERNETES__K8S_NODE,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__KUBERNETES__K8S_POD,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__KUBERNETES__K8S_SERVICE,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__ALL_ENTITIES,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__APPLICATION,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__APPLICATION__A_CHECKED,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__APPLICATION__S_DISABLED,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__APPLICATION__S_ERROR,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__APPLICATION__S_OK,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__APPLICATION__S_WARNING,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__BROWSER,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__BROWSER__A_CHECKED,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__BROWSER__S_DISABLED,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__BROWSER__S_ERROR,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__BROWSER__S_OK,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__BROWSER__S_WARNING,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__CLOUD,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__CODE,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__CONTAINER,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__CONTROL_CENTER,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__CORRELATION,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__CORRELATION_REASONING,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__DATABASE,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__DATABASE__A_CHECKED,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__DATABASE__S_DISABLED,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__DATABASE__S_ERROR,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__DATABASE__S_OK,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__DATABASE__S_WARNING,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__DECISIONS,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__DESTINATIONS,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__DOWNSTREAM_CONNECTION,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__DOWNSTREAM_DEPLOYMENT,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__EVENT,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__FEED,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__LIVE_VIEW,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__LOGS,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__MOBILE_APPLICATION,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__MOBILE_APPLICATION__A_CHECKED,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__MOBILE_APPLICATION__S_DISABLED,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__MOBILE_APPLICATION__S_ERROR,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__MOBILE_APPLICATION__S_OK,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__MOBILE_APPLICATION__S_WARNING,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__MONITORING,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__NODE,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__OVERVIEW,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__PATHWAY,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__PLUGIN,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__PLUGIN__A_CHECKED,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__PLUGIN__S_DISABLED,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__PLUGIN__S_ERROR,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__PLUGIN__S_OK,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__PLUGIN__S_WARNING,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__QUERY,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__SERVICE,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__SERVICE__A_CHECKED,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__SERVICE__S_DISABLED,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__SERVICE__S_ERROR,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__SERVICE__S_OK,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__SERVICE__S_WARNING,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__SOURCES,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__STACK_TRACE,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__SYNTHESIZED_ENTITY,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__SYNTHETICS_MONITOR,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__SYSTEM,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__TRAFFIC,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__UPSTREAM_CONNECTION,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__UPSTREAM_DEPLOYMENT,
Button.ICON_TYPE.HARDWARE_AND_SOFTWARE__SOFTWARE__WORKLOADS,
Button.ICON_TYPE.INTERFACE__ARROW__ARROW_BOTTOM,
Button.ICON_TYPE.INTERFACE__ARROW__ARROW_BOTTOM__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__ARROW__ARROW_DIAGONAL_BOTTOM_LEFT,
Button.ICON_TYPE.INTERFACE__ARROW__ARROW_DIAGONAL_BOTTOM_RIGHT,
Button.ICON_TYPE.INTERFACE__ARROW__ARROW_DIAGONAL_TOP_LEFT,
Button.ICON_TYPE.INTERFACE__ARROW__ARROW_DIAGONAL_TOP_RIGHT,
Button.ICON_TYPE.INTERFACE__ARROW__ARROW_HORIZONTAL,
Button.ICON_TYPE.INTERFACE__ARROW__ARROW_LEFT,
Button.ICON_TYPE.INTERFACE__ARROW__ARROW_LEFT__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__ARROW__ARROW_RIGHT,
Button.ICON_TYPE.INTERFACE__ARROW__ARROW_RIGHT__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__ARROW__ARROW_TOP,
Button.ICON_TYPE.INTERFACE__ARROW__ARROW_TOP__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__ARROW__ARROW_VERTICAL,
Button.ICON_TYPE.INTERFACE__ARROW__EXPAND,
Button.ICON_TYPE.INTERFACE__ARROW__GO_TO,
Button.ICON_TYPE.INTERFACE__ARROW__MOVE,
Button.ICON_TYPE.INTERFACE__ARROW__RESIZE,
Button.ICON_TYPE.INTERFACE__ARROW__RETURN_LEFT,
Button.ICON_TYPE.INTERFACE__ARROW__RETURN_RIGHT,
Button.ICON_TYPE.INTERFACE__ARROW__SHRINK,
Button.ICON_TYPE.INTERFACE__ARROW__SORT,
Button.ICON_TYPE.INTERFACE__CARET__CARET_BOTTOM,
Button.ICON_TYPE.INTERFACE__CARET__CARET_BOTTOM__SIZE_8,
Button.ICON_TYPE.INTERFACE__CARET__CARET_BOTTOM__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__CARET__CARET_BOTTOM__WEIGHT_BOLD,
Button.ICON_TYPE.INTERFACE__CARET__CARET_BOTTOM__WEIGHT_BOLD__SIZE_8,
Button.ICON_TYPE.INTERFACE__CARET__CARET_LEFT,
Button.ICON_TYPE.INTERFACE__CARET__CARET_LEFT__SIZE_8,
Button.ICON_TYPE.INTERFACE__CARET__CARET_LEFT__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__CARET__CARET_LEFT__WEIGHT_BOLD,
Button.ICON_TYPE.INTERFACE__CARET__CARET_LEFT__WEIGHT_BOLD__SIZE_8,
Button.ICON_TYPE.INTERFACE__CARET__CARET_RIGHT,
Button.ICON_TYPE.INTERFACE__CARET__CARET_RIGHT__SIZE_8,
Button.ICON_TYPE.INTERFACE__CARET__CARET_RIGHT__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__CARET__CARET_RIGHT__WEIGHT_BOLD,
Button.ICON_TYPE.INTERFACE__CARET__CARET_RIGHT__WEIGHT_BOLD__SIZE_8,
Button.ICON_TYPE.INTERFACE__CARET__CARET_TOP,
Button.ICON_TYPE.INTERFACE__CARET__CARET_TOP__SIZE_8,
Button.ICON_TYPE.INTERFACE__CARET__CARET_TOP__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__CARET__CARET_TOP__WEIGHT_BOLD,
Button.ICON_TYPE.INTERFACE__CARET__CARET_TOP__WEIGHT_BOLD__SIZE_8,
Button.ICON_TYPE.INTERFACE__CHEVRON__CHEVRON_BOTTOM,
Button.ICON_TYPE.INTERFACE__CHEVRON__CHEVRON_BOTTOM__SIZE_8,
Button.ICON_TYPE.INTERFACE__CHEVRON__CHEVRON_BOTTOM__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__CHEVRON__CHEVRON_BOTTOM__WEIGHT_BOLD,
Button.ICON_TYPE.INTERFACE__CHEVRON__CHEVRON_BOTTOM__WEIGHT_BOLD__SIZE_8,
Button.ICON_TYPE.INTERFACE__CHEVRON__CHEVRON_LEFT,
Button.ICON_TYPE.INTERFACE__CHEVRON__CHEVRON_LEFT__SIZE_8,
Button.ICON_TYPE.INTERFACE__CHEVRON__CHEVRON_LEFT__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__CHEVRON__CHEVRON_LEFT__WEIGHT_BOLD,
Button.ICON_TYPE.INTERFACE__CHEVRON__CHEVRON_LEFT__WEIGHT_BOLD__SIZE_8,
Button.ICON_TYPE.INTERFACE__CHEVRON__CHEVRON_RIGHT,
Button.ICON_TYPE.INTERFACE__CHEVRON__CHEVRON_RIGHT__SIZE_8,
Button.ICON_TYPE.INTERFACE__CHEVRON__CHEVRON_RIGHT__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__CHEVRON__CHEVRON_RIGHT__WEIGHT_BOLD,
Button.ICON_TYPE.INTERFACE__CHEVRON__CHEVRON_RIGHT__WEIGHT_BOLD__SIZE_8,
Button.ICON_TYPE.INTERFACE__CHEVRON__CHEVRON_TOP,
Button.ICON_TYPE.INTERFACE__CHEVRON__CHEVRON_TOP__SIZE_8,
Button.ICON_TYPE.INTERFACE__CHEVRON__CHEVRON_TOP__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__CHEVRON__CHEVRON_TOP__WEIGHT_BOLD,
Button.ICON_TYPE.INTERFACE__CHEVRON__CHEVRON_TOP__WEIGHT_BOLD__SIZE_8,
Button.ICON_TYPE.INTERFACE__INFO__ANNOUNCEMENT,
Button.ICON_TYPE.INTERFACE__INFO__HELP,
Button.ICON_TYPE.INTERFACE__INFO__INFO,
Button.ICON_TYPE.INTERFACE__OPERATIONS__ADJUST,
Button.ICON_TYPE.INTERFACE__OPERATIONS__ALERT,
Button.ICON_TYPE.INTERFACE__OPERATIONS__ALERT__A_REMOVE,
Button.ICON_TYPE.INTERFACE__OPERATIONS__ALERT__S_OFF,
Button.ICON_TYPE.INTERFACE__OPERATIONS__ALERT__S_ON,
Button.ICON_TYPE.INTERFACE__OPERATIONS__ARCHIVE,
Button.ICON_TYPE.INTERFACE__OPERATIONS__CENTER,
Button.ICON_TYPE.INTERFACE__OPERATIONS__CLOSE,
Button.ICON_TYPE.INTERFACE__OPERATIONS__CLOSE__SIZE_8,
Button.ICON_TYPE.INTERFACE__OPERATIONS__CLOSE__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__OPERATIONS__CONFIGURE,
Button.ICON_TYPE.INTERFACE__OPERATIONS__COPY_TO,
Button.ICON_TYPE.INTERFACE__OPERATIONS__COPY_TO_CLIPBOARD,
Button.ICON_TYPE.INTERFACE__OPERATIONS__DOWNLOAD,
Button.ICON_TYPE.INTERFACE__OPERATIONS__DRAG,
Button.ICON_TYPE.INTERFACE__OPERATIONS__EDIT,
Button.ICON_TYPE.INTERFACE__OPERATIONS__EXPORT,
Button.ICON_TYPE.INTERFACE__OPERATIONS__EXTERNAL_LINK,
Button.ICON_TYPE.INTERFACE__OPERATIONS__FILTER,
Button.ICON_TYPE.INTERFACE__OPERATIONS__FILTER__A_ADD,
Button.ICON_TYPE.INTERFACE__OPERATIONS__FILTER__A_REMOVE,
Button.ICON_TYPE.INTERFACE__OPERATIONS__FILTER__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__OPERATIONS__FOLLOW,
Button.ICON_TYPE.INTERFACE__OPERATIONS__GROUP,
Button.ICON_TYPE.INTERFACE__OPERATIONS__GROUP__A_REMOVE,
Button.ICON_TYPE.INTERFACE__OPERATIONS__GROUP__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__OPERATIONS__HIDE,
Button.ICON_TYPE.INTERFACE__OPERATIONS__HIDE_OTHERS,
Button.ICON_TYPE.INTERFACE__OPERATIONS__HIGHLIGHT,
Button.ICON_TYPE.INTERFACE__OPERATIONS__IMPORT,
Button.ICON_TYPE.INTERFACE__OPERATIONS__MORE,
Button.ICON_TYPE.INTERFACE__OPERATIONS__PAUSE,
Button.ICON_TYPE.INTERFACE__OPERATIONS__PAUSE_ALTERNATE__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__OPERATIONS__PIN,
Button.ICON_TYPE.INTERFACE__OPERATIONS__PLAY,
Button.ICON_TYPE.INTERFACE__OPERATIONS__PLAY_ALTERNATE__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__OPERATIONS__REARRANGE,
Button.ICON_TYPE.INTERFACE__OPERATIONS__REDO,
Button.ICON_TYPE.INTERFACE__OPERATIONS__REFRESH,
Button.ICON_TYPE.INTERFACE__OPERATIONS__REMOVE__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__OPERATIONS__SEARCH,
Button.ICON_TYPE.INTERFACE__OPERATIONS__SEARCH__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__OPERATIONS__SELECTION,
Button.ICON_TYPE.INTERFACE__OPERATIONS__SELECTION__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__OPERATIONS__SHARE,
Button.ICON_TYPE.INTERFACE__OPERATIONS__SHARE_LINK,
Button.ICON_TYPE.INTERFACE__OPERATIONS__SHOW,
Button.ICON_TYPE.INTERFACE__OPERATIONS__TAG,
Button.ICON_TYPE.INTERFACE__OPERATIONS__TRASH,
Button.ICON_TYPE.INTERFACE__OPERATIONS__TV_MODE,
Button.ICON_TYPE.INTERFACE__OPERATIONS__TV_MODE__A_TV_MODE,
Button.ICON_TYPE.INTERFACE__OPERATIONS__UNDO,
Button.ICON_TYPE.INTERFACE__OPERATIONS__UNPIN,
Button.ICON_TYPE.INTERFACE__OPERATIONS__UPLOAD,
Button.ICON_TYPE.INTERFACE__PLACEHOLDERS__CUSTOM_PLACEHOLDER,
Button.ICON_TYPE.INTERFACE__PLACEHOLDERS__ICON_PLACEHOLDER,
Button.ICON_TYPE.INTERFACE__SIGN__ASTERISK,
Button.ICON_TYPE.INTERFACE__SIGN__CHECKMARK,
Button.ICON_TYPE.INTERFACE__SIGN__CHECKMARK__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__SIGN__CLOSE,
Button.ICON_TYPE.INTERFACE__SIGN__DOLLAR_SIGN,
Button.ICON_TYPE.INTERFACE__SIGN__EXCLAMATION,
Button.ICON_TYPE.INTERFACE__SIGN__EXCLAMATION__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__SIGN__MINUS,
Button.ICON_TYPE.INTERFACE__SIGN__MINUS__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__SIGN__NUMBER,
Button.ICON_TYPE.INTERFACE__SIGN__PLUS,
Button.ICON_TYPE.INTERFACE__SIGN__PLUS__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__SIGN__TIMES,
Button.ICON_TYPE.INTERFACE__SIGN__TIMES__SIZE_8,
Button.ICON_TYPE.INTERFACE__SIGN__TIMES__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__STATE__CLOSED,
Button.ICON_TYPE.INTERFACE__STATE__CRITICAL,
Button.ICON_TYPE.INTERFACE__STATE__DISABLED,
Button.ICON_TYPE.INTERFACE__STATE__ENABLED,
Button.ICON_TYPE.INTERFACE__STATE__HEALTHY,
Button.ICON_TYPE.INTERFACE__STATE__LOADING,
Button.ICON_TYPE.INTERFACE__STATE__LOCK,
Button.ICON_TYPE.INTERFACE__STATE__OPEN,
Button.ICON_TYPE.INTERFACE__STATE__PRIVATE,
Button.ICON_TYPE.INTERFACE__STATE__PUBLIC,
Button.ICON_TYPE.INTERFACE__STATE__UNAVAILABLE,
Button.ICON_TYPE.INTERFACE__STATE__UNLOCK,
Button.ICON_TYPE.INTERFACE__STATE__WARNING,
Button.ICON_TYPE.INTERFACE__VIEW__ENTER_FULL_SCREEN,
Button.ICON_TYPE.INTERFACE__VIEW__EXIT_FULL_SCREEN,
Button.ICON_TYPE.INTERFACE__VIEW__GRID_VIEW,
Button.ICON_TYPE.INTERFACE__VIEW__HIGH_DENSITY_VIEW,
Button.ICON_TYPE.INTERFACE__VIEW__LAYER_LIST,
Button.ICON_TYPE.INTERFACE__VIEW__LIST_VIEW,
Button.ICON_TYPE.INTERFACE__VIEW__SIXTH_SENSE,
Button.ICON_TYPE.INTERFACE__VIEW__THEME_TOGGLE,
Button.ICON_TYPE.INTERFACE__VIEW__THEME_TOGGLE__S_DARK,
Button.ICON_TYPE.INTERFACE__VIEW__THEME_TOGGLE__S_LIGHT,
Button.ICON_TYPE.LOCATION__LOCATION__HOME,
Button.ICON_TYPE.LOCATION__LOCATION__MAP,
Button.ICON_TYPE.LOCATION__LOCATION__PIN,
Button.ICON_TYPE.LOCATION__LOCATION__WORLD,
Button.ICON_TYPE.PROFILES__EVENTS__COMMENT,
Button.ICON_TYPE.PROFILES__EVENTS__COMMENT__A_EDIT,
Button.ICON_TYPE.PROFILES__EVENTS__FAVORITE,
Button.ICON_TYPE.PROFILES__EVENTS__FAVORITE__WEIGHT_BOLD,
Button.ICON_TYPE.PROFILES__EVENTS__LIKE,
Button.ICON_TYPE.PROFILES__USERS__ORGANIZATION,
Button.ICON_TYPE.PROFILES__USERS__ORGANIZATION__A_ADD,
Button.ICON_TYPE.PROFILES__USERS__ORGANIZATION__A_EDIT,
Button.ICON_TYPE.PROFILES__USERS__ORGANIZATION__A_REMOVE,
Button.ICON_TYPE.PROFILES__USERS__TEAM,
Button.ICON_TYPE.PROFILES__USERS__TEAM__A_ADD,
Button.ICON_TYPE.PROFILES__USERS__TEAM__A_EDIT,
Button.ICON_TYPE.PROFILES__USERS__TEAM__A_REMOVE,
Button.ICON_TYPE.PROFILES__USERS__USER,
Button.ICON_TYPE.PROFILES__USERS__USER__A_ADD,
Button.ICON_TYPE.PROFILES__USERS__USER__A_EDIT,
Button.ICON_TYPE.PROFILES__USERS__USER__A_REMOVE,
>
loadingboolean
DEFAULT
false

To indicate whether an action is in progress, especially in the case that it takes more than 1 second to complete, you should display the loading state.

onClickfunction

Callback fired any time the user clicks on the button.

function (
event: Event
) => undefined
sizeTypeenum
DEFAULT
Button.SIZE_TYPE.MEDIUM

We recommend you use the normal size button in almost all instances.

Use the slim button sparingly as it diminishes the importance of the button. Do not use it solely to fit into a space, but consider increasing the space around a default button.

The few cases to use a large button are in marketing-like material for your add-on: introducing it in a splash page or in a hero message.

<One of
Button.SIZE_TYPE.LARGE,
Button.SIZE_TYPE.MEDIUM,
Button.SIZE_TYPE.SMALL,
>
spacingTypeenum[]

Spacing property. Spacing is defined as a tuple of zero to four values, which follow the same conventions as CSS properties like margin or padding. To omit a value, use SPACING_TYPE.OMIT.

<Array of
<One of
Button.SPACING_TYPE.EXTRA_LARGE,
Button.SPACING_TYPE.LARGE,
Button.SPACING_TYPE.MEDIUM,
Button.SPACING_TYPE.NONE,
Button.SPACING_TYPE.OMIT,
Button.SPACING_TYPE.SMALL,
>
>
styleobject

Inline style for custom styling.

Should be used only for positioning and spacing purposes.

testIdstring

Adds a data-test-id.

Used to target the component in unit and e2e testing.

toshape|string

Location object or url string to link to.

shape

pathnamerequiredstring
searchstring
hashstring
typeenum
DEFAULT
Button.TYPE.NORMAL

Type can be:

  • Primary — use to call attention to one specific action you want the user to take as a next step.

  • Default (used as secondary) — use when multiple actions need to be displayed.

  • Outline — use for important actions that are not the main (primary) action of a given view. This variation sits in between the primary and default buttons in terms of hierarchy.

  • Plain — use when multiple actions need to be available that are less important for the user to take.

  • Destructive — use when you have a destructive action like delete or remove, which you would like the user to pause and consider before completing.

<One of
Button.TYPE.DESTRUCTIVE,
Button.TYPE.NORMAL,
Button.TYPE.OUTLINE,
Button.TYPE.PLAIN,
Button.TYPE.PLAIN_NEUTRAL,
Button.TYPE.PRIMARY,
>

Methods

Button.render

function () => undefined
Create issueEdit page
Copyright © 2021 New Relic Inc.