better-scroll 详解
为祖国的复兴而读书您的支持是我继续创作及维护的动力感谢打赏祝您工作顺利生活美满介绍在我们日常的移动端项目开发中处理滚动列表是再常见不过的需求了可以是竖向滚动的列表也可以是横向的用better-scroll可以帮助我们实现这个官方文档better-scroll 是什么better-scroll 是一款重点解决移动端已支持 PC各种滚动场景需求的插件。better-scroll 是基于原生 JS 实现的不依赖任何框架。它编译后的代码大小是 63kb压缩后是 35kbzip 后仅有9kb是一款非常轻量的 JS lib。怎么使用 better-scroll结构例常见的列表滚动divclasswrapperulclasscontentli.../lili.../li.../ul/div以上代码better-scroll 是作用在外层 wrapper 容器上的滚动的部分是 content 元素。加载script srchttps://unpkg.com/better-scroll/dist/bscroll.min.js/script实例化varBScrollnewBScroll(.wrapper);特别注意better-scroll 只处理容器wrapper的第一个子元素content的滚动其它的元素都会被忽略。外盒子设置固定宽或高和属性overflow: hidden;当 content的高度不超过父容器的高度是不能滚动的而它一旦超过了父容器的高度我们就可以滚动了这就是 better-scroll 的滚动原理。绿色部分为 wrapper也就是父容器它会有固定的高度黄色部分为 content它是父容器的第一个子元素它的高度会随着内容的大小而撑高。better-scroll 支持很多参数配置可以在初始化的时候传入第二个参数。比如letscrollnewBScroll(.wrapper,{scrollY:true,click:true})这样就实现了一个纵向可点击的滚动效果。better-scroll 支持的参数非常多可以修改它们去实现更多的特性。通常你可以不改这些参数。APIapi 里面所有的方法和属性都是实例化对象的。on 方法on(type,fn,context)参数type事件名fn回调函数context函数执行的上下文环境默认是this返回值无作用监听当前实例上的自定义事件。如scrollscrollEndpullingUp,pullingDown等示例importBScrollfrombetter-scrollletscrollnewBScroll(.wrapper)functiononScroll(pos){console.log(scroll)}scroll.on(scroll,onscroll)scroll 事件bs.on(“scroll”,function(){})参数{Object} {x, y} 滚动的实时坐标触发时机滚动过程中具体时机取决于选项中的 probeType。probeType 属性作用有时候我们需要知道滚动的位置。类型Number默认值0可选值1、2、3当 probeType 为 1 的时候会非实时屏幕滑动超过一定时间后派发scroll 事件当 probeType 为 2 的时候会在屏幕滑动的过程中实时的派发 scroll 事件当 probeType 为 3 的时候不仅在屏幕滑动的过程中而且在 momentum 滚动动画运行过程中实时派发 scroll 事件。如果没有设置该值其默认值为 0即不派发 scroll 事件。scrollEnd 事件参数{Object} {x, y} 滚动结束的位置坐标触发时机滚动结束。maxScrollY 属性类型Number作用scroll 最大纵向滚动位置。备注scroll 纵向滚动的位置区间是 0 - maxScrollY并且 maxScrollY 是负值。scrollX 属性类型Boolean默认值: false作用当设置为 true 的时候可以开启横向滚动。备注当设置 eventPassthrough 为 ‘horizontal’ 的时候该配置无效。refresh 方法作用重新计算 better-scroll当 DOM 结构发生变化的时候务必要调用确保滚动的效果正常。例scroll.refresh();小栗子上拉加载下拉刷新!DOCTYPEhtmlhtmllangenheadmetacharsetUTF-8metanameviewportcontentwidthdevice-width, initial-scale1.0metahttp-equivX-UA-CompatiblecontentieedgetitleDocument/titlestyle*{margin:0;padding:0;}html, body{width:100%;height:100%;}.wrapper{width:100%;height:100%;overflow:hidden;}.content{border:solid blue 1px;}.pull-down, .pull-up{position:absolute;width:100%;height:50px;line-height:50px;text-align:center;color:#fff;background:#999;}.pull-down{top:-50px;}.pull-up{bottom:-50px;}li{width:100%;height:50px;border:solid red 1px;}/stylescriptsrcjs/bscroll.min.js/scriptscriptwindow.onloadfunction(){varpdocument.querySelector(.pull-down);varupdocument.querySelector(.pull-up);//获取展示内容高度varhp.offsetHeight;//标识当前是否加载完成数据varendDate0;//创建上拉加载的数据vardata[];//循环添加数据for(leti16;i30;i){data.push(列表i)}//实例化better-scrollvarbsnewBScroll(.wrapper,{probeType:2//实时获取滚动坐标位置});//给实例化对象绑定事件方法bs.on(scroll,onScroll);bs.on(scrollEnd,scrollEnd);//滚动结束后执行scrollEndfunctionscrollEnd(){varselectp.getAttribute(select);varselectUpup.getAttribute(select);if(select){// console.log(刷新);//刷新页面location.reload();}if(selectUp){// console.log(加载);loadData();}}//加载数据的构造函数functionloadData(){//splice 返回截取数据修改原数组长度//map//判断数组数据是否为空不为空继续添加节点数据否则提示数据为空if(data.length0){//endDate:数据表示还有endDate0;varnewDatadata.splice(0,5);document.querySelector(.list).innerHTMLnewData.map(function(item){returnliitem/li}).join();bs.refresh();}else{up.innerHTML没有数据了;//endDate:数据表示没有了为空endDate1;}}//获取滚动的实时坐标位置functiononScroll(){//坐标大于提示文字高度后展示相应内容否则内容if(bs.yh){p.innerHTML释放刷新...p.setAttribute(select,true);}else{p.innerHTML下拉刷新p.removeAttribute(select);}//endDate 来判断是否是已经加载完毕if(!endDate){if(bs.y(bs.maxScrollY-h)){up.innerHTML释放加载...;up.setAttribute(select,true);}else{up.innerHTML上拉加载up.removeAttribute(select);}}}}/script/headbodydivclasswrapper!-- 滚动DOM --divclasscontentpclasspull-down下拉刷新/pulclasslistli列表1/lili列表2/lili列表3/lili列表4/lili列表5/lili列表6/lili列表7/lili列表8/lili列表9/lili列表10/lili列表11/lili列表12/lili列表13/lili列表14/lili列表15/li/ulpclasspull-up上拉加载/p/div/div/body/html参考文档http://ustbhuangyi.github.io/better-scroll/doc/zh-hans/api.html结束语文/非凡主力独自漫步在星河夜空中回首永远不曾停留的光年怀念我们一起走过的日子光年载着年华驰骋行空像穿越千年的光芒在遥远的天宇星辰中我寻到了一个水瓶星座二零一三年 - 冬

