1.1.1 • Published 4 years ago

dile-top-message v1.1.1

Weekly downloads
4
License
MIT
Repository
github
Last release
4 years ago

Moved

This package has moved and is now available at @dile/dile-message. Please update your dependencies. This repository is no longer maintained.

\

Web Component to show a custom message to the user. This component display the message until the user clicks in the included close icon. There are some posible ways to set the message and open the message interface. Also there is an animation when the message opens and closes.

You may see different implementations running in the demos page.

This webcomponent is based on LitElement and follows the open-wc recommendation.

Installation

npm i dile-top-message

Usage

<script type="module">
  import 'dile-top-message/dile-top-message.js';
</script>

<dile-top-message opened>Hi from Polydile!!</dile-top-message>

Also is posible to set the display message in the "message" property, and open the interface with the open() method.

<dile-top-message message="This is other message" id="msgElement"></dile-top-message>

<script>
document.addEventListener("DOMContentLoaded", function(event) {
  document.getElementById('msgElement').open();
});
</script>

Another possibility is to simply call the openMessage() method, setting the message in the method parameter.

<dile-top-message id="msgElement"></dile-top-message>

<script>
document.addEventListener("DOMContentLoaded", function(event) {
  document.getElementById('msgElement').openMessage('Setting a message and opening the interface in one step');
});
</script>

Properties

  • opened: If true the feedbak box is in opened status.
  • message: Message to display. Remember that, if message='' or undefined, then the component will display the content comming from the slot.

Events

  • dile-top-message-closed-by-user: This event is dispatched when the component closes by a user click on the close icon.

Style customization

You can customize the message box interface by using the CSS custom properties bellow.

Custom propertyDescriptionDefault
--dile-top-message-colorMessage text and icon color#fff
--dile-top-message-background-colorMessage background color#666
--dile-top-message-paddingPadding for the message box15px
--dile-top-message-icon-sizeClose icon size20px