@shapla/vanilla-components

0.4.0 • Public • Published

Shapla Components

IMPORTANT: Shapla Components is a work in progress and subject to major changes until 1.0 release.

A collection of reusable components using vanilla javaScript.

Table of contents

Installation

Install using npm package manager

npm i @shapla/vanilla-components

or using yarn package manager

yarn add @shapla/vanilla-components

Usage

Here we export all components script as ES module and all style as SCSS mixins. So you need to import SCSS mixin to load style of component and also need to import ES module and register as vue component.

For example, to use button and progress bar components:

Styles (SCSS)

// Add the following line at top of your scss file
@use "@shapla/vanilla-components/src/index.scss" as shapla;

@include shapla.spinner;
@include shapla.notification;
// Include other mixins as your requirement

Javascript Instantiation

import {Spinner, Notify} from "@shapla/vanilla-components";

List of Components

Loading Spinner

A loading spinner component using vanilla javaScript.

Include SCSS mixin

// Add the following line at top of your scss file
@use "@shapla/vanilla-components/src/index.scss" as shapla;

@include shapla.spinner;

Import javaScript module

import {Spinner} from "@shapla/vanilla-components";

// Show spinner
Spinner.show();

// Show single spinner with 'Loading...' text
Spinner.show({single: true, showText: true});

// Hide spinner
Spinner.hide();

Available Props for Spinner.show() method

Property Type Required Default Description
single Boolean no false If set true, only primary color will be shown for all layers.
showText Boolean no false If set true, Loading... text will be show beside spinner.
loadingText String no Loading... Loading text
position String no fixed Value can be fixed, absolute, or static.
size String no default Value can be default, small, or medium or large.
Notification

A simple notification component using vanilla javaScript.

Include SCSS mixin

// Add the following line at top of your scss file
@use "@shapla/vanilla-components/src/index.scss" as shapla;

@include shapla.delete-icon;
@include shapla.notification;

Import javaScript module

import {Notify} from "@shapla/vanilla-components";

// Show success notification
Notify.success('Message content');

// You can also include title and timeout
Notify.success('Message content', 'Success!', 5000);

Notify API

  • Notify.info(message, title, timeout);
  • Notify.success(message, title, timeout);
  • Notify.warning(message, title, timeout);
  • Notify.error(message, title, timeout);
Property Type Required Default Description
message String yes `` Notification message
title String no `` Notification title
timeout Number no 4000 The popup timeout in milliseconds
Dialog

A simple dialog component for confirm/alert dialog using vanilla javaScript.

Include SCSS mixin

// Add the following line at top of your scss file
@use "@shapla/vanilla-components/src/index.scss" as shapla;

@include shapla.modal;

Import javaScript module

import {Dialog} from "@shapla/vanilla-components";

// Show confirm dialog
Dialog.confirm('Are you sure to delete the item?').then(() => {
    // User confirmed to delete the item
});

// Show alert dialog
Dialog.alert('A simple alert message like native JavaScript alert');

Package Sidebar

Install

npm i @shapla/vanilla-components

Weekly Downloads

0

Version

0.4.0

License

MIT

Unpacked Size

141 kB

Total Files

45

Last publish

Collaborators

  • sayful