jQuery Notify Bar 使用与技术文档

1. 安装指南

在开始使用 jQuery Notify Bar 之前，您需要确保已经正确安装了该插件。以下是安装步骤：

> bower install jqnotifybar

如果您尚未安装 Bower，您需要先安装它，因为它是一个前端依赖管理工具。

2. 项目使用说明

jQuery Notify Bar 是一个简单的插件，用于显示通知栏，类似于 Twitter 网页上的通知。以下是基本的使用方法：

jQuery(function () {
  jQuery.notifyBar({
    html: "感谢您，您的设置已更新！",
    delay: 2000,
    animationSpeed: "normal"
  });
});

如果您希望通知栏显示在页面底部，可以使用以下代码：

jQuery(function () {
  jQuery.notifyBar({
    html: "来自底部的问候！",
    cssClass: "Appear at bottom",
    position: "bottom"
  });
});

3. 项目API使用文档

以下是 jQuery Notify Bar 支持的选项列表：

选项	描述	类型	默认值
html	通知栏内显示的文本，可以是 HTML 或纯文本	字符串	"您的消息"
delay	通知栏显示的延迟时间，不包括动画时间	整数	2000
animationSpeed	通知栏上下滑动的时间	字符串	整数
jqObject	自定义的 jQuery 对象，用于通知栏	jQuery 对象	null
cssClass	为通知栏定义自己的 CSS 类。有预定义类 "error"、"warning" 和 "success"	字符串	""
close	如果设置为 true，将显示关闭按钮	布尔值	false
closeText	设置关闭按钮的文本	字符串	"关闭 [X]"
closeOnClick	如果启用，用户可以通过点击通知栏来隐藏它	布尔值	true
closeOnOver	如果启用，用户可以通过鼠标悬停在通知栏上来隐藏它	布尔值	false
waitingForClose	如果启用，通知栏将直到用户点击关闭按钮后才关闭	布尔值	true
onBeforeShow	显示之前的回调函数	函数	null
onShow	显示时的回调函数	函数	null
onHide	隐藏时的回调函数	函数	null
onBeforeHide	隐藏之前的回调函数	函数	null
position	设置通知栏的位置，可能的值是 "top" 或 "bottom"	字符串	"top"

4. 项目安装方式

如前所述，使用 Bower 进行安装：

> bower install jqnotifybar

确保您已经安装了 Node.js 和 Bower，然后运行上述命令以安装 jQuery Notify Bar。安装完成后，您可以在项目中引用它并按照使用说明进行配置和使用。