Skip to content

NativeSelect API

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

Component demos

Import

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

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

Props

Props of the Input component are also available.

children

The option elements to populate the select with. Can be some <option> elements.

Type:node

classes

Override or extend the styles applied to the component.

See CSS API below for more details.

Type:object

Default:{}

IconComponent

The icon that displays the arrow.

Type:elementType

Default:ArrowDropDownIcon

input

An Input element; does not have to be a material-ui specific Input.

Type:element

Default:<Input />

inputProps

Attributes applied to the select element.

Type:object

onChange

Callback fired when a menu item is selected.

Type:func

Signature:
function(event: React.ChangeEvent) => void
  • event The event source of the callback. You can pull out the new value by accessing event.target.value (string).
sx

The system prop that allows defining system overrides as well as additional CSS styles.

See the `sx` page for more details.

Type:Array<func
| object
| bool>
| func
| object

value

The input value. The DOM API casts this to a string.

Type:any

variant

The variant to use.

Type:'filled'
| 'outlined'
| 'standard'

The ref is forwarded to the root element.

Inheritance

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

Theme default props

You can use MuiNativeSelect to change the default props of this component with the theme.

CSS

The following class names are useful for styling with CSS (the state classes are marked).
To learn more, visit the component customization page.

.MuiNativeSelect-root

Styles applied to the root element.

Rule name:root

.MuiNativeSelect-select

Styles applied to the select component select class.

Rule name:select

.MuiNativeSelect-multiple

Styles applied to the select component if multiple={true}.

Rule name:multiple

.MuiNativeSelect-filled

Styles applied to the select component if variant="filled".

Rule name:filled

.MuiNativeSelect-outlined

Styles applied to the select component if variant="outlined".

Rule name:outlined

.MuiNativeSelect-standard

Styles applied to the select component if variant="standard".

Rule name:standard

.Mui-disabledSTATE

State class applied to the select component disabled class.

Rule name:disabled

.MuiNativeSelect-icon

Styles applied to the icon component.

Rule name:icon

.MuiNativeSelect-iconOpen

Styles applied to the icon component if the popup is open.

Rule name:iconOpen

.MuiNativeSelect-iconFilled

Styles applied to the icon component if variant="filled".

Rule name:iconFilled

.MuiNativeSelect-iconOutlined

Styles applied to the icon component if variant="outlined".

Rule name:iconOutlined

.MuiNativeSelect-iconStandard

Styles applied to the icon component if variant="standard".

Rule name:iconStandard

.MuiNativeSelect-nativeInput

Styles applied to the underlying native input component.

Rule name:nativeInput

.Mui-errorSTATE

State class applied to the select component error class.

Rule name:error


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