ButtonUnstyled API

API reference docs for the React ButtonUnstyled component. Learn about the props, CSS, and other APIs of this exported module.

Demos

For examples and details on the usage of this React component, visit the component demo pages:

import ButtonUnstyled from '@mui/base/ButtonUnstyled';
// or
import { ButtonUnstyled } from '@mui/base';

The foundation for building custom-styled buttons.

Props of the native component are also available.

Name	Type	Default	Description
action	func \| { current?: { focusVisible: func } }		A ref for imperative actions. It currently only supports `focusVisible()` action.
component	elementType		The component used for the root node. Either a string to use a HTML element or a component.
disabled	bool	false	If `true`, the component is disabled.
focusableWhenDisabled	bool	false	If `true`, allows a disabled button to receive focus.
slotProps	{ root?: func \| object }	{}	The props used for each slot inside the Button.
slots	{ root?: elementType }	{}	The components used for each slot inside the Button. Either a string to use a HTML element or a component. See Slots API below for more details.

The ref is forwarded to the root element.

Name	Default class	Default value	Description
root	.MuiButton-root	props.href \|\| props.to ? 'a' : 'button'	The component used to render the root.