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

RadioGroupAPI

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

範例

匯入

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

閱讀此指南,了解關於最小化 bundle size 的差異。

Props

FormGroup 元件的 props 也可使用。

名稱類型描述
childrennode

元件的內容。

defaultValueany

預設值。在元件不受控制時使用。

namestring

用於參考控制項值的名稱。如果您未提供此 prop,則會回退為隨機產生的名稱。

onChangefunc

選取單選按鈕時觸發的回呼函式。

簽名:function(event: React.ChangeEvent<htmlinputelement>, value: string) => void
  • event 回呼的事件來源。
  • value 選取的單選按鈕的值。您可以透過存取 event.target.value (字串) 來取出新值。
valueany

選取的單選按鈕的值。DOM API 會將其轉換為字串。

ref 會轉發到根元素。

繼承

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

CSS 類別

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

類別名稱規則名稱描述
.Mui-error如果 error={true},則套用至根元素的狀態類別。
.MuiRadioGroup-rootroot套用至根元素的樣式。
.MuiRadioGroup-rowrow如果 row={true},則套用至根元素的樣式。

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

  • 使用全域類別名稱。
  • 在自訂主題中使用規則名稱作為元件 styleOverrides 屬性的一部分。

原始碼

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