ARTICLE DETAIL

资讯详情

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

5分钟快速上手SnackbarJS:从零创建第一个Material风格Snackbar完整教程

5分钟快速上手SnackbarJS:从零创建第一个Material风格Snackbar完整教程 5分钟快速上手SnackbarJS从零创建第一个Material风格Snackbar完整教程【免费下载链接】snackbarjsCreate Material Design snackbars and toasts with ease.项目地址: https://gitcode.com/gh_mirrors/sn/snackbarjsSnackbarJS是一款轻量级的 jQuery 插件让你用最简单的方式创建 Material Design 风格的Snackbar底部轻提示和Toast圆角气泡提示用法和 Bootstrap 的 tooltip 一样顺手。本文是一份面向新手的完整教程5 分钟带你从零创建第一个 Material 风格 Snackbar。一、Snackbar 是什么为什么选择 SnackbarJSMaterial Design 中Snackbar是出现在页面底部的小型通知条用于反馈保存成功消息已删除等操作结果Toast则是它的圆角气泡变体。选择 SnackbarJS 的理由轻量核心代码仅一个 src/snackbar.js 文件体积小巧加载飞快⚡极简一行 JS 或一个 HTML 属性即可触发提示Material 风格开箱即用内置深色底、阴影、滑入动画的主题样式响应式移动端自动全屏宽度显示二、安装与引入最快上手步骤第 1 步获取项目源码git clone https://gitcode.com/gh_mirrors/sn/snackbarjs第 2 步生成发布文件可选项目使用 Grunt 构建构建脚本见 Gruntfile.jsnpm install npx grunt dist # 在 dist/ 目录生成压缩版 snackbar.min.js 和 snackbar.min.css第 3 步在页面中引入head link hrefdist/snackbar.min.css relstylesheet link hrefthemes-css/material.css relstylesheet /head body ... script srcjquery.min.js/script script srcdist/snackbar.min.js/script /body 别忘了 SnackbarJS 依赖 jQuery约 2.1 版本见 package.json 与 bower.json。三、创建第一个 Material 风格 Snackbar方式 1HTML 属性法最简单给任意元素加上data-togglesnackbar和提示文案data-contentspan>$.snackbar({ content: This is my awesome snackbar! });它会立即弹出一条 Snackbar并返回对应的 jQuery 元素方便你后续操作 DOM。四、自定义 Snackbar常用配置项一览通过选项对象可以全面定制 Snackbar 的外观与行为$.snackbar({ content: 操作完成, // 提示文本 style: toast, // 附加自定义类名如圆角 toast 样式 timeout: 100, // 毫秒0 表示不自动隐藏 htmlAllowed: true, // 允许内容中包含 HTML onClose: function() {} // 关闭时回调仅 JS 调用可用 });配置项作用备注content提示文字必填style自定义样式类设为toast可切换圆角气泡风格timeout自动隐藏时间毫秒默认 3000设为 0 禁用自动隐藏htmlAllowed是否允许 HTML 内容默认 false自动转义onClose关闭回调⚠️ HTML 属性方式不支持HTML 属性写法与之完全对应data-content、data-style、data-timeout、data-html-allowed。五、控制 Snackbar显示、隐藏与切换Snackbar 创建后可以随时用三种动作控制它$(#snackbarid).snackbar(show); // 显示 $(#snackbarid).snackbar(hide); // 隐藏 $(#snackbarid).snackbar(toggle); // 切换两个好用的特性#snackbarid既可以指向带data-togglesnackbar的按钮也可以指向 Snackbar 元素本身对一个不存在的 Snackbar 调用上述方法会先创建再执行动作非常适合在 JS 逻辑中动态触发提示六、切换 Toast 圆角风格与自定义主题Material 主题的核心样式在 themes-css/material.css源码为 themes-less/material.less深色背景#323232 白字 微妙阴影还原 Material 设计规范内置transform opacity的 0.2s 滑入滑出动画.snackbar.toast类提供200px 圆角的 Toast 气泡变体只传一个参数就能切换风格$.snackbar({ content: 你有一条新消息, style: toast });想改颜色、字号或动画直接修改 themes-less 下的 Less 源码重新编译或改 CSS 即可核心定位样式固定于左下角的容器则定义在 src/snackbar.less 中。七、新手常见问题 FAQQ1为什么页面没有任何提示检查是否引入了 jQuery 且顺序在 SnackbarJS 之前。Q2提示时间太短/想常驻怎么办设置timeout: 8000延长或timeout: 0让 Snackbar 常驻直到用户点击关闭。Q3多条 Snackbar 会重叠吗不会。多条提示会自上而下依次堆叠且在 767px 以下的移动端自动变为通栏显示。Q4如何在关闭时执行逻辑使用 JS 方式传入onClose回调例如记录用户已读状态。总结至此你已经掌握了 SnackbarJS 的完整用法引入文件 → 创建 Snackbar → 自定义配置 → 控制显示隐藏。它用不到 5 分钟的接入成本就能为你的项目带来地道的 Material Design 消息提示体验。【免费下载链接】snackbarjsCreate Material Design snackbars and toasts with ease.项目地址: https://gitcode.com/gh_mirrors/sn/snackbarjs创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表