ButtonUnstyled API

API documentation for the React ButtonUnstyled component. Learn about the available props and the CSS API.

Import

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 slot. Either a string to use a HTML element or a component. This is equivalent to `components.Root`. If both are provided, the `component` is used.
components	{ Root?: elementType }	{}	The components used for each slot inside the Button. Either a string to use a HTML element or a component.
componentsProps	{ root?: object }	{}	The props used for each slot inside the Button.
disabled	bool	false	If `true`, the component is disabled.
focusableWhenDisabled	bool	false	If `true`, allows a disabled button to receive focus.

The ref is forwarded to the root element.