
构建一个支持全选/全不选功能的material-ui多选组件,其核心在于以下几点:
该组件主要由multiSelectWithCheckbox.js和multiSelectWithCheckboxUtil.js两个文件构成。
MultiSelectWithCheckbox是一个功能组件,它接收label、options(所有可选项目)和value(当前选中项目)以及onChange回调作为props。
import React from 'react';
import { Checkbox, InputLabel, ListItemIcon, ListItemText, MenuItem, FormControl, Select } from '@material-ui/core';
import { MenuProps, useStyles } from './multiSelectWithCheckboxUtil';
function MultiSelectWithCheckbox(props) {
const classes = useStyles();
// 判断是否所有选项都被选中
const isAllSelected = props.options.length > 0 && props.value.length === props.options.length;
// 处理选择变化的函数
const handleChange = React.useCallback(event => {
const value = event.target.value;
// 如果选择的是“all”选项
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.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} // 复选框是否选中(全选状态)
// 判断是否部分选中(已选大于0且小于总数)
indeterminate={props.value.length > 0 && props.value.length < props.options.length}
/>
</ListItemIcon>
<ListItemText
classes={{ primary: classes.selectAllText }}
// 关键:根据isAllSelected动态显示“Uncheck all”或“Check all”
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;代码解析:
该文件定义了组件所需的Material-UI样式和Select组件的MenuProps。
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'
},
getContentAnchorEl: null,
PaperProps: {
style: {
maxHeight: ITEM_HEIGHT * 4.5 + ITEM_PADDING_TOP, // 限制菜单最大高度
}
},
transformOrigin: {
horizontal: 'center',
vertical: 'top'
},
variant: 'menu'
};
export { useStyles, MenuProps };代码解析:
在父组件中,你可以像使用任何其他受控组件一样使用MultiSelectWithCheckbox。
import React, { useState } from 'react';
import MultiSelectWithCheckbox from './MultiSelectWithCheckbox'; // 假设文件路径正确
function App() {
const allOptions = ['Option 1', 'Option 2', 'Option 3', 'Option 4', 'Option 5'];
const [selectedValues, setSelectedValues] = useState([]);
const handleSelectionChange = (newValues) => {
setSelectedValues(newValues);
};
return (
<div style={{ padding: 20, maxWidth: 400, margin: 'auto' }}>
<h1>多选组件示例</h1>
<MultiSelectWithCheckbox
label="选择你的偏好"
options={allOptions}
value={selectedValues}
onChange={handleSelectionChange}
/>
<p>当前选中: {selectedValues.join(', ') || '无'}</p>
</div>
);
}
export default App;通过以上实现,我们成功构建了一个功能强大且用户友好的Material-UI复选框多选组件,它不仅满足了基本的选择需求,还通过智能的全选/全不选逻辑和动态标签提供了更佳的交互体验。
以上就是在Material-UI中实现带全选/全不选功能的复选框多选组件的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号