相关新闻

GHelper智能升级:华硕笔记本极致性能调优完整指南

GHelper智能升级:华硕笔记本极致性能调优完整指南

GHelper智能升级:华硕笔记本极致性能调优完整指南 【免费下载链接】g-helper Lightweight Armoury Crate alternative for Asus laptops with nearly the same functionality. Works with ROG Zephyrus, Flow, TUF, Strix, Scar, ProArt, Vivobook, Zenbook, Expert…

2026/9/24 3:29:46 阅读更多 →
鸿蒙 ArkTS 实战:Memory Flip Cards 从记忆翻牌到记录管理完整解析

鸿蒙 ArkTS 实战:Memory Flip Cards 从记忆翻牌到记录管理完整解析

鸿蒙 ArkTS 实战:Memory Flip Cards 从记忆翻牌到记录管理完整解析 前言 Memory Flip Cards 是一个面向 记忆翻牌 场景的鸿蒙 ArkTS 单页应用。它不是只展示静态文案,而是围绕记录数据、分数统计、开关配置、表单录入和列表交互构建了完整的轻量业务闭…

2026/9/19 20:10:27 阅读更多 →
TI ISP寄存器编程实战:从H3A统计到预览流水线深度解析

TI ISP寄存器编程实战:从H3A统计到预览流水线深度解析

1. 项目概述 在嵌入式视觉和移动影像领域,图像信号处理器(ISP)是连接图像传感器与应用处理器的关键桥梁。它负责将传感器输出的原始拜耳数据,经过一系列复杂的硬件加速处理,转化为我们日常所见的清晰、色彩准确的图像。…

2026/9/22 11:43:25 阅读更多 →

最新新闻

恒比定时甄别器CFD原理与工程实现:从公式推导到PCB布局调测全解析

恒比定时甄别器CFD原理与工程实现:从公式推导到PCB布局调测全解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/9/24 8:10:26 阅读更多 →
AI数据中心四大子系统重构:供电散热网络管理的硬核升级

AI数据中心四大子系统重构:供电散热网络管理的硬核升级

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/9/24 8:10:26 阅读更多 →
Apache Druid 数组展开(UNNEST)实战指南:使用 unnest 数据源将嵌套数组列拆分为单值行

Apache Druid 数组展开(UNNEST)实战指南:使用 unnest 数据源将嵌套数组列拆分为单值行

数据库OLAP大数据后端 【免费下载链接】druid Apache Druid: a high performance real-time analytics database. 项目地址: https://gitcode.com/gh_mirrors/druid6/druid 点击查看 免费下载 本文是 Apache Druid 数组展开的完整实战教程,围绕 Druid 的…

2026/9/24 8:10:26 阅读更多 →
智慧园区安环能一体化AI大模型平台:架构设计与落地实践

智慧园区安环能一体化AI大模型平台:架构设计与落地实践

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/9/24 8:09:26 阅读更多 →
计算机毕业设计选题推荐:基于大数据的公交站点出行信息数据可视化分析|毕业设计选题|计算机毕设|选题推荐|毕设指导|项目定制|源码|高质量项目

计算机毕业设计选题推荐:基于大数据的公交站点出行信息数据可视化分析|毕业设计选题|计算机毕设|选题推荐|毕设指导|项目定制|源码|高质量项目

