Skip to content

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';
You can learn about the difference by reading this guide on minimizing bundle size.

The foundation for building custom-styled buttons.

Props

Props of the native component are also available.

NameTypeDefaultDescription
actionfunc
| { current?: { focusVisible: func } }
A ref for imperative actions. It currently only supports focusVisible() action.
componentelementType
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?: func
| object }
{}
The props used for each slot inside the Button.
disabledboolfalse
If true, the component is disabled.
focusableWhenDisabledboolfalse
If true, allows a disabled button to receive focus.

The ref is forwarded to the root element.

Demos