jQuery Growl

Growl 风格的消息提醒(源自 Mac 的弹泡通知)会在屏幕角落浮出几秒后自动消失,适合"保存成功、收到新消息"等轻提示,不打断用户当前操作。jGrowl 是基于 jQuery 的最流行实现,一条 $.jGrowl() 调用即可弹出气泡。

1. 引入 jGrowl

需要 jQuery、jGrowl 的 JS 与配套 CSS(CSS 决定气泡位置与默认外观):

<link href="https://example.com/jquery.jgrowl.min.css" rel="stylesheet">

说明:示例中的 https://example.com 地址为占位域名,实际使用请替换为官方 CDN 或本地文件路径。
<script src="https://example.com/jquery.min.js"></script>
<script src="https://example.com/jquery.jgrowl.min.js"></script>

2. 基本用法

$.jGrowl(消息, 选项),默认数秒后自动淡出:

$.jGrowl("欢迎来到本网站!");
// 效果:屏幕角落浮出一个圆角提示气泡,约 3 秒后自动消失,无需用户操作

3. 常用选项

选项说明示例
header气泡标题栏文字header: "通知"
life存活毫秒数,到时自动关闭life: 5000
stickytrue 时一直停留,需手动关闭sticky: true
theme内置主题:default / error / success / warningtheme: "success"
speed出现与消失的动画速度speed: "slow"

组合使用:

$.jGrowl("数据保存成功!", { header: "成功", theme: "success", life: 3000 });
$.jGrowl("服务器连接失败,请稍后重试", { header: "错误", theme: "error", sticky: true });
// 效果:第一条绿色气泡 3 秒后自动消失;第二条红色气泡常驻,
// 需点击其右上角的"×"(或关闭全部按钮)才会消失

4. 全局设置与回调

用 $.jGrowl.defaults 修改默认值,之后所有消息都生效;afterClose 等回调便于统计与联动:

$.jGrowl.defaults.life = 2500;    // 所有消息默认 2.5 秒
$.jGrowl.defaults.closer = true;  // 显示"关闭全部"按钮

$.jGrowl("有回调的消息", {
  afterClose: function () {
    console.log("一条消息被关闭了");   // 输出:一条消息被关闭了
  }
});

5. 什么时候不用它

Growl 适合轻量、非阻塞通知;需要用户必须确认或填写的场景(删除确认、登录表单)应改用模态框或 confirm,避免消息自动消失导致操作不可达。

小结

$.jGrowl() 一行即可弹出自动消失的角落提示,配合 header、theme、sticky、life 能覆盖成功、错误、常驻等多种场景;记住它只适合非阻塞通知,重要操作请交给模态对话框。

笔记加载中…