jQuery UI 滑块

17 Mar 2025 | 5 分钟阅读

jQuery UI 滑块用于在特定范围内获取数值。 滑块优于文本输入的主要优点是用户不可能输入无效值。 他们可以使用滑块选择的每个值都是有效的。

语法

您可以使用两种形式的滑块 () 方法

第一种方法

slider (options) 方法指定应将 HTML 元素作为滑块进行管理。 此处 options 参数是一个对象,用于指定滑块的外观和行为。

您可以使用 JavaScript 对象一次使用一个或多个选项。 如果有多个选项,则必须使用逗号分隔它们,如下所示

以下是可以与此方法一起使用的不同选项的列表。

选项描述
animate如果将此选项设置为 true,则当用户直接单击轴时,它会创建一个动画效果。 默认情况下,其值为 false。
disabled如果将此选项设置为 true,则禁用滑块。 默认情况下,其值为 false。
max此选项用于指定滑块可以达到的范围的上限?当手柄移动到最右侧(对于水平滑块)或顶部(对于垂直滑块)时表示的值。 默认情况下,其值为 100。
min此选项用于指定滑块可以达到的范围的下限?当手柄移动到最左侧(对于水平滑块)或底部(对于垂直滑块)时表示的值。 默认情况下,其值为 0。
orientation此选项指定滑块的水平或垂直方向。 默认情况下,其值为水平。
range此选项指示滑块是否表示一个范围。 默认情况下,其值为 false。
step此选项用于指定滑块允许表示的最小值和最大值之间的离散间隔。 默认情况下,其值为 1。
此选项用于指定单手柄滑块的初始值。 对于多个手柄(请参阅 values 选项),它指定第一个手柄的值。 默认情况下,其值为 1。
values此选项的类型为数组,会导致创建多个手柄并指定这些手柄的初始值。 此选项应为可能值的数组,每个手柄一个。 默认情况下,其值为 null。

jQueryUI slider() 示例 1

让我们举一个简单的例子来演示滑块功能,无需将任何参数传递给 slider() 方法。

立即测试

jQueryUI slider() 示例 2

value、animate 和 orientation 的用法

让我们举一个例子来演示 jQueryUI 的滑块函数中选项 value、animate 和 orientation 的用法。

立即测试

jQueryUI slider() 示例 3

range、min、max 和 values 的用法

以下示例演示了 jQueryUI 的滑块函数中选项 range、min、max 和 values 的用法。

立即测试

第二种方法

slider ("action", params) 方法指定对滑块的操作,例如将光标移动到新位置。 此操作在第一个参数中指定为字符串(例如,“value”表示光标的新值)。 查看可以传递的操作,如下表所示。

以下是可与此方法一起使用的不同操作的列表

操作描述
destroy此操作用于完全销毁元素的滑块功能。 元素返回到其初始化前的状态。 此方法不接受任何参数。
disable此操作用于禁用滑块功能。 此方法不接受任何参数。
enable此操作用于启用滑块功能。 此方法不接受任何参数。
option( optionName )此操作用于检索指定 param 选项的值。 此选项对应于与 slider (options) 一起使用的选项之一。 此处 optionName 是要获取的选项的名称。
option(选项)此操作获取一个包含表示当前滑块选项哈希的键/值对的对象。
option( optionName, value )此操作设置与指定 optionName 关联的滑块选项的值。 参数 optionName 是要设置的选项的名称,value 是要为该选项设置的值。
option(options)此操作为一个滑块设置一个或多个选项。 参数 options 是要设置的选项-值对的映射。
此操作用于检索 options.value(滑块)的当前值。 仅当滑块是唯一的时才使用它(如果不是,请使用 slider ("values"))。 此签名不接受任何参数。
value(value)此操作用于设置滑块的值。
values此操作检索 options.values(数组中滑块的值)的当前值。 此签名不接受任何参数。
values(index)此操作获取指定手柄的值。 此处 index 的类型为整数,是手柄的从零开始的索引。
values( index, value )此操作设置指定手柄的值。 此处 index 是手柄的从零开始的索引,value 是要设置的值。
values(values)此操作为所有手柄设置值。
widget此操作返回包含滑块的 jQuery 对象。 此方法不接受任何参数。

jQueryUI slider() 示例 4

让我们举一个例子来演示上表中的操作。 在此示例中,我们使用 disable () 和 value () 方法。

立即测试
下一个主题jQuery UI 微调器