CoreUI for Vue.js logo
Angular JavaScript / Vanilla JS React.js
  • undefinedGetting started
  • undefinedCustomize
  • undefinedLayout
  • undefinedForms
  • undefinedComponents
  • undefinedTemplates
  • undefinedMigration
  • undefined
  • undefined
  • undefined
undefinedDownloadundefinedHire Us Get CoreUI PRO

Support CoreUI Development

CoreUI is an MIT-licensed open source project and is completely free to use. However, the amount of effort needed to maintain and develop new features for the project is not sustainable without proper financial backing.

You can support our Open Source software development in the following ways:

  • Buy the CoreUI PRO, and get access to PRO components, and dedicated support.
  • Hire Us! We create stunning designs, high-conversion landing pages, functional mobile apps and reliable web services – everything you need to offer your products or services online and always stay a tap away from your customers.
  • Give us a star ⭐️ on Github.

Vue Placeholder Component

Use loading vue placeholders for your components or pages to indicate something may still be loading.

Other frameworks

CoreUI components are available as native Angular, Bootstrap (Vanilla JS), and React components. To learn more please visit the following pages.

  • Angular Placeholder
  • Bootstrap Placeholder
  • React Placeholder

About #

Placeholders can be used to enhance the experience of your application. They're built only with HTML and CSS, meaning you don't need any JavaScript to create them. You will, however, need some custom JavaScript to toggle their visibility. Their appearance, color, and sizing can be easily customized with our utility classes.

Example #

In the example below, we take a typical card component and recreate it with placeholders applied to create a "loading card". Size and proportions are the same between the two.

In the example below, we take a typical card component and recreate it with placeholders applied to create a "loading card". Size and proportions are the same between the two.

Card title

Some quick example text to build on the card title and make up the bulk of the card's content.

Placeholder

<CCard style="width: 18rem">
  <CCardImage orientation="top" :src="$withBase('/images/vue.jpg')" />
  <CCardBody>
    <CCardTitle>Card title</CCardTitle>
    <CCardText>
      Some quick example text to build on the card title and make up the bulk of the card's
      content.
    </CCardText>
    <CButton color="primary" href="#">Go somewhere</CButton>
  </CCardBody>
</CCard>
<CCard style="width: 18rem">
  <CCardImage component="svg" orientation="top" width="100%" height="162" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="Placeholder" preserveAspectRatio="xMidYMid slice" focusable="false">
    <title>Placeholder</title><rect width="100%" height="100%" fill="#868e96"></rect>
  </CCardImage>  
  <CCardBody>
    <CCardTitle v-c-placeholder="{animation: 'glow', xs: 7}">
      <CPlaceholder :xs="6" />
    </CCardTitle>
    <CCardText v-c-placeholder="{animation: 'glow'}">
      <CPlaceholder :xs="7" />
      <CPlaceholder :xs="4" />
      <CPlaceholder :xs="4" />
      <CPlaceholder :xs="6" />
      <CPlaceholder :xs="8" />
    </CCardText>
    <CButton v-c-placeholder="{xs: 6}" color="primary" aria-hidden="true" disabled href="#" tabindex="-1"></CButton>
  </CCardBody>
</CCard>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

How it works #

Create placeholders with the <CPlaceholder> component and a grid column propx (e.g., :xs="6") to set the width. They can replace the text inside an element or be added as a modifier class to an existing component.

We apply additional styling to CButtons via ::before to ensure the height is respected. You may extend this pattern for other situations as needed, or add a &nbsp; within the element to reflect the height when actual text is rendered in its place.

<p aria-hidden="true">
  <CPlaceholder :xs="6" />
</p>
<CButton v-c-placeholder="{xs: 4}" color="primary" aria-hidden="true" disabled href="#" tabindex="-1"></CButton>
1
2
3
4
The use of aria-hidden="true" only indicates that the element should be hidden to screen readers. The loading behavior of the placeholder depends on how authors will actually use the placeholder styles, how they plan to update things, etc. Some JavaScript code may be needed to *swap* the state of the placeholder and inform AT users of the update.

Width #

You can change the width through grid column classes, width utilities, or inline styles.

<CPlaceholder :xs="6" />
<CPlaceholder class="w-75" />
<CPlaceholder style="width: 30%" />
1
2
3

Color #

By default, the <CPlaceholder> uses currentColor. This can be overridden with a custom color or utility class.

<CPlaceholder :xs="12" />

<CPlaceholder color="primary" :xs="12" />
<CPlaceholder color="secondary" :xs="12" />
<CPlaceholder color="success" :xs="12" />
<CPlaceholder color="danger" :xs="12" />
<CPlaceholder color="warning" :xs="12" />
<CPlaceholder color="info" :xs="12" />
<CPlaceholder color="light" :xs="12" />
<CPlaceholder color="dark" :xs="12" />
1
2
3
4
5
6
7
8
9
10

Sizing #

The size of <CPlaceholder>s are based on the typographic style of the parent element. Customize them with size prop: lg, sm, or xs.

<CPlaceholder :xs="12" size="lg"/>
<CPlaceholder :xs="12"/>
<CPlaceholder :xs="12" size="sm"/>
<CPlaceholder :xs="12" size="xs"/>
1
2
3
4

Animation #

Animate placeholders with animation="glow" or animation="wave" to better convey the perception of something being actively loaded.

<CPlaceholder component="p" animation="glow">
  <CPlaceholder :xs="12" />
</CPlaceholder>  

<CPlaceholder component="p" animation="wave">
  <CPlaceholder :xs="12" />
</CPlaceholder> 
1
2
3
4
5
6
7

API #

CPlaceholder #

import { CPlaceholder } from '@coreui/vue'
// or
import CPlaceholder from '@coreui/vue/src/components/placeholder/CPlaceholder'
1
2
3

Props #

Prop nameDescriptionTypeValuesDefault
animationSet animation type to better convey the perception of something being actively loaded.string'glow', 'wave'-
colorSets the color context of the component to one of CoreUI’s themed colors.string'primary', 'secondary', 'success', 'danger', 'warning', 'info', 'dark', 'light'
componentComponent used for the root node. Either a string to use a HTML element or a component.string-'span'
sizeSize the component extra small, small, or large.string'xs', 'sm', 'lg'-
xsThe number of columns on extra small devices (<576px).number--
smThe number of columns on small devices (<768px).number--
mdThe number of columns on medium devices (<992px).number--
lgThe number of columns on large devices (<1200px).number--
xlThe number of columns on X-Large devices (<1400px).number--
xxlThe number of columns on XX-Large devices (≥1400px).number--
On this page
  • About
  • Example
  • How it works
    • Width
    • Color
    • Sizing
    • Animation
  • API
    • CPlaceholder
  • GitHub
  • Twitter
  • CoreUI (Vanilla)
  • CoreUI for Angular
  • CoreUI for React.js

CoreUI for Vue is Open Source UI Components Library for Vue.js.

CoreUI code licensed MIT, docs CC BY 3.0. CoreUI PRO requires a commercial license.