百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术文章 > 正文

轻量级 React.js 虚拟美化滚动条组件RScroll

zhezhongyun 2025-04-02 00:28 63 浏览

前几天有给大家分享一个Vue自定义滚动条组件VScroll。今天再分享一个最新开发的React PC端模拟滚动条组件RScroll

vue+pc桌面端模拟滚动条组件VScroll

rscroll 一款基于react.js构建的超小巧自定义桌面端美化滚动条。支持原生滚动条、自动隐藏、滚动条尺寸/层级/颜色等功能。

如上图:支持垂直/水平滚动条。

功能及效果和之前VScroll保持一致。在开发支持参考借鉴了el-scrollbar等组件设计思想。

调用非常简单,只需包裹住内容即可快速生成一个漂亮的滚动条。

引入组件

// 引入滚动条组件RScroll
import RScroll from './components/rscroll'

快速使用


    
    

这里是内容信息!这里是内容信息!这里是内容信息!

这里是内容信息!这里是内容信息!这里是内容信息!

这里是内容信息!这里是内容信息!这里是内容信息!

这里是内容信息!这里是内容信息!这里是内容信息!

编码实现

在components目录下新建rscroll目录,并创建index.js页面。

rscroll滚动条模板

render() {
    return (
        
this.$ref__box = el} onMouseEnter={this.handleMouseEnter} onMouseLeave={this.handleMouseLeave}>
this.$ref__wrap = el} onScroll={this.handleScroll}>
{prop.children}
{/* 滚动条 */}
this.$ref__barY = el} onMouseDown={this.handleDragThumb.bind(this, 0)} style={{background: prop.color, height: opt.barHeight+'px'}}>
this.$ref__barX = el} onMouseDown={this.handleDragThumb.bind(this, 1)} style={{background: prop.color, width: opt.barWidth+'px'}}>
) }

react监听元素/DOM尺寸变化。由于react不像vue可以自定义指令directives,只能使用componentDidUpdate来监听。

componentDidUpdate(preProps, preState) {
    // 监听内层view DOM尺寸变化
    let $view = this.$ref__wrap.querySelector('.vscroll__view')
    const viewStyle = $view.currentStyle ? $view.currentStyle : document.defaultView.getComputedStyle($view, null);
    if(preState.$viewWidth !== viewStyle.width || preState.$viewHeight !== viewStyle.height) {
        this.setState({ $viewWidth: viewStyle.width, $viewHeight: viewStyle.height })
        this.updated()
    }
}
/**
 * ReactJs|Next.js自定义滚动条组件RScroll
 */
import React from 'react'

class RScroll extends React.Component {
    /**
     * 默认配置
     */
    static defaultProps = {
        // 是否显示原生滚动条
        native: false,
        // 鼠标滑出是否自动隐藏滚动条
        autohide: false,
        // 自定义滚动条大小
        size: '',
        // 自定义滚动条颜色
        color: '',
        // 滚动条层级
        zIndex: null
    }

    constructor(props) {
        super(props)
        this.state = {
            barWidth: 0,                    // 滚动条宽度
            barHeight: 0,                   // 滚动条高度
            ratioX: 1,                      // 滚动条水平偏移率
            ratioY: 1,                      // 滚动条垂直偏移率
            isTaped: false,                 // 鼠标光标是否按住滚动条
            isHover: false,                 // 鼠标光标是否悬停在滚动区
            isShow: !this.props.autohide,   // 是否显示滚动条

            $viewWidth: null,
            $viewHeight: null,
        }
    }

    // 鼠标滑入
    handleMouseEnter = () => {
        this.setState({
            isHover: true, isShow: true
        })
        this.updated()
    }

    // 鼠标滑出
    handleMouseLeave = () => {
        const { isTaped } = this.state
        this.setState({ isHover: false })
        this.setState({ isShow: false })
    }

