Awesome
jQuery Growl
Growl is a jQuery plugin designed to provide informative messages in the browser.
Installation
To install copy the javascripts, and stylesheets directories into your project and add the following snippet to the header:
<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" />
This plugin is also registered under http://bower.io/ to simplify integration. Try:
npm install -g bower
bower install growl
Gemfile
+ source 'https://rails-assets.org'
...
+ gem 'rails-assets-growl'
application.css
/*
...
*= require growl
...
*/
application.js
//= require jquery
...
//= require growl
Examples
Growling is easy:
<script type="text/javascript">
$.growl({ title: "Growl", message: "The kitten is awake!", url: "/kittens" });
$.growl.error({ message: "The kitten is attacking!" });
$.growl.notice({ message: "The kitten is cute!" });
$.growl.warning({ message: "The kitten is ugly!" });
</script>
Advanced Options
Growl also supports some customization through the following options:
- delayOnHover: while hovering over the alert, prevent it from being dismissed (true | false - default: true)
- duration: the duration (in milliseconds) for which the alert is displayed (default: 3200)
- fixed: whether the alert should be fixed rather than auto-dismissed (true | false - default: false)
- location: the alert's position ('tl' | 'tr' | 'bl' | 'br' | 'tc' | 'bc' - default: 'tr')
- size: the alert's size ('small' | 'medium' | 'large' - default: 'medium')
- style: the alert's style ('default' | 'error' | 'notice' | 'warning' - default: 'default')
Deprecations
- static has been renamed to fixed due to minifier incompatabilities
Status
Copyright
Copyright (c) 2010 - 2018 Kevin Sylvestre. See LICENSE for details.