Material UI 中 Radio Group 的使用详解

person  smartzeng    watch_later 2024-09-29 22:07:48
visibility 168    class Radio Group    bookmark 专栏

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 有所帮助。如果您有任何疑问或想了解更多内容,请随时与我交流!

chat评论区
评论列表
menu