Skip to content

NativeSelect API

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

Import

import NativeSelect from '@mui/material/NativeSelect';
// or
import { NativeSelect } from '@mui/material';
You can learn about the difference by reading this guide on minimizing bundle size.

An alternative to <Select native /> with a much smaller bundle size footprint.

Component name

The name MuiNativeSelect can be used when providing default props or style overrides in the theme.

Props

Props of the Input component are also available.

NameTypeDefaultDescription
childrennode
The option elements to populate the select with. Can be some <option> elements.
classesobject{}
Override or extend the styles applied to the component. See CSS API below for more details.
IconComponentelementTypeArrowDropDownIcon
The icon that displays the arrow.
inputelement<Input />
An Input element; does not have to be a material-ui specific Input.
inputPropsobject
Attributes applied to the select element.
onChangefunc
Callback fired when a menu item is selected.

Signature:
function(event: React.ChangeEvent<HTMLSelectElement>) => void
event: The event source of the callback. You can pull out the new value by accessing event.target.value (string).
sxfunc
| object
The system prop that allows defining system overrides as well as additional CSS styles. See the `sx` page for more details.
valueany
The input value. The DOM API casts this to a string.
variant'filled'
| 'outlined'
| 'standard'
The variant to use.

The ref is forwarded to the root element.

Inheritance

While not explicitly documented above, the props of the Input component are also available on NativeSelect. You can take advantage of this to target nested components.

CSS

Rule nameGlobal classDescription
root.MuiNativeSelect-rootStyles applied to the root element.
select.MuiNativeSelect-selectStyles applied to the select component `select` class.
filled.MuiNativeSelect-filledStyles applied to the select component if variant="filled".
outlined.MuiNativeSelect-outlinedStyles applied to the select component if variant="outlined".
standard.MuiNativeSelect-standardStyles applied to the select component if variant="standard".
disabled.Mui-disabledState class applied to the select component `disabled` class.
icon.MuiNativeSelect-iconStyles applied to the icon component.
iconOpen.MuiNativeSelect-iconOpenStyles applied to the icon component if the popup is open.
iconFilled.MuiNativeSelect-iconFilledStyles applied to the icon component if variant="filled".
iconOutlined.MuiNativeSelect-iconOutlinedStyles applied to the icon component if variant="outlined".
iconStandard.MuiNativeSelect-iconStandardStyles applied to the icon component if variant="standard".
nativeInput.MuiNativeSelect-nativeInputStyles applied to the underlying native input component.

You can override the style of the component using one of these customization options:

Demos