QKnob 组件用于通过鼠标/触摸平移从用户那里获取数字输入。它基于 QCircularProgress 并继承其所有属性和行为。
用法
默认情况下,QKnob 继承当前文本颜色(作为弧形进度颜色和内部标签颜色)和当前字体大小(作为组件大小)。对于自定义,您可以使用与大小和颜色相关的属性。
基础
显示值
在下面的示例中,show-value 属性也启用了默认插槽,因此您可以填充自定义内容,比如 QAvatar 或 QTooltip。font-size 属性指的是内部标签的字体大小。
最小值和最大值
内部最小/最大值 v2.5.4+
有时您需要将模型值限制在轨道长度的内部区间内。为此,请使用 inner-min 和 inner-max 属性。第一个属性需要大于或等于 min 属性,而后者需要小于或等于 max 属性。
自定义步长
偏移角度
禁用和只读
原生表单提交
当处理一个带有 action 和 method 的原生表单时(如:使用 Quasar 和 ASP.NET 控制器时),您需要为 QKnob 声明 name 属性,否则表单数据中不会包含它:
无障碍访问 v2.25+
QKnob 遵循 WAI-ARIA 滑块模式:可聚焦元素自身带有 role="slider" 以及 aria-valuemin/aria-valuemax/aria-valuenow,在不可编辑时还带有 aria-disabled 或 aria-readonly。方向键 可步进调整值,PageUp / PageDown 可跳跃 10 步。默认没有无障碍名称,请传入 aria-label 属性(它会落在滑块元素上)来告诉屏幕阅读器用户该旋钮控制什么。