📜  jQWidgets jqxScrollBar 完整参考(1)

📅  最后修改于: 2023-12-03 15:02:20.870000             🧑  作者: Mango

jQWidgets jqxScrollBar 完整参考

jQWidgets jqxScrollBar是一个用于创建滚动条的jQuery插件。它支持水平和垂直滚动条,并具有很多自定义选项,可以让你轻松地配置和使用滚动条。

特点
  • 支持水平和垂直滚动条
  • 可以自定义滚动条的宽度、高度、最大值、最小值、步长等
  • 具有多种事件,可以通过事件来自定义滚动条的行为
  • 支持鼠标滚轮、键盘等多种交互方式
如何使用

首先,在HTML文件中引入jQuery和jQWidgets jqxScrollBar的CSS和JS文件。

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>jQWidgets jqxScrollBar Example</title>
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/jqwidgets/5.0.1/jqwidgets/styles/jqx.base.css">
    <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/jqwidgets/5.0.1/jqwidgets/jqxcore.js"></script>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/jqwidgets/5.0.1/jqwidgets/jqxbuttons.js"></script>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/jqwidgets/5.0.1/jqwidgets/jqxscrollbar.js"></script>
</head>
<body>
    <div id="container">
        <div id="content">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer ultrices velit elit, eu varius elit mollis sed. Praesent velit ipsum, auctor nec sapien vitae, dictum interdum neque. Donec ullamcorper lacus nec mauris porta, ac blandit odio sollicitudin. Mauris felis augue, feugiat eu ex vitae, dapibus dictum enim. Aenean placerat leo eget imperdiet suscipit. Sed eget orci consectetur, interdum sapien vel, consequat odio. Sed nec mollis neque. Ut id sapien non orci viverra euismod. Aliquam nec dolor lacinia, auctor nulla sed, malesuada neque. Fusce id fringilla arcu. Mauris vitae rutrum nisi. Fusce auctor commodo neque. Fusce a ante massa.</div>
        <div id="vScrollBar"></div>
        <div id="hScrollBar"></div>
    </div>

    <script>
        // Create the vertical scrollbar
        $("#vScrollBar").jqxScrollBar({
            width: 10,
            height: 200,
            min: 0,
            max: 1000,
            step: 10,
            vertical: true
        });

        // Create the horizontal scrollbar
        $("#hScrollBar").jqxScrollBar({
            width: 200,
            height: 20,
            min: 0,
            max: 1000,
            step: 10
        });

        // Attach the vertical scrollbar to the content
        $("#content").jqxScrollView({
            verticalScrollBar: $("#vScrollBar")
        });

        // Attach the horizontal scrollbar to the content
        $("#content").jqxScrollView({
            horizontalScrollBar: $("#hScrollBar")
        });
    </script>
</body>
</html>

这个例子创建了一个容器,包含了一个长文本的内容和一个垂直和水平滚动条。当内容超过容器的大小时,可以通过滚动条来滚动内容。

支持的选项

以下是支持的选项及其默认值:

| 选项 | 默认值 | 描述 | |--------|--------|--------| | width | 'auto' | 滚动条的宽度 | | height | 'auto' | 滚动条的高度 | | min | 0 | 滚动条的最小值 | | max | 100 | 滚动条的最大值 | | value | 0 | 滚动条的初始值 | | step | 1 | 滚动条的步长 | | showButtons | true | 是否显示滚动条两端的按钮 | | thumbMinSize | 10 | 滚动条滑块的最小尺寸 | | vertical | false | 是否为垂直滚动条 | | disabled | false | 是否禁用滚动条 | | rtl | false | 是否为右到左的布局 | | touchMode | 'auto' | 触摸模式,可选值为'auto'、'scroll'或'none' |

支持的事件

以下是支持的事件:

| 事件名 | 描述 | |---------|---------| | valueChanged | 当滚动条的值发生改变时触发 | | scroll | 当滚动条滚动时触发 | | thumbBeginDrag | 当拖动滑块开始时触发 | | thumbEndDrag | 当拖动滑块结束时触发 |

内置方法

以下是常用的内置方法:

| 方法名 | 描述 | |---------|---------| | destroy | 销毁滚动条 | | val | 获取或设置滚动条的值 | | min | 获取或设置滚动条的最小值 | | max | 获取或设置滚动条的最大值 |

结束语

jQWidgets jqxScrollBar提供了丰富的API和事件,可以轻松地创建和自定义滚动条。它的文档和示例非常详细,可以帮助你更好地了解和使用它。