• Log inStart now

Button

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 to indicate whether the element the Button controls is expanded or not.

Recommended to also check ariaControls and ariaHasPopup examples.

ariaHasPopupboolean|string
DEFAULT
false

Use it to indicate that the Button toggles an interactive overlay element.

The value can be:

  • false (default) indicates the element does not have a popup.
  • true indicates the popup has a menu role
  • "menu" indicates the popup has a menu role
  • "listbox" indicates the popup has a listbox role
  • "tree" indicates the popup has a tree role
  • "grid" indicates the popup has a grid role
  • "dialog" indicates the popup has a dialog role

Read WAI ARIA specifications for this attribute to know which one suits better for your use case.

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__BILLBOARD_CHART,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__BULLET_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__EVENT_FEED_CHART,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__HEATMAP_CHART,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__LINE_CHART,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__MARKDOWN,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__PIE_CHART,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__SCATTER_CHART,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__SERVICE_MAP_CHART,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__STACKED_BAR_CHART,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__STACKED_HORIZONTAL_BAR_CHART,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__TABLE_CHART,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__TRAFFIC_LIGHTS_CHART,
Button.ICON_TYPE.DATAVIZ__DATAVIZ__VERTICAL_BAR_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__TRACES,
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_BOTTOM__V_ALTERNATE__WEIGHT_BOLD,
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_LEFT__V_ALTERNATE__WEIGHT_BOLD,
Button.ICON_TYPE.INTERFACE__ARROW__ARROW_RIGHT,
Button.ICON_TYPE.INTERFACE__ARROW__ARROW_RIGHT__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__ARROW__ARROW_RIGHT__V_ALTERNATE__WEIGHT_BOLD,
Button.ICON_TYPE.INTERFACE__ARROW__ARROW_TOP,
Button.ICON_TYPE.INTERFACE__ARROW__ARROW_TOP__V_ALTERNATE,
Button.ICON_TYPE.INTERFACE__ARROW__ARROW_TOP__V_ALTERNATE__WEIGHT_BOLD,
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__INFO__INFO__WEIGHT_BOLD,
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__REPLY__A_REPLY,
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__SKIP_BACK,
Button.ICON_TYPE.INTERFACE__OPERATIONS__SKIP_FORWARD,
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__CHECKMARK__V_ALTERNATE__WEIGHT_BOLD,
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__CRITICAL__WEIGHT_BOLD,
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__STATE__WARNING__WEIGHT_BOLD,
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: React.MouseEvent
)
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 attribute. Use it to target the component in unit and E2E tests.

For a test id to be valid, prefix it with your nerdpack id, followed up by a dot.

For example, my-nerdpack.some-element.

Note: You might not see data-test-id attributes as they are removed from the DOM, to debug them pass a e2e-test query parameter to the URL.

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.

  • Normal (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,
>
Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.