jQuery UI API - 滑块部件(Slider Widget)


所属类别

小部件(Widgets)

用法

描述:拖动手柄来选择一个数值。

版本新增:1.5

jQuery UI 滑块(Slider)插件允许通过滑块进行选择。有各种不同的选项,比如多个手柄和范围。手柄可通过鼠标或箭头按键进行移动。

滑块部件(Slider Widget)会在初始化时创建带有 class ui-slider-handle 的手柄元素。您可以通过在初始化之前创建并追加元素,同时向元素添加 ui-slider-handle class 来指定自定义的手柄元素。它只会创建匹配 value/values 长度所需的数量的手柄。例如,如果您指定 values: [ 1, 5, 18 ],且创建一个自定义手柄,插件将创建其他两个。

主题化

滑块部件(Slider Widget)使用 jQuery UI CSS 框架 来定义它的外观和感观的样式。如果需要使用滑块指定的样式,则可以使用下面的 CSS class 名称:

  • ui-slider:滑块控件的轨道。该元素会根据滑块的 orientation 另外带有一个 ui-slider-horizontalui-slider-vertical class。
    • ui-slider-handle:滑块手柄。
    • ui-slider-range:当设置 range 选项时使用的已选范围。如果 range 选项设置为 "min""max",则该元素会分别另外带有一个 ui-slider-range-minui-slider-range-max class。

依赖

  • UI 核心(UI Core)
  • 部件库(Widget Factory)
  • 鼠标交互(Mouse Interaction)

附加说明

  • 该部件要求一些功能性的 CSS,否则将无法工作。如果您创建了一个自定义的主题,请使用小部件指定的 CSS 文件作为起点。

实例

一个简单的 jQuery UI 滑块(Slider)。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>滑块部件(Slider Widget)演示</title>
  <link rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css">
  <style>#slider { margin: 10px; }	</style>
  <script src="//code.jquery.com/jquery-1.10.2.js"></script>
  <script src="//code.jquery.com/ui/1.10.4/jquery-ui.js"></script>
</head>
<body>
 
<div id="slider"></div>
 
<script>
$( "#slider" ).slider();
</script>
 
</body>
</html>