jQuery Growl 技术文档

1. 安装指南

jQuery Growl 是一款基于 jQuery 的浏览器消息提示插件。以下是安装步骤：

• 将 javascripts 和 stylesheets 文件夹复制到你的项目中。
• 在 HTML 头部添加以下代码：

<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.0.2/jquery.min.js" type="text/javascript"></script>
<script src="javascript/jquery.growl.js" type="text/javascript"></script>
<link href="stylesheets/jquery.growl.css" rel="stylesheet" type="text/css" />

此外，你也可以使用 Bower 来简化集成：

npm install -g bower
bower install growl

如果是 Ruby on Rails 项目，可以在 Gemfile 中添加：

source 'https://rails-assets.org'
gem 'rails-assets-growl'

并在 application.css 和 application.js 中分别引入对应的文件：

/*
...
*= require growl
...
*/

//= require jquery
...
//= require growl

2. 使用说明

jQuery Growl 的使用非常简单。以下是一些基本示例：

$.growl({ title: "Growl", message: "小猫醒了！", url: "/kittens" });
$.growl.error({ message: "小猫在攻击！" });
$.growl.notice({ message: "小猫很可爱！" });
$.growl.warning({ message: "小猫很丑！" });

3. 项目API使用文档

以下是 jQuery Growl 的一些高级选项：

• delayOnHover：当鼠标悬停在提示框上时，防止提示框被关闭（布尔值，默认为 true）。
• duration：提示框显示的持续时间（毫秒，默认为 3200）。
• fixed：提示框是否为固定显示，而不是自动关闭（布尔值，默认为 false）。
• location：提示框的位置（'tl' | 'tr' | 'bl' | 'br' | 'tc' | 'bc'，默认为 'tr'）。
• size：提示框的大小（'small' | 'medium' | 'large'，默认为 'medium'）。
• style：提示框的样式（'default' | 'error' | 'notice' | 'warning'，默认为 'default'）。

请注意，之前版本的 static 选项已被重命名为 fixed，以解决与压缩工具的兼容性问题。

4. 项目安装方式

项目的安装方式已在“安装指南”中详细说明，可以通过直接复制文件、使用 Bower 或在 Ruby on Rails 项目中添加 Gemfile 来完成安装。请根据你的项目需求选择合适的安装方法。