AngularJS powered flash notification service for easily showing flash notifications.
- AngularJS 1.3.*
- UI router (if you want to use
Vilautin.flash
withstateName
param)
$ bower install --save angular-vilautin
After installing the package you must add the following snippet to your index.html
...
<body ng-app>
<vilautin-notifications></vilautin-notifications>
...
</body>
And make sure that the module vilautin
is defined as your app's dependency.
// app.js
angular.module('yourAwesomeApp', ['vilautin']);
You need also import styles from bower_components/angular-vilautin/dist/
in order to see the notifications properly.
In order to show notifications, inject Vilautin
to your module and call its functions
angular
.module('yourAwesomeApp')
.controller('SomeCtrl', function(Vilautin) {
var notificationObj = {
message: 'Notication object for more control over notification',
severity: 'warning',
sticky: true
};
Vilautin.flash(notificationObj);
Vilautin.flash('Flash a notification with default params like this!');
});
###Functions
flash(messageString)
: shows a flash notification immediately with default parametersflash(notificationObj)
: shows flash notification according to thenotificationObj
###Notification object
Notification object that is passed to function flash()
and it can have the following properties.
var notificationObj = {
message: 'This text is shown in the notification',
// String ['info', 'success', 'warning'] that defines notification styling
severity: 'warning', // default: 'info'
// Boolean value defining whether the notification is sticky and doesn't
// remove itself
sticky: true, // default: false
// String ui-router state name. This is used for showing notification
// right after state has changed. Must be called in the previous state
stateName: 'loginState' // assumes ui-router is loaded already
}