matplotlib.widgets.Slider#

class matplotlib.widgets.Slider(ax, label, valmin, valmax, *, valinit=0.5, valfmt=None, closedmin=True, closedmax=True, slidermin=None, slidermax=None, dragging=True, valstep=None, orientation='horizontal', initcolor='r', track_color='lightgrey', handle_style=None, **kwargs)[source]#

基类:SliderBase

表示浮点数范围的滑块。

在坐标轴 ax 中创建一个从 valminvalmax 的滑块。为了使滑块保持响应,必须保留对它的引用。调用 on_changed() 以连接到滑块事件。

属性:
val浮点数

滑块数值。

参数:
axAxes

放置滑块的坐标轴。

labelstr

滑块标签。

valminfloat

滑块的最小值。

valmaxfloat

滑块的最大值。

valinitfloat, 默认: 0.5

滑块的初始位置。

valfmtstr, 默认: None

滑块数值的格式化方式。如果是字符串,必须是 %-格式化字符串。如果是可调用对象,其签名为 valfmt(val: float) -> str。如果为 None,则使用 ScalarFormatter

closedminbool, 默认: True

滑块区间下限是否闭合。

closedmaxbool, 默认: True

滑块区间上限是否闭合。

sliderminSlider, 默认: None

不允许当前滑块的值小于 slidermin 滑块的值。

slidermaxSlider, 默认: None

不允许当前滑块的值大于 slidermax 滑块的值。

draggingbool, 默认: True

如果为 True,滑块可以通过鼠标拖动。

valstepfloat 或 array-like, 默认: None

如果为 float,滑块将吸附到 valstep 的倍数上。如果为数组,滑块将吸附到数组中的值。

orientation{'horizontal', 'vertical'},默认值: 'horizontal'

滑块的方向。

initcolorcolor, 默认: 'r'

valinit 位置线条的颜色。设为 'none' 表示无线条。

track_colorcolor, 默认: 'lightgrey'

背景轨道的颜色。可通过 track 属性对轨道进行进一步样式设置。

handle_styledict

滑块手柄的属性。默认值为

默认

描述

facecolor

color

'white'

滑块手柄的填充颜色。

edgecolor

color

'.75'

滑块手柄的边缘颜色。

size

int

10

滑块手柄的大小(以点为单位)。

其他值将被转换为 marker{foo} 并传递给 Line2D 构造函数。例如 handle_style = {'style'='x'} 将导致 markerstyle = 'x'

备注

额外的 kwargs 将被传递给 self.poly,即绘制滑块旋钮的 Rectangle。有关有效属性名称(facecolor, edgecolor, alpha 等),请参阅 Rectangle 文档。

on_changed(func)[source]#

func 连接为滑块数值变化时的回调函数。

参数:
funccallable

滑块变化时调用的函数。该函数必须接受一个 float 作为参数。

返回:
int

连接 ID(可用于断开 func)。

set_val(val)[source]#

将滑块数值设为 val

参数:
val浮点数

使用 matplotlib.widgets.Slider 的示例#

滑块

滑块

将滑块捕捉到离散值

将滑块捕捉到离散值