ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

Progress.js快速上手教程:3分钟为页面加上平滑进度条动画

Progress.js快速上手教程:3分钟为页面加上平滑进度条动画 Progress.js快速上手教程3分钟为页面加上平滑进度条动画【免费下载链接】progress.jsProgressJs is a JavaScript and CSS3 library which help developers to create and manage progress bar for every objects on the page.项目地址: https://gitcode.com/gh_mirrors/pr/progress.jsProgress.js是一个基于 JavaScript 和 CSS3 的轻量级进度条库它能帮助开发者为页面上的任意对象创建并管理平滑的进度条动画。无论你是前端新手还是普通用户只需引入两个文件、写下两三行代码就能在 3 分钟内让页面拥有 iOS 风格的加载动画 为什么需要 Progress.js现代网页离不开加载反馈数据提交、图片上传、异步请求……一个平滑的进度条能显著提升用户体验。相比手写动画Progress.js 的优势在于零依赖纯 JavaScript CSS3 实现无需 jQuery 等框架任意目标可作用于整个页面body也可作用于页面上的任意元素可换肤内置多种主题模板通过setOption一键切换体积小提供压缩版本生产环境直接可用快速安装获取 Progress.js 源码仓库是只读的直接克隆到你的项目中即可git clone https://gitcode.com/gh_mirrors/pr/progress.js克隆后你会得到完整的目录结构文件用途src/progress.js核心源码开发调试用src/progressjs.css主题样式源码minified/progress.min.js压缩版 JS生产环境推荐minified/progressjs.min.css压缩版 CSS生产环境推荐 提示生产环境请使用minified/目录下的压缩版本加载更快、体积更小。一键引入最快配置方法在 HTML 页面中依次引入 CSS 和 JS 两个文件即可官方 README.md 中也明确推荐了这一方式link relstylesheet hrefminified/progressjs.min.css script srcminified/progress.min.js/script就这两行Progress.js 已准备就绪 ✅启动你的第一条进度条动画引入完成后调用progressJs()函数即可。它可以接受三种参数不传参数→ 进度条覆盖整个页面固定在body顶部传入选择器字符串如#targetElement→ 作用于指定元素传入 DOM 对象或对象数组→ 作用于传入的元素// 为整个页面启动进度条 progressJs().start(); // 或者为页面上的特定元素启动 progressJs(#targetElement).start();调用start()后Progress.js 会自动创建一个.progressjs-container容器并注入进度条 DOM默认从 1% 开始配合 CSS3 transition 实现平滑动画效果动画逻辑见 src/progress.js 中的_setPercentFor函数。常用 API 一览set / increase / autoIncreaseProgress.js 采用链式 API 设计方法都定义在 src/progress.js 的原型上常用方法如下方法作用示例start()启动进度条动画progressJs().start()set(百分比)直接设置到指定百分比上限 100bar.set(60)increase(步长)在当前值上增量推进bar.increase(10)autoIncrease(步长, 毫秒)每隔指定毫秒自动增加适合模拟加载bar.autoIncrease(5, 300)end()平滑结束自动补到 100% 后淡出移除bar.end()kill()立即结束并移除进度条不补满bar.kill()setOption(键, 值)修改单个配置项bar.setOption(theme, blackRadiusInputs)一个典型的完整流程var bar progressJs(#myBox).start(); bar.autoIncrease(5, 300); // 每 300ms 前进 5%模拟数据加载 // 数据加载完成后收尾 bar.end();如果你需要监听进度变化还可以注册回调onbeforestart开始前、onprogress每次更新百分比时、onbeforeend结束前方便与业务逻辑联动 一键更换主题setOption 设置主题样式定义在 src/progressjs.css 中通过theme配置项切换。库内置了多个开箱即用的主题blue默认——iOS 7 风格的 2px 蓝色细线条最百搭blueOverlay——整块元素覆盖式蓝色蒙层blueOverlayRadius——带圆角的覆盖式蒙层blueOverlayRadiusHalfOpacity——半透明圆角蒙层blueOverlayRadiusWithPercentBar——圆角蒙层 居中大号百分比数字blackRadiusInputs——深色圆角条适合表单输入框场景切换方式只需一行代码记得在start()之前设置progressJs(#myBox) .setOption(theme, blueOverlayRadius) .start();如果想自定义主题只需在 CSS 中新增.progressjs-theme-你的主题名相关的样式类即可源码中的主题机制见 src/progress.js。源码与项目文件导航熟悉库之后这些文件值得收藏完整使用示例README.md核心逻辑源码src/progress.js主题样式src/progressjs.css压缩产物生产使用minified/progress.min.js、minified/progressjs.min.css本地构建配置Makefile需先安装 nodejs 和 npm运行make build重新压缩静态资源许可协议MITLICENSE写在最后Progress.js 用不到 600 行代码把平滑进度条动画这件复杂的事简化成了progressJs().start()一行调用。从克隆仓库到看到动画3 分钟绰绰有余——快去给你的页面加上这条顺滑的蓝色进度条吧✨【免费下载链接】progress.jsProgressJs is a JavaScript and CSS3 library which help developers to create and manage progress bar for every objects on the page.项目地址: https://gitcode.com/gh_mirrors/pr/progress.js创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表