在Material-UI中实现带全选/取消全选功能的复选框多选组件

import React from 'react';
import { Checkbox, InputLabel, ListItemIcon, ListItemText, MenuItem, FormControl, Select } from '@material-ui/core';
import { MenuProps, useStyles } from './multiSelectWithCheckboxUtil';

/**
 * 自定义多选下拉框组件，支持全选/取消全选功能及动态标签显示。
 *
 * @param {object} props - 组件属性
 * @param {string} props.label - 下拉框的标签文本
 * @param {Array<string>} props.options - 可供选择的选项列表
 * @param {Array<string>} props.value - 当前选中的值数组
 * @param {(value: Array<string>) => void} props.onChange - 值改变时的回调函数
 */
function MultiSelectWithCheckbox(props) {
    const classes = useStyles(); // 获取样式
    // 判断是否所有选项都被选中
    const isAllSelected = props.options.length > 0 && props.value.length === props.options.length;

    /**
     * 处理选择项变化的函数。
     * 使用 useCallback 优化性能，避免不必要的重新渲染。
     */
    const handleChange = React.useCallback(event => {
        const value = event.target.value;
        // 检查是否点击了“全选/取消全选”选项
        if (value.length > 0 && value[value.length - 1] === 'all') {
            // 如果当前已全选，则清空所有选择；否则，选中所有选项。
            props.onChange(props.value.length === props.options.length ? [] : props.options);
            return;
        }
        // 处理普通选项的选择
        props.onChange(value);
    }, [props.value, props.options]); // 依赖项包括 props.value 和 props.options，确保函数始终使用最新的状态

    return (
        <FormControl className={classes.formControl}>
            <InputLabel id='mutiple-select-label' style={{ fontSize: 18 }}>{props.label}</InputLabel>
            <Select
                labelId='mutiple-select-label'
                multiple // 启用多选模式
                value={props.value}
                onChange={handleChange}
                // 自定义选中项的显示方式，这里将选中的值用逗号连接
                renderValue={React.useCallback(selected => selected.join(', '), [])}
                MenuProps={MenuProps} // 应用自定义菜单属性
            >
                {/* “全选/取消全选”选项 */}
                <MenuItem
                    value='all'
                    classes={{
                        root: isAllSelected ? classes.selectedAll : '', // 应用全选状态下的样式
                    }}
                >
                    <ListItemIcon>
                        <Checkbox
                            classes={{
                                indeterminate: classes.indeterminateColor, // 设置不确定状态的颜色
                            }}
                            checked={isAllSelected} // 复选框是否选中取决于是否全选
                            // 不确定状态：选中了部分选项但未全选
                            indeterminate={props.value.length > 0 && props.value.length < props.options.length}
                        />
                    </ListItemIcon>
                    <ListItemText
                        classes={{ primary: classes.selectAllText }}
                        // 核心逻辑：根据 isAllSelected 动态显示“取消全选”或“全选”
                        primary={isAllSelected ? 'Uncheck all' : 'Check all'}
                    />
                </MenuItem>
                {/* 遍历并渲染所有普通选项 */}
                {props.options.map(option => (
                    <MenuItem key={option} value={option}>
                        <ListItemIcon>
                            {/* 判断当前选项是否被选中 */}
                            <Checkbox checked={props.value.indexOf(option) > -1} />
                        </ListItemIcon>
                        <ListItemText primary={option} />
                    </MenuItem>
                ))}
            </Select>
        </FormControl>
    );
}

export default MultiSelectWithCheckbox;

import { makeStyles } from '@material-ui/core/styles';

// 定义组件样式
const useStyles = makeStyles(theme => ({
    formControl: {
        width: '100%' // 使表单控件宽度占满父容器
    },
    indeterminateColor: {
        color: '#f50057' // 不确定状态复选框的颜色
    },
    selectAllText: {
        fontWeight: 500 // “全选/取消全选”文本的字体粗细
    },
    selectedAll: {
        '&:hover': {
            backgroundColor: 'rgba(0, 0, 0, 0.08)' // 全选状态下鼠标悬停时的背景色
        },
        backgroundColor: 'rgba(0, 0, 0, 0.08)' // 全选状态下的背景色
    }
}));

// 定义下拉菜单的属性
const ITEM_HEIGHT = 48; // 每个菜单项的高度
const ITEM_PADDING_TOP = 8; // 菜单项的顶部内边距
const MenuProps = {
    anchorOrigin: {
        horizontal: 'center',
        vertical: 'bottom' // 下拉菜单的锚点位置（相对于Select组件）
    },
    getContentAnchorEl: null, // 禁用内容锚点，使菜单直接依附于 anchorOrigin
    PaperProps: {
        style: {
            maxHeight: ITEM_HEIGHT * 4.5 + ITEM_PADDING_TOP, // 设置菜单的最大高度，显示约4.5个菜单项
        }
    },
    transformOrigin: {
        horizontal: 'center',
        vertical: 'top' // 下拉菜单的变换原点
    },
    variant: 'menu' // 菜单变体
};

export { useStyles, MenuProps };

import React, { useState } from 'react';
import MultiSelectWithCheckbox from './MultiSelectWithCheckbox'; // 确保路径正确

function App() {
    const options = ['苹果', '香蕉', '橙子', '葡萄', '西瓜', '草莓'];
    const [selectedFruits, setSelectedFruits] = useState([]);

    return (
        <div style={{ padding: 20, maxWidth: 400, margin: '50px auto' }}>
            <h1>水果选择器</h1>
            <MultiSelectWithCheckbox
                label="选择你喜欢的水果"
                options={options}
                value={selectedFruits}
                onChange={setSelectedFruits}
            />
            <p style={{ marginTop: 20 }}>
                当前选择: {selectedFruits.length > 0 ? selectedFruits.join(', ') : '无'}
            </p>
        </div>
    );
}

export default App;