Radio Group 是 Material UI 提供的一种组件，用于在一组选项中进行单选。它符合 Material Design 的标准，提供了一种直观的方式来选择单一的选项。在本文中，我们将详细探讨 Material UI 中 Radio Group 的使用，包括其属性、方法、结合其他组件的示例等。

1. 安装 Material UI

如果您还没有安装 Material UI，可以通过以下命令进行安装：

npm install @mui/material @emotion/react @emotion/styled

2. 基本用法

2.1 基本示例

以下是一个简单的示例，展示如何使用 Radio Group 组件：

import React, { useState } from 'react';
import { RadioGroup, FormControlLabel, Radio, FormLabel } from '@mui/material';

function BasicRadioGroup() {
    const [value, setValue] = useState('option1');

    const handleChange = (event) => {
        setValue(event.target.value);
    };

    return (
        <RadioGroup value={value} onChange={handleChange}>
            <FormLabel component="legend">选择一个选项</FormLabel>
            <FormControlLabel value="option1" control={<Radio />} label="选项 1" />
            <FormControlLabel value="option2" control={<Radio />} label="选项 2" />
            <FormControlLabel value="option3" control={<Radio />} label="选项 3" />
        </RadioGroup>
    );
}

export default BasicRadioGroup;

代码解析

• RadioGroup: 用于包裹一组单选按钮。value 属性绑定当前选中的值，onChange 处理选择变化。
• FormLabel: 用于为 RadioGroup 提供一个标题。
• FormControlLabel: 用于包裹每一个 Radio 组件，提供 label 和 control。

3. Radio Group 属性

3.1 常用属性

• value: 当前选中的值。
• onChange: 选项改变时触发的事件处理函数。
• name: 使得一组单选按钮互斥的名称。
• row: 布尔值，决定选项是水平排列还是垂直排列。

3.2 示例：水平排列的 Radio Group

import React, { useState } from 'react';
import { RadioGroup, FormControlLabel, Radio, FormLabel } from '@mui/material';

function HorizontalRadioGroup() {
    const [value, setValue] = useState('option1');

    const handleChange = (event) => {
        setValue(event.target.value);
    };

    return (
        <RadioGroup value={value} onChange={handleChange} row>
            <FormLabel component="legend">选择一个选项</FormLabel>
            <FormControlLabel value="option1" control={<Radio />} label="选项 1" />
            <FormControlLabel value="option2" control={<Radio />} label="选项 2" />
            <FormControlLabel value="option3" control={<Radio />} label="选项 3" />
        </RadioGroup>
    );
}

export default HorizontalRadioGroup;

代码解析

• 通过设置 row 属性使得 Radio Group 的选项水平排列，适合空间较小的场景。

4. 结合其他组件使用

4.1 结合 FormControl 使用

FormControl 是一个容器，可以为 Radio Group 提供更多功能，比如禁用、错误状态等。

import React, { useState } from 'react';
import { FormControl, FormLabel, RadioGroup, FormControlLabel, Radio, FormHelperText } from '@mui/material';

function ControlledRadioGroup() {
    const [value, setValue] = useState('option1');
    const [error, setError] = useState(false);

    const handleChange = (event) => {
        setValue(event.target.value);
        setError(false); // 选择时重置错误状态
    };

    const handleSubmit = () => {
        if (!value) {
            setError(true);
        }
    };

    return (
        <FormControl component="fieldset" error={error}>
            <FormLabel component="legend">选择一个选项</FormLabel>
            <RadioGroup value={value} onChange={handleChange}>
                <FormControlLabel value="option1" control={<Radio />} label="选项 1" />
                <FormControlLabel value="option2" control={<Radio />} label="选项 2" />
                <FormControlLabel value="option3" control={<Radio />} label="选项 3" />
            </RadioGroup>
            {error && <FormHelperText>必须选择一个选项</FormHelperText>}
            <button onClick={handleSubmit}>提交</button>
        </FormControl>
    );
}

export default ControlledRadioGroup;

代码解析

• FormControl: 用于包裹 Radio Group，可以控制状态如 error。
• FormHelperText: 用于显示辅助信息，提示用户选择。

4.2 结合 Dialog 使用

Radio Group 也可以用于 Dialog 组件中，让用户选择选项。

import React, { useState } from 'react';
import { Fab, Dialog, DialogTitle, DialogContent, DialogActions, Button, RadioGroup, FormControlLabel, Radio } from '@mui/material';
import AddIcon from '@mui/icons-material/Add';

function RadioGroupInDialog() {
    const [open, setOpen] = useState(false);
    const [value, setValue] = useState('option1');

    const handleClickOpen = () => {
        setOpen(true);
    };

    const handleClose = () => {
        setOpen(false);
    };

    const handleChange = (event) => {
        setValue(event.target.value);
    };

    return (
        <div>
            <Fab color="primary" onClick={handleClickOpen}>
                <AddIcon />
            </Fab>
            <Dialog open={open} onClose={handleClose}>
                <DialogTitle>选择选项</DialogTitle>
                <DialogContent>
                    <RadioGroup value={value} onChange={handleChange}>
                        <FormControlLabel value="option1" control={<Radio />} label="选项 1" />
                        <FormControlLabel value="option2" control={<Radio />} label="选项 2" />
                        <FormControlLabel value="option3" control={<Radio />} label="选项 3" />
                    </RadioGroup>
                </DialogContent>
                <DialogActions>
                    <Button onClick={handleClose} color="primary">取消</Button>
                    <Button onClick={handleClose} color="primary">确定</Button>
                </DialogActions>
            </Dialog>
        </div>
    );
}

export default RadioGroupInDialog;

代码解析

• 在 Dialog 中包含 Radio Group，用户可以在弹窗中进行选择。

5. 自定义样式

您可以使用 Material UI 的 sx 属性来自定义 Radio 组件的样式。

import React, { useState } from 'react';
import { RadioGroup, FormControlLabel, Radio, FormLabel } from '@mui/material';

function StyledRadioGroup() {
    const [value, setValue] = useState('option1');

    const handleChange = (event) => {
        setValue(event.target.value);
    };

    return (
        <RadioGroup value={value} onChange={handleChange}>
            <FormLabel component="legend">选择一个选项</FormLabel>
            <FormControlLabel 
                value="option1" 
                control={<Radio sx={{ color: 'green', '&.Mui-checked': { color: 'darkgreen' } }} />} 
                label="选项 1" 
            />
            <FormControlLabel 
                value="option2" 
                control={<Radio sx={{ color: 'blue', '&.Mui-checked': { color: 'darkblue' } }} />} 
                label="选项 2" 
            />
            <FormControlLabel 
                value="option3" 
                control={<Radio sx={{ color: 'red', '&.Mui-checked': { color: 'darkred' } }} />} 
                label="选项 3" 
            />
        </RadioGroup>
    );
}

export default StyledRadioGroup;

代码解析

• 使用 sx 属性自定义每个 Radio 的颜色，允许您根据需求改变样式。

6. 小结

在本文中，我们详细探讨了 Material UI 中 Radio Group 的使用，包括基本用法、属性、与其他组件结合的示例等。通过这些示例，您可以清晰地了解如何在项目中实现 Radio Group，并根据需要进行自定义。

希望这篇文章对您理解和使用 Material UI 的 Radio Group 有所帮助。如果您有任何疑问或想了解更多内容，请随时与我交流！