notification-service-js
v0.6.2
Published
Notification Service based on Custom Elements
Downloads
126
Maintainers
Readme
Notification Service
Notification Service provides a simple show/hide message. It is based on CustomElements and may be integrated with any framework. Push notification works through CustomEvent dispatcher. Notification Service supports all popular browsers, including Internet Explorer 11, although some polyfills are required for IE 11. Please see here.
Installation
npm
npm install notification-service-js
yarn
yarn add notification-service-js
Usage
// As a module
import 'notification-service-js'
// As a <script> tag
<script src="node_modules/notification-service-js/build/notification-service.js"></script>
// Insert web component into the DOM
<notification-service></notification-service>
Push notification
CustomEvent.DISPATCH('WEB_COMP_SHOW_NOTIFICATION', {
type: 'success', // success, error, warning
message: 'Your message has been sent',
timer: 3000 // default 5000, not required
})
Options
CustomEvent.DISPATCH('EVENT_NAME', options)
type
Type: string
Values: success, error, warning
A class which will be added to the notification content .web-nc-content.<type>
. Depends on the class CSS styles will be applied to the content. You can add your own type and add styles through the prop cross-img-src
.
message
Type: string
Content which will be displayed inside notification.
timer
Type: number
Default: 5000
Time in milliseconds how long notification will be showing.
Props
cross-img-src
The path to an image (png/svg/jpg) file, which will be used for a cross icon.
<notification-service cross-img-src="../images/cross.svg"></notification-service>
style-src
The path to .css file, which will be pasted after common styles.
<notification-service style-src="build/style.css"></notification-service>
Contributing
Any contributions you make are greatly appreciated.
Please read the Contributions Guidelines before submitting a PR.
License
MIT © Vasyl Stokolosa