    // 拖动滚动条
    handleDragThumb = (index, e) => {
        let _this = this
        this.setState({ isTaped: true })

        const { ratioX, ratioY } = this.state
        let c = {}
        // 阻止默认事件
        domUtils.isIE() ? (e.returnValue = false, e.cancelBubble = true) : (e.stopPropagation(), e.preventDefault())
        document.onselectstart = () => false

        if(index == 0) {
            c.dragY = true
            c.clientY = e.clientY
        }else {
            c.dragX = true
            c.clientX = e.clientX
        }

        domUtils.on(document, 'mousemove', function(evt) {
            if(_this.state.isTaped) {
                if(c.dragY) {
                    _this.$ref__wrap.scrollTop += (evt.clientY - c.clientY) * ratioY
                    _this.$ref__barY.style.transform = `translateY(${_this.$ref__wrap.scrollTop / ratioY}px)`
                }
                if(c.dragX) {
                    _this.$ref__wrap.scrollLeft += (evt.clientX - c.clientX) * ratioX
                    _this.$ref__barX.style.transform = `translateX(${_this.$ref__wrap.scrollLeft / ratioX})`
                }
            }
        })
        domUtils.on(document, 'mouseup', function() {
            _this.setState({ isTaped: false })
            document.onmouseup = null
            document.onselectstart = null
            if(!_this.state.isHover && _this.props.autohide) {
                _this.setState({ isShow: false })
            }
        })
    }

    // 点击滚动槽
    handleClickTrack = (index, e) => {
        // ...
    }

    // 更新滚动区
    updated = () => {
        if(this.props.native) return
        let c = {}
        let barSize = domUtils.getScrollBarSize()

        // 垂直滚动条
        if(this.$ref__wrap.scrollHeight > this.$ref__wrap.offsetHeight) {
            c.barHeight = this.$ref__box.offsetHeight **2 / this.$ref__wrap.scrollHeight
            c.ratioY = (this.$ref__wrap.scrollHeight - this.$ref__box.offsetHeight) / (this.$ref__box.offsetHeight - c.barHeight)
            this.$ref__barY.style.transform = `translateY(${this.$ref__wrap.scrollTop / c.ratioY}px)`
            // 隐藏系统滚动条
            if(barSize) {
                this.$ref__wrap.style.marginRight = -barSize + 'px'
            }
        }else {
            c.barHeight = 0
            this.$ref__barY.style.transform = ''
            this.$ref__wrap.style.marginRight = ''
        }

        // 水平滚动条
        ...
    }

    // 鼠标滚动
    handleScroll = (e) => {
        const { onScroll } = this.props
        typeof onScroll === 'function' && onScroll.call(this, e)
        this.updated()
    }

    render() {
        return (
            // ...
        )
    }
}

export default RScroll


    
    

这里是内容信息!这里是内容信息!这里是内容信息!

// 监听滚动事件 handleScroll = (e) => { let _scrollTop = e.target.scrollTop let _scrollStatus // 判断滚动状态 if(e.target.scrollTop == 0) { _scrollStatus = '滚到至顶部' } else if(e.target.scrollTop + e.target.offsetHeight >= e.target.scrollHeight) { _scrollStatus = '滚动至底部' }else { _scrollStatus = '正滚动中..' } this.setState({ scrollTop: _scrollTop, scrollStatus: _scrollStatus }) }

好了,以上就是基于react.js开发自定义美化滚动条组件。希望大家能喜欢~~

相关推荐

Python入门学习记录之一:变量_python怎么用变量

写这个,主要是对自己学习python知识的一个总结,也是加深自己的印象。变量(英文:variable),也叫标识符。在python中,变量的命名规则有以下三点:>变量名只能包含字母、数字和下划线...

python变量命名规则——来自小白的总结

python是一个动态编译类编程语言,所以程序在运行前不需要如C语言的先行编译动作,因此也只有在程序运行过程中才能发现程序的问题。基于此,python的变量就有一定的命名规范。python作为当前热门...

