Skip to content

The Ultimate fully-customizable plugin for skeleton cards in Vue. It's a no-brainer. (Vue 2)

Notifications You must be signed in to change notification settings

neelansh15/vue-ultimate-skeleton-cards

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Vue Ultimate Skeleton Cards

Check out the guide and demo for full information. This is just an overview.

Vue Ultimate Skeleton Cards (Or VUSC for short) is a cool customizable skeleton card plugin for VueJS.
It gives you two ways of defining a skeleton card that suits your needs.

New loading animation

The cards have a unique loading animation which is different from the legacy skeleton cards you have seen till now.
There is more eye-catching movement in these cards to captivate your viewers.

MadeWithVueJs.com shield

Installation

Run either one in your Vue directory:

yarn add vue-ultimate-skeleton-cards
or
npm install vue-ultimate-skeleton-cards

Usage

In main.js add the following along with other imports:

import SkeletonCards from 'vue-ultimate-skeleton-cards'
Vue.use(SkeletonCards)

The name with which you import doesn't matter.

In your component template, you can use any of the two components without registering them:

<SkeletonCard />

or

<SkeletonScaffold>
//Your custom layout
</SkeletonScaffold>

There are two globally available components for you to use:

  • SkeletonCard - Quickly create a card and define its structure with just a small string of numbers
  • SkeletonScaffold - Full control over the card's layout with custom Vue directives and your own basic CSS

SkeletonCard

This is the easist to get started with. It provides by default a dark mode Skeleton Card for which you can customize various properties like color, animation, structure, etc.

Examples

Note: Animations can't play in this file. Check out the guide for a working demo.

<SkeletonCard />

<SkeletonCard primary="#112233" structure="701120333" animDisable />

SkeletonCard Props List

Prop name Type Description Default
primary String Primary color of your card #242424
padding String Padding 2em 3em
borderRadius String Border radius of the card rounded by default 20px
contrast Number Contrast between the card color and color of the inner blocks 10
animDisable Boolean Disable the animation or not false
animDuration String Animation duration 1.5s
animTimingFunction String Timing function for the animation with a bezier curve or the predefined css ease, ease-in, ease-out, ease-in-out CSS default
structure String Define your structure with a string of numbers 1120333304

The Structure prop

The structure prop is a unique and super-easy way to define a basic vertical structure with a string of numbers each corresponding to a specific element type (for example a profile logo or header bar).

Here is the mapping of the numbers:

Number Corresponds to Properties
7 Card Image (Pinned to the top) Always add in the beginning of the prop's string and only once
0 <br /> Break line Breaks or adds new line. Useful for spacing
1 Box Type 1 Suitable for Titles
Height: 1.5em
Width: 90%
Color: Darker by 10 or 20 points depending on contrast
2 Box Type 2 Suitable for Subtitles
Height: 1.3em
Width: 70%
Color: Darker by 3 or 10 points depending on contrast
3 Box Type 3 Suitable for General content
Height: 1.1em
Width: 50%-90% (Random)
Color: Darker or Lighter by 10 points depending on contrast
4 Rounded Button Border-radius: 20px
5 Rectangular Button Border-radius: 0px
6 Circle Suitable for profile images in skeleton card
Border-radius: 100%

SkeletonScaffold

This component gives you full control over the layout of your skeleton card. It does so by providing global Vue directives which you can use with <div /> tags inside of the SkeletonScaffold component to generate the required boxes, circles, etc.

The colors of the generated elements will derive from the SkeletonScaffold component's primary prop. So setting the color once in the component will reflect on all the child components (See table below). To make the elements lighter or darker than the parent, use the v-mLight and v-mDark directives.

This way of scaffolding with vue directives is especially useful as you can use CSS to make this in any way you want, including using CSS Grids to get a proper layout in place.

Example

<SkeletonScaffold primary="purple" animDisable>
    <div v-mCardImg></div> <!-- Card Image -->
    <br />
    
    <div v-mSquare style="border-radius: 100%"></div> <!-- Profile image -->
    <br />

    <div v-mBox v-mDark style="height: 1.5em"></div> <!-- Heading -->
    <div v-mBox v-mDark style="height: 1.5em"></div> <!-- Heading -->
    <div v-mBox style="height: 1.3em; width: 60%"></div> <!-- Sub-Heading -->
    <br />

    <!-- Content Boxes -->
    <div v-mBox v-mLight v-mRandomWidth></div>
    <div v-mBox v-mLight v-mRandomWidth></div>
    <div v-mBox v-mLight v-mRandomWidth></div>
    <div v-mBox v-mLight v-mRandomWidth></div>
    <br />

    <!-- Default Rectangular Button -->
    <div v-mButton></div>
</SkeletonScaffold>

SkeletonScaffold Props List

SkeletonScaffold takes almost the same props as the SkeletonCard component except that it doesn't have the structure and contrast prop.

SkeletonScaffold Props

Prop name Type Description Default
primary String Primary color of your card #242424
padding String Padding "2em 3em"
borderRadius String Border radius of the card rounded by default 20px
animDisable Boolean Disable the animation or not false
animDuration String Animation duration 1.5s
animTimingFunction String Timing function for the animation with a bezier curve or the predefined css ease, ease-in, ease-out, ease-in-out CSS default

For the structure itself, use the pre-defined global directives below inside the component.
Here is the list of global directives available for use with div elements:

Base Directives

Vue Directive Properties Default Color Default Dimensions (Width, Height)
v-mBox Simple box useful for text content like title, subtitle or general content Darker than parent by 3 points 100%, 1.1em
v-mSquare Square. Useful for profile images. Can be rounded to make a circle Darker than parent by 10 points 3em, 3em
v-mButton Button Darker than parent by 5 points 5em, 2em
v-mCardImg Pins to the top. Big square for main image in a vertical card. Darker than parent by 10 points 100%, 10em

Moreover, mBox and mSquare have default bottom margin of 0.5em

Utility Directives

Vue Directive Property
v-mLight Lighten element by 10 points*
v-mDark Darken element by 10 points*
v-mRandomWidth Assign a random width between 50%-90%

* = With reference to parent element's color

Contributing

Contributions in the form of issues / pull requests are welcome. If you wish to discuss something with me, hit me up on twitter 😃

Reach out

Github: @neelansh15
Twitter: @mneelansh15
LinkedIn: neelanshmathur

Made with ❤️ by Neelansh Mathur