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 中创建一个从 valmin 到 valmax 的滑块。为了使滑块保持响应,必须保留对它的引用。调用
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文档。