Matarialize中文技术社区-Material UI 中 Slider 组件的使用详解

Material UI 中 Slider 组件的使用详解

smartzeng 2024-09-30 22:28:37

4 Slider 专栏

Material UI 的 Slider 组件是一个非常实用的控件，用于选择范围值或单一值。本文将详细介绍 Slider 组件的使用，包括基本用法、属性、方法，以及与其他组件结合的示例。

1. 安装 Material UI

如果您尚未安装 Material UI，可以通过以下命令进行安装：

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

2. 基本用法

2.1 简单 Slider 示例

以下是一个基本的 Slider 示例：

import React from 'react';
import { Slider, Typography } from '@mui/material';

function SimpleSlider() {
    const [value, setValue] = React.useState(30);

    const handleChange = (event, newValue) => {
        setValue(newValue);
    };

    return (
        <div>
            <Typography gutterBottom>简单滑块</Typography>
            <Slider
                value={value}
                onChange={handleChange}
                aria-labelledby="continuous-slider"
            />
            <Typography>当前值: {value}</Typography>
        </div>
    );
}

export default SimpleSlider;

代码解析

Slider: 主要的滑块组件，value 为当前值，onChange 处理值的变化。
Typography: 用于展示文本信息。

3. Slider 属性

3.1 常用属性

value: 当前 Slider 的值。
onChange: 值变化时的回调函数，接收两个参数：事件和新的值。
min: Slider 的最小值，默认为 0。
max: Slider 的最大值，默认为 100。
step: 每次滑动的增量，默认为 1。
defaultValue: Slider 的初始值。
disabled: 布尔值，设置为 true 使 Slider 不可用。
valueLabelDisplay: 设置是否显示当前值的标签，值可以为 on, auto, off。

3.2 示例：自定义范围和步长

以下是一个设置最小值、最大值和步长的 Slider 示例：

import React from 'react';
import { Slider, Typography } from '@mui/material';

function CustomRangeSlider() {
    const [value, setValue] = React.useState([20, 50]);

    const handleChange = (event, newValue) => {
        setValue(newValue);
    };

    return (
        <div>
            <Typography gutterBottom>范围滑块</Typography>
            <Slider
                value={value}
                onChange={handleChange}
                valueLabelDisplay="auto"
                min={0}
                max={100}
                step={5}
            />
            <Typography>当前范围: {value[0]} - {value[1]}</Typography>
        </div>
    );
}

export default CustomRangeSlider;

代码解析

value: 使用数组表示当前选择的范围。
min 和 max: 分别设置 Slider 的最小值和最大值。
step: 设置步长为 5，表示每次滑动增加 5。

4. 结合其他组件使用

4.1 结合 FormControl 和 FormHelperText

将 Slider 组件与 FormControl 和 FormHelperText 结合，提供更好的用户体验。

import React from 'react';
import { Slider, FormControl, FormHelperText, Typography } from '@mui/material';

function SliderWithValidation() {
    const [value, setValue] = React.useState(50);
    const [error, setError] = React.useState(false);

    const handleChange = (event, newValue) => {
        setValue(newValue);
        if (newValue < 30) {
            setError(true);
        } else {
            setError(false);
        }
    };

    return (
        <FormControl fullWidth error={error}>
            <Typography gutterBottom>滑块验证</Typography>
            <Slider
                value={value}
                onChange={handleChange}
                min={0}
                max={100}
                valueLabelDisplay="auto"
            />
            {error && <FormHelperText>值必须大于等于 30</FormHelperText>}
        </FormControl>
    );
}

export default SliderWithValidation;

代码解析

error: 控制 FormControl 的错误状态，并在值小于 30 时显示错误信息。

4.2 结合 Dialog 使用

将 Slider 组件放入 Dialog 中，允许用户在弹窗中进行选择。

import React, { useState } from 'react';
import { Button, Dialog, DialogTitle, DialogContent, DialogActions, Slider, Typography } from '@mui/material';

function SliderInDialog() {
    const [open, setOpen] = useState(false);
    const [value, setValue] = useState(50);

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

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

    return (
        <div>
            <Button variant="outlined" onClick={handleClickOpen}>
                打开滑块
            </Button>
            <Dialog open={open} onClose={handleClose}>
                <DialogTitle>选择值</DialogTitle>
                <DialogContent>
                    <Typography gutterBottom>请使用滑块选择值</Typography>
                    <Slider
                        value={value}
                        onChange={(event, newValue) => setValue(newValue)}
                        min={0}
                        max={100}
                        valueLabelDisplay="auto"
                    />
                    <Typography>当前值: {value}</Typography>
                </DialogContent>
                <DialogActions>
                    <Button onClick={handleClose} color="primary">取消</Button>
                    <Button onClick={handleClose} color="primary">提交</Button>
                </DialogActions>
            </Dialog>
        </div>
    );
}

export default SliderInDialog;

代码解析

通过 Dialog 组件，用户可以在弹窗中进行选择，增强交互性。

5. 自定义样式

5.1 使用 `sx` 属性

您可以使用 sx 属性来自定义 Slider 的样式。

import React from 'react';
import { Slider, Typography } from '@mui/material';

function StyledSlider() {
    const [value, setValue] = React.useState(30);

    return (
        <div>
            <Typography gutterBottom>自定义样式滑块</Typography>
            <Slider
                value={value}
                onChange={(event, newValue) => setValue(newValue)}
                sx={{
                    color: 'purple',
                    height: 8,
                    '& .MuiSlider-thumb': {
                        height: 24,
                        width: 24,
                        backgroundColor: 'white',
                        border: '2px solid purple',
                    },
                    '& .MuiSlider-track': {
                        borderRadius: 4,
                    },
                }}
            />
            <Typography>当前值: {value}</Typography>
        </div>
    );
}

export default StyledSlider;