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

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

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

前几天有给大家分享一个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开发自定义美化滚动条组件。希望大家能喜欢~~

相关推荐

JPA实体类注解,看这篇就全会了

基本注解@Entity标注于实体类声明语句之前,指出该Java类为实体类,将映射到指定的数据库表。name(可选):实体名称。缺省为实体类的非限定名称。该名称用于引用查询中的实体。不与@Tab...

Dify教程02 - Dify+Deepseek零代码赋能,普通人也能开发AI应用

开始今天的教程之前,先解决昨天遇到的一个问题,docker安装Dify的时候有个报错,进入Dify面板的时候会出现“InternalServerError”的提示,log日志报错:S3_USE_A...

用离散标记重塑人体姿态:VQ-VAE实现关键点组合关系编码

在人体姿态估计领域,传统方法通常将关键点作为基本处理单元,这些关键点在人体骨架结构上代表关节位置(如肘部、膝盖和头部)的空间坐标。现有模型对这些关键点的预测主要采用两种范式:直接通过坐标回归或间接通过...

B 客户端流RPC (clientstream Client Stream)

客户端编写一系列消息并将其发送到服务器,同样使用提供的流。一旦客户端写完消息,它就等待服务器读取消息并返回响应gRPC再次保证了单个RPC调用中的消息排序在客户端流RPC模式中,客户端会发送多个请...

我的模型我做主02——训练自己的大模型:简易入门指南

模型训练往往需要较高的配置,为了满足友友们的好奇心,这里我们不要内存,不要gpu,用最简单的方式,让大家感受一下什么是模型训练。基于你的硬件配置,我们可以设计一个完全在CPU上运行的简易模型训练方案。...

开源项目MessageNest打造个性化消息推送平台多种通知方式

今天介绍一个开源项目,MessageNest-可以打造个性化消息推送平台,整合邮件、钉钉、企业微信等多种通知方式。定制你的消息,让通知方式更灵活多样。开源地址:https://github.c...

使用投机规则API加快页面加载速度

当今的网络用户要求快速导航,从一个页面移动到另一个页面时应尽量减少延迟。投机规则应用程序接口(SpeculationRulesAPI)的出现改变了网络应用程序接口(WebAPI)领域的游戏规则。...

JSONP安全攻防技术

关于JSONPJSONP全称是JSONwithPadding,是基于JSON格式的为解决跨域请求资源而产生的解决方案。它的基本原理是利用HTML的元素标签,远程调用JSON文件来实现数据传递。如果...

大数据Doris(六):编译 Doris遇到的问题

编译Doris遇到的问题一、js_generator.cc:(.text+0xfc3c):undefinedreferenceto`well_known_types_js’查找Doris...

网页内嵌PDF获取的办法

最近女王大人为了通过某认证考试,交了2000RMB,官方居然没有给线下教材资料,直接给的是在线教材,教材是PDF的但是是内嵌在网页内,可惜却没有给具体的PDF地址,无法下载,看到女王大人一点点的截图保...

印度女孩被邻居家客人性骚扰,父亲上门警告,反被围殴致死

微信的规则进行了调整希望大家看完故事多点“在看”,喜欢的话也点个分享和赞这样事儿君的推送才能继续出现在你的订阅列表里才能继续跟大家分享每个开怀大笑或拍案惊奇的好故事啦~话说只要稍微关注新闻的人,应该...

下周重要财经数据日程一览 (1229-0103)

下周焦点全球制造业PMI美国消费者信心指数美国首申失业救济人数值得注意的是,下周一希腊还将举行第三轮总统选举需要谷歌日历同步及部分智能手机(安卓,iPhone)同步日历功能的朋友请点击此链接,数据公布...

PyTorch 深度学习实战(38):注意力机制全面解析

在上一篇文章中,我们探讨了分布式训练实战。本文将深入解析注意力机制的完整发展历程,从最初的Seq2Seq模型到革命性的Transformer架构。我们将使用PyTorch实现2个关键阶段的注意力机制变...

聊聊Spring AI的EmbeddingModel

序本文主要研究一下SpringAI的EmbeddingModelEmbeddingModelspring-ai-core/src/main/java/org/springframework/ai/e...

前端分享-少年了解过iframe么

iframe就像是HTML的「内嵌画布」,允许在页面中加载独立网页,如同在画布上叠加另一幅动态画卷。核心特性包括:独立上下文:每个iframe都拥有独立的DOM/CSS/JS环境(类似浏...