Skip to page content

旋钮

QKnob 组件用于通过鼠标/触摸平移从用户那里获取数字输入。它基于 QCircularProgress 并继承其所有属性和行为。

用法

默认情况下,QKnob 继承当前文本颜色(作为弧形进度颜色和内部标签颜色)和当前字体大小(作为组件大小)。对于自定义,您可以使用与大小和颜色相关的属性。

基础

基础



显示值

在下面的示例中,show-value 属性也启用了默认插槽,因此您可以填充自定义内容,比如 QAvatar 或 QTooltip。font-size 属性指的是内部标签的字体大小。

最小值和最大值

内部最小/最大值
v2.5.4+

有时您需要将模型值限制在轨道长度的内部区间内。为此,请使用 inner-mininner-max 属性。第一个属性需要大于或等于 min 属性,而后者需要小于或等于 max 属性。

自定义步长

偏移角度

禁用和只读

原生表单提交

当处理一个带有 actionmethod 的原生表单时(如:使用 Quasar 和 ASP.NET 控制器时),您需要为 QKnob 声明 name 属性,否则表单数据中不会包含它:

无障碍访问
v2.25+

QKnob 遵循 WAI-ARIA 滑块模式:可聚焦元素自身带有 role="slider" 以及 aria-valuemin/aria-valuemax/aria-valuenow,在不可编辑时还带有 aria-disabledaria-readonly方向键 可步进调整值,PageUp / PageDown 可跳跃 10 步。默认没有无障碍名称,请传入 aria-label 属性(它会落在滑块元素上)来告诉屏幕阅读器用户该旋钮控制什么。