跳到主要內容跳到主要內容

NativeSelectAPI

React NativeSelect 元件的 API 參考文件。瞭解此匯出模組的 props、CSS 和其他 API。

示範

匯入

import NativeSelect from '@mui/material/NativeSelect';
// or
import { NativeSelect } from '@mui/material';

若要瞭解差異,請閱讀這份關於最小化套件大小的指南



<Select native /> 的替代方案,套件大小佔用空間更小。

Props

Input 元件的 props 也可使用。

名稱類型預設值描述
childrennode-

用於填充選取器的選項元素。可以是某些 <option> 元素。

classesobject{}

覆寫或擴充套用至元件的樣式。

請參閱下方CSS 類別 API 以取得更多詳細資訊。

IconComponentelementTypeArrowDropDownIcon

顯示箭頭的圖示。

inputelement<Input />

Input 元素;不一定要是 material-ui 特定的 Input

inputPropsobject-

屬性 套用至 select 元素。

onChangefunc-

選取選單項目時觸發的回呼。

簽名:function(event: React.ChangeEvent) => void
  • event 回呼的事件來源。您可以透過存取 event.target.value (字串) 來提取新值。
sxArray<func
| object
| bool>
| func
| object
-

系統屬性,允許定義系統覆寫以及額外的 CSS 樣式。

請參閱 `sx` 頁面 以取得更多詳細資訊。

valueany-

input 值。DOM API 將其轉換為字串。

variant'filled'
| 'outlined'
| 'standard'
-

要使用的變體。

ref 會轉發到根元素。

繼承

雖然上方未明確記錄,但 Input 元件的 props 也可在 NativeSelect 中使用。您可以利用此優勢來鎖定巢狀元件

主題預設 props

您可以使用 MuiNativeSelect透過主題變更此元件的預設 props。

CSS 類別

這些類別名稱對於使用 CSS 設定樣式很有用。它們會在觸發特定狀態時套用至元件的插槽。

類別名稱規則名稱描述
.Mui-disabled狀態類別,套用至選取元件的 disabled 類別。
.Mui-error狀態類別,套用至選取元件的 error 類別。
.MuiNativeSelect-filledfilled如果 variant="filled",則套用至選取元件的樣式。
.MuiNativeSelect-iconicon套用至圖示元件的樣式。
.MuiNativeSelect-iconFillediconFilled如果 variant="filled",則套用至圖示元件的樣式。
.MuiNativeSelect-iconOpeniconOpen如果彈出視窗開啟,則套用至圖示元件的樣式。
.MuiNativeSelect-iconOutlinediconOutlined如果 variant="outlined",則套用至圖示元件的樣式。
.MuiNativeSelect-iconStandardiconStandard如果 variant="standard",則套用至圖示元件的樣式。
.MuiNativeSelect-multiplemultiple如果 multiple={true},則套用至選取元件的樣式。
.MuiNativeSelect-nativeInputnativeInput套用至底層原生輸入元件的樣式。
.MuiNativeSelect-outlinedoutlined如果 variant="outlined",則套用至選取元件的樣式。
.MuiNativeSelect-rootroot套用至根元素的樣式。
.MuiNativeSelect-selectselect套用至選取元件 select 類別的樣式。
.MuiNativeSelect-standardstandard如果 variant="standard",則套用至選取元件的樣式。

您可以使用以下其中一種自訂選項來覆寫元件的樣式

原始碼

如果您在本頁中找不到資訊,請考慮查看元件的實作以取得更多詳細資訊。