BulletJs

😀一个原生js弹幕库,基于 CSS3 Animation

  • segmentFault文章地址
  • 项目地址
  • 本项目灵感来源于 rc-bullets
  • 演示页面 https://hugeorange.github.io/gh-pages/bullets/index
  • 演示图 danmuku.gif

    更新日志

    2021-01-22更新

  • 全局增加isAllPaused标志,当全部暂停后不会再有push或是render,resume 之后即可恢复
  • 问题:切记:不可覆盖内部样式类 bullet-item-style 否则可能会出现弹幕重叠问题
  • 增加演示页面

    2020-08-24更新

  • 源码采用ts书写,增加 .d.ts 文件
  • 采用rollup打包并发布到npm,rollup打包教程
  • 去除靠IntersectionObserver来对弹道进行调度,采用新的弹道选择算法,增加防重叠检测
  • 支持同速/不同速弹幕
  • 默认情况下直接丢弃排不上对的弹幕,不对其进行缓存,对于必定要上墙的弹幕在push时可以增加一个参数 this.screen.push(danmu, {}, true)(适用于用户自己发的弹幕,需要将第三个参数传为true)
  • 变更名字,想想用拼音起名还是太low了😂😂😂

使用方式

  1. 直接cdn引入

    // 示例代码: https://github.com/hugeorange/BulletJs/blob/master/src/index.html
    <script src="https://unpkg.com/[email protected]/dist/BulletJs.min.js"></script>
    <script>
    const screen = new BulletJs('.screen', { 
                      trackHeight: 35 
                    });
    </script>
  2. ESModule 引入

    yarn add js-bullets
    
    // react
    import BulletJs from "js-bullets";
    
    componentDidMount() {
        this.screen = new BulletJs("#danmu-screen", {})
    
        setInterval(() => {
            this.screen.push('<span>12222222</span>')
        }, 1000)
    }
  3. 简单粗暴的办法直接拷贝comps目录下的代码到你的项目中使用,vue、react项目均可


  • 项目产生原因:
    • 因为rc-bullets 是基于 React,可能很多使用其他框架的同学没法使用
    • 新增了 speed 参数,让所有弹幕以相同速度运动(自己项目的需要)
    • animationEnd的时候增加了轨道置空处理
    • queues 队列的处理方式不同
    • 弹幕格式 dom 字符串
    • 去掉了一些自己项目用不到的 api

API

option

选项 含义 值类型 默认值 备注
trackHeight 轨道高度 string 50px 均分轨道的高度
onStart 自定义动画开始函数 function null 开始开始回调
onEnd 自定义动画结束函数 function null 弹幕运动结束回调
pauseOnClick 鼠标点击暂停 boolean false 再次点击继续
pauseOnHover 鼠标悬停暂停 boolean true 鼠标进入暂停,离开继续
duration 滚动时长 string 10s 传入speed该参数无效
speed 滚动速度 number 100 100px/snull 传入null 会根据 duration参数自动控制速度,弹幕越长速度越快
  • 暂停弹幕:screen.pause([<bulletId>]),无参则暂停全部
  • 弹幕继续:screen.resume([<bulletId>]),无参则继续全部

注意事项

  • 弹幕原理:利用 css3 animation 关键帧动画, 从左移动到右,duration 控制速度
    @keyframe name {
        from { transform: translateX(width px) }
        to { transform: translateX(-100%) }
    }
  • 弹幕防重叠原理 原理图
  • 另外一点需要注意的:我在项目里从接口里读出来数据每页20条,每隔 1s 去发一条弹幕(用 setTimeout),这时有个问题,当页面休眠休眠时,会出现setTimeout堆积的情况,解决办法:用 requestAnimationFrame替代 setTimeout

Bullet.js

👨‍💻‍一个原生js弹幕库

Bullet.js Info

⭐ Stars 43
🔗 Source Code github.com
🕒 Last Update 7 months ago
🕒 Created 3 years ago
🐞 Open Issues 2
➗ Star-Issue Ratio 22
😎 Author hugeorange