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/core/ButtonUnstyled';
// or
import { ButtonUnstyled } from '@mui/core';
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'button'
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.
disabledboolfalse
If true, the component is disabled.

The ref is forwarded to the root element.

Demos