Vue Ultimate Skeleton Cards
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.
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% |