✨作者主页:IT毕设梦工厂✨ 个人简介:曾从事计算机专业培训教学,擅长Java、Python、PHP、.NET、Node.js、GO、微信小程序、安卓Android等项目实战。接项目定制开发、代码讲解、答辩教学、文档编写、降重等。 ☑文末获取源码☑ 精彩专栏推荐⬇…

2026/9/24 8:08:26 阅读更多 →
Arduino UNO R4 Minima 肌电信号掰手腕机械臂实战:从EMG采集到舵机控制

Arduino UNO R4 Minima 肌电信号掰手腕机械臂实战:从EMG采集到舵机控制

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/9/24 8:08:26 阅读更多 →

日新闻

基于YOLOv8的渔船作业监控系统:从环境搭建到边缘部署全流程

基于YOLOv8的渔船作业监控系统:从环境搭建到边缘部署全流程

简介:这是一套面向计算机、人工智能、自动化等专业学生与教师的毕业设计级项目资源,围绕YOLOv8实现渔船作业监控系统,可用于毕设、课程设计、大作业或项目立项演示。压缩包共97个文件,约24.21MB,以70个Python源码文件为…

2026/9/24 0:00:19 阅读更多 →
单细胞注释实战:基于Scanpy的标记基因与参考映射流程解析

单细胞注释实战:基于Scanpy的标记基因与参考映射流程解析

简介:一份基于单细胞RNA测序数据的细胞类型注释算法研究Python毕业设计源码,针对计算机相关专业正在做毕设或需要项目实战的学习者,可用于课程设计与期末大作业。项目代码完整、经导师指导评审通过,可直接运行,覆盖数据…

2026/9/24 0:00:19 阅读更多 →
C#源生成器实战:用增量生成器替代反射,告别AOT崩溃

C#源生成器实战:用增量生成器替代反射,告别AOT崩溃

第一次在项目里被反射卡住,是在一个老旧的WinForms模块里:几十个类依赖PropertyChanged通知,运行时反射读属性、发通知,每次启动慢半拍不说,一上.NET Native/AOT裁剪模式几乎全面崩盘。后来我把这段逻辑全部改成C#源生…

2026/9/24 0:00:19 阅读更多 →

周新闻

Flutter for OpenHarmony游戏卡片渐变背景实战:从原理到性能优化

Flutter for OpenHarmony游戏卡片渐变背景实战:从原理到性能优化

直接铺开项目本身吧。这几个月我一直在折腾一件事:用Flutter给OpenHarmony做一款游戏集合类的App,说白了就是把若干小游戏塞进一个壳里,用统一入口分发。这个方向本身不算新鲜,真正让我花了不少心思的,是首页那堆游戏卡…

2026/9/23 4:55:02 阅读更多 →
Word表格编号全攻略:从列表编号到题注交叉引用

Word表格编号全攻略:从列表编号到题注交叉引用

写Word文档,最让人头疼的往往是那些“看起来不起眼”的小问题。比如表格编号这事:今天在表后面多加了两个空白行,明天给客户交稿前发现整个章节的编号全部错位,光是挨个改序号就能耗掉大半个下午。我前阵子帮人整理一份上百页的技…

2026/9/23 4:49:06 阅读更多 →
从第一个站到第二个站:独立开发者的静态网站选型与落地实践

从第一个站到第二个站:独立开发者的静态网站选型与落地实践

1. 项目概述1.1 核心需求解析做独立开发者这几年,说实话,第一个网站上线的那天晚上我兴奋得没睡着。但等它跑了半年,流量惨淡、功能臃肿、代码自己都懒得看第二遍之后,我才慢慢琢磨明白一个道理:第一个网站是练手&…

2026/9/23 9:53:41 阅读更多 →

月新闻

持续集成 流水线自动化与 声明式交付 实践:原型怎样变成可用功能

持续集成 流水线自动化与 声明式交付 实践:原型怎样变成可用功能

持续集成 流水线自动化与 声明式交付 实践:原型怎样变成可用功能分类:[AI/大模型]细分主题:AI 增强型 CI/CD 流水线自动化与 GitOps 实践:Agent 工作流、工具调用与任务拆解:从原型到生产的验收清单很多团队在尝试用大…

2026/9/23 9:53:40 阅读更多 →
容器编排 生产环境运维与排障实战:复盘记录怎样真正派上用场

容器编排 生产环境运维与排障实战:复盘记录怎样真正派上用场

容器编排 生产环境运维与排障实战:复盘记录怎样真正派上用场分类:[工程技术]细分主题:Kubernetes 生产环境运维与排障实战:可复制的项目复盘模板与决策记录大部分团队的事故复盘报告,最后都变成了躺在 Confluence 或钉…

2026/9/23 9:53:40 阅读更多 →
容器 容器化技术与镜像安全管理:核心链路应该先拆哪一步

容器 容器化技术与镜像安全管理:核心链路应该先拆哪一步

容器 容器化技术与镜像安全管理:核心链路应该先拆哪一步分类:[工程技术]细分主题:Docker 容器化技术与镜像安全管理:核心链路的逐步实现与关键代码取舍面对一个积累了五六年历史包袱的单体架构应用(包含 Web 接口、后台…

2026/9/23 9:53:40 阅读更多 →