Python入门学习教程:第 2 章 变量与数据类型

2.1什么是变量?在编程中,变量就像一个存放数据的容器,它可以存储各种信息,并且这些信息可以被读取和修改。想象一下,变量就如同我们生活中的盒子,你可以把东西放进去,也可以随时拿出来看看,甚至可以换成...

绘制学术论文中的“三线表”具体指导

在科研过程中,大家用到最多的可能就是“三线表”。“三线表”,一般主要由三条横线构成,当然在变量名栏里也可以拆分单元格,出现更多的线。更重要的是,“三线表”也是一种数据记录规范,以“三线表”形式记录的数...

Python基础语法知识--变量和数据类型

学习Python中的变量和数据类型至关重要,因为它们构成了Python编程的基石。以下是帮助您了解Python中的变量和数据类型的分步指南:1.变量:变量在Python中用于存储数据值。它们充...

一文搞懂 Python 中的所有标点符号

反引号`无任何作用。传说Python3中它被移除是因为和单引号字符'太相似。波浪号~(按位取反符号)~被称为取反或补码运算符。它放在我们想要取反的对象前面。如果放在一个整数n...

Python变量类型和运算符_python中变量的含义

别再被小名词坑哭了:Python新手常犯的那些隐蔽错误,我用同事的真实bug拆给你看我记得有一次和同事张姐一起追查一个看似随机崩溃的脚本,最后发现罪魁祸首竟然是她把变量命名成了list。说实话...

从零开始:深入剖析 Spring Boot3 中配置文件的加载顺序

在当今的互联网软件开发领域,SpringBoot无疑是最为热门和广泛应用的框架之一。它以其强大的功能、便捷的开发体验,极大地提升了开发效率,成为众多开发者构建Web应用程序的首选。而在Spr...

Python中下划线 ‘_’ 的用法,你知道几种

Python中下划线()是一个有特殊含义和用途的符号,它可以用来表示以下几种情况:1在解释器中,下划线(_)表示上一个表达式的值,可以用来进行快速计算或测试。例如:>>>2+...

解锁Shell编程:变量_shell $变量

引言:开启Shell编程大门Shell作为用户与Linux内核之间的桥梁,为我们提供了强大的命令行交互方式。它不仅能执行简单的文件操作、进程管理,还能通过编写脚本实现复杂的自动化任务。无论是...

一文学会Python的变量命名规则!_python的变量命名有哪些要求

目录1.变量的命名原则3.内置函数尽量不要做变量4.删除变量和垃圾回收机制5.结语1.变量的命名原则①由英文字母、_(下划线)、或中文开头②变量名称只能由英文字母、数字、下画线或中文字所组成。③英文字...

更可靠的Rust-语法篇-区分语句/表达式,略览if/loop/while/for

src/main.rs://函数定义fnadd(a:i32,b:i32)->i32{a+b//末尾表达式}fnmain(){leta:i3...

C++第五课:变量的命名规则_c++中变量的命名规则

变量的命名不是想怎么起就怎么起的,而是有一套固定的规则的。具体规则:1.名字要合法:变量名必须是由字母、数字或下划线组成。例如:a,a1,a_1。2.开头不能是数字。例如:可以a1,但不能起1a。3....

Rust编程-核心篇-不安全编程_rust安全性

Unsafe的必要性Rust的所有权系统和类型系统为我们提供了强大的安全保障,但在某些情况下,我们需要突破这些限制来:与C代码交互实现底层系统编程优化性能关键代码实现某些编译器无法验证的安全操作Rus...

探秘 Python 内存管理:背后的神奇机制

在编程的世界里,内存管理就如同幕后的精密操控者,确保程序的高效运行。Python作为一种广泛使用的编程语言,其内存管理机制既巧妙又复杂,为开发者们提供了便利的同时,也展现了强大的底层控制能力。一、P...