@dile/dile-spinner

Web Component dile-spinner to create the typical loading spinner with a CSS animation

Usage no npm install needed!

<script type="module">
  import dileDileSpinner from 'https://cdn.skypack.dev/@dile/dile-spinner';
</script>

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>