vue-gemini-scrollbar(vue组件-自定义滚动条)

vue-gemini-scrollbar

license
Travis
Vue 2.x

NPM

查看demojavascript

图片描述

介绍

无需配置横向或纵向滚动,自定义滚动条彻底按照原生的方式去显示(也就是若是区域存在纵向滚动条,使用它后将替换纵向滚动条)。正由于如此,请不要使用::-webkit-scrollbar来修饰原生滚动条,这样会影响对滚动条宽度的检测。css

  • 基于gemini-scrollbar封装的vue组件
  • 基于原生滚动的自定义滚动条
  • 支持IE9+

安装

npm i vue-gemini-scrollbar --save

如需script方式引入,请自行编译,build后在disk文件夹(vue-gemini-scrollbar.js)html

npm run build

Attributes

参数 类型 默认值 说明
autoCreate Boolean true 自动建立自定义滚动条
autoshow Boolean false hover时才显示滚动条
forceGemini Boolean false 原生滚动条可见的状况下,强制显示自定义滚动条(开发时会比较有用)
minThumbSize Number 20 滚动条最小长度

注意:
createElements参数在这里被强制置为false,不可配置,由于启用它可能会影响Vue的virtual DOM。vue

Events

事件名称 回调参数 说明
ready geminiScrollbar实例 GeminiScrollbar实例建立
resize - 滚动区域大小调整时触发

Methods

方法名称 说明
create 建立滚动区域
update 从新计算滚动区域大小(vue能够监听并触发组件updated的时候,都不须要你手动去调用它;可是像图片资源的load致使高度变化,你须要在合适的时候去手动调用;)
destroy 移除绑定事件及滚动条元素

如何调用:
监听ready事件,经过回调函数的参数geminiScrollbar实例来调用这些方法java

使用

安装组件react

import Vue from 'vue'
import GeminiScrollbar from 'vue-gemini-scrollbar'

Vue.use(GeminiScrollbar)

在模板中使用git

<GeminiScrollbar
    class="my-scroll-bar">
    content...
</GeminiScrollbar>

注意:只有内容溢出才会有滚动效果github

.my-scroll-bar{
    height:200px;
}

添加本身的滚动条样式web

/* override gemini-scrollbar default styles */

/* vertical scrollbar track */
.gm-scrollbar.-vertical {
  background-color: #f0f0f0
}

/* horizontal scrollbar track */
.gm-scrollbar.-horizontal {
  background-color: transparent;
}

/* scrollbar thumb */
.gm-scrollbar .thumb {
  background-color: rebeccapurple;
}
.gm-scrollbar .thumb:hover {
  background-color: fuchsia;
}

如何为body设置自定义滚动条

由于vue组件的根元素不能为body,此时能够从Vue.$geminiScrollbar访问到GeminiScrollbar对象,而后你就能够自由使用它了(文档请参考:gemini-scrollbar)。npm

html {
    height: 100%;
    /* or */
    height: 100vh;
}
var scrollbar = new Vue.$geminiScrollbar({
    element: document.body
}).create();

其余实现

相关文章
相关标签/搜索