Growl4Rails 项目下载及安装教程

1. 项目介绍

Growl4Rails 是一个用于 Ruby on Rails 应用程序的 JavaScript 组件，提供了类似 Growl 的通知功能。该项目基于 Prototype 和 Scriptaculous JavaScript 库构建，适用于需要在 Rails 应用中实现类似 Growl 通知效果的开发者。

2. 项目下载位置

Growl4Rails 项目的源代码托管在 GitHub 上。你可以通过以下命令从 GitHub 仓库中克隆项目：

git clone https://github.com/jfiorato/growl4rails.git

3. 项目安装环境配置

3.1 环境要求

• Ruby on Rails 2.1 或更高版本
• Prototype 1.6 或更高版本
• Scriptaculous 1.7 或更高版本

3.2 环境配置示例

以下是一个简单的环境配置示例，展示了如何在 Rails 项目中配置 Prototype 和 Scriptaculous 库。

4. 项目安装方式

4.1 安装步骤

1. 克隆项目：

   git clone https://github.com/jfiorato/growl4rails.git
   

2. 安装到 Rails 项目中：

   • 如果你使用的是 Rails 2.1 或更高版本，可以直接通过以下命令安装：

     script/plugin install git://github.com/jfiorato/growl4rails.git
     

   • 如果你使用的是较旧版本的 Rails，可以手动安装：

     cd vendor/plugins
     git clone --depth 1 git://github.com/jfiorato/growl4rails.git
     mkdir -p public/javascripts/growl4rails
     mkdir -p public/stylesheets/growl4rails
     mkdir -p public/images/growl4rails
     cp growl4rails/public/javascripts/* public/javascripts/growl4rails/
     cp growl4rails/public/stylesheets/* public/stylesheets/growl4rails/
     cp growl4rails/public/images/* public/images/growl4rails/
     

5. 项目处理脚本

5.1 在视图中使用 Growl4Rails

在 Rails 视图中，你可以通过以下代码引入 Growl4Rails：

<%= growl4rails_includes %>

默认情况下，Growl 通知的持续时间为 5000 毫秒，最多显示 3 个 Growl 通知。如果你需要自定义这些参数，可以使用以下代码：

<%= growl4rails_includes(3000, 5) %>

5.2 显示 Growl 通知

在需要显示 Growl 通知的地方，可以使用以下 JavaScript 代码：

<script type="text/javascript" language="javascript">
    Growl4Rails.showGrowl({
        image_path: "/images/download.png",
        title: "Foo Bar.pdf",
        message: "File is ready for download."
    });
</script>

5.3 处理 Growl 点击事件

如果你需要处理 Growl 通知的点击事件，可以使用以下代码：

<script type="text/javascript" language="javascript">
    var growl_id = Growl4Rails.showGrowl({
        image_path: "/images/download.png",
        title: "Foo Bar.pdf",
        message: "File is ready for download."
    });
    document.observe(growl_id + ':clicked', function(event) {
        console.log('Growl %s was clicked', Event.findElement(event).id);
    });
</script>

通过以上步骤，你就可以成功下载、安装并使用 Growl4Rails 项目了。