README
@dile/dile-spinner
A pack of web components to implement the tipical "Ajax loading" spinner interface.
Installation
npm i @dile/dile-spinner
<dile-spinner>
The simpler implementation. Useful to show a inline spinner element, localized in the place where you put the dile-spinner element.
Usage
Import the component.
import '@dile/dile-spinner/dile-spinner.js';
Use it inside your HTML.
<dile-spinner active></dile-spinner>
Properties
- active: Boolean. Defines the spinner visibility. The spinner only appears when active is true.
Styling
| Custom property | Description | Default |
|---|---|---|
| --dile-spinner-color | The ajax loading color | #888 |
| --dile-spinner-dot-size | The size of the dots in the spinner animation | 6px |
<dile-spinner-modal>
This is an adaptation of the dile-spinner element using a modal box, blocking the interface of the rest of the page when the spinner is active.
Usage
Similar as dile-spinner implementation.
Import the component.
import '@dile/dile-spinner/dile-spinner-modal.js';
Use it inside your HTML.
<dile-spinner-modal active></dile-spinner-modal>
Styling
In addition to the dile-spinner properties:
| Custom property | Description | Default |
|---|---|---|
| --dile-spinner-modal-background-color | The modal layer background color | rgba(255, 255, 255, 0.8) |
| --dile-spinner-modal-box-color | Color of a small layer rounding the spinner element for higher contrast and visibility | rgba(0, 0, 0, 0.9) |
<style>
.customized {
--dile-spinner-color: #3ca;
--dile-spinner-dot-size: 10px;
--dile-spinner-modal-background-color: #505050;
--dile-spinner-modal-box-color: #fff;
}
</style>
<dile-spinner-modal active class="customized" id="spinnerModal"></dile-spinner-modal>