seanwuapps / stencil-loading-spinner

Loading spinner component created using stencil

Stencil Loading Spinner Component

Stencil is a compiler for building fast web apps using Web Components.

Stencil combines the best concepts of the most popular frontend frameworks into a compile-time rather than run-time tool. Stencil takes TypeScript, JSX, a tiny virtual DOM layer, efficient one-way data binding, an asynchronous rendering pipeline (similar to React Fiber), and lazy-loading out of the box, and generates 100% standards-based Web Components that run in any browser supporting the Custom Elements v1 spec.

Stencil components are just Web Components, so they work in any major framework or with no framework at all. In many cases, Stencil can be used as a drop in replacement for traditional frontend frameworks given the capabilities now available in the browser, though using it as such is certainly not required.

Stencil also enables a number of key capabilities on top of Web Components, in particular Server Side Rendering (SSR) without the need to run a headless browser, pre-rendering, and objects-as-properties (instead of just strings).

Get started

Clone this repo and cd into the folder, then run the following commands

npm install
npm start

To view the build, start an HTTP server inside of the /www directory.

To watch for file changes during develop, run:

npm run dev

To build the app for production, run:

npm run build

Usage

Preview

<loading-spinner type="android" color="green"></loading-spinner>
<loading-spinner type="circle" color="#333333"></loading-spinner>
<loading-spinner type="bars" color="orange"></loading-spinner>
<loading-spinner type="bars" color="blue"></loading-spinner>
<loading-spinner type="ios" color="red"></loading-spinner>

stencil-loading-spinner's Issues

Failed to build with latest Stencil

Stencil now defaults to .css
Guidance for sass here: https://www.npmjs.com/package/@stencil/sass

Fixed in this PR: #2

How To Include and Use in Stencil App

Hi there! While I understand that this may not be a direct issue with this particular component, I was curious on how you would include this amazing work in a stencil app and use it. Also, best practices for making it conditionally displayed when content is loading.

Thanks so much for your help!