https://github.com/karakanb/vue-info-card

Simple and beautiful card component with an elegant spark line, for VueJS.
https://github.com/karakanb/vue-info-card

card card-component component info-card spark vue vue-components vuejs vuejs2

Last synced: about 1 month ago
JSON representation

Simple and beautiful card component with an elegant spark line, for VueJS.

• Host: GitHub
• URL: https://github.com/karakanb/vue-info-card
• Owner: karakanb
• License: mit
• Created: 2017-08-27T22:30:42.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2023-01-27T10:23:50.000Z (over 1 year ago)
• Last Synced: 2024-04-14T10:55:00.635Z (5 months ago)
• Topics: card, card-component, component, info-card, spark, vue, vue-components, vuejs, vuejs2
• Language: JavaScript
• Homepage: https://karakanb.github.io/vue-info-card/
• Size: 2.24 MB
• Stars: 191
• Watchers: 9
• Forks: 23
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        


  





  Simple and beautiful card component with an elegant spark line, for VueJS.





  

  

  

  



## Demo

Live demo of the component can be found [here.](https://karakanb.github.io/vue-info-card/)

## Installation

`npm i -S vue-info-card`

## Usage

After the installation, the component can be used by passing the appropriate props for displaying the data and messages. A sample usage within a single file component is as follows:

```html

  


    

  


import InfoCard from 'vue-info-card';

export default {

  components: {

    InfoCard,

  },

  data() {

    return {

      front: {

        title: 'Daily Conversion Value',

        graphData: [3, 2, 5, 9, 5, 10, 3, 5, 0, 0, 1, 8, 2, 9, 0],

      },

      back: {

        title: 'Monthly Summary',

        message: 'Your average daily conversion value for this month is <b>50.4$</b>. It is below the average of the last six months.',

      },

    };

  },

};

```

### Props

There are basically three different props for each faces of the card. A face requires a type, such as `graph` or `text`, a title, and a data to display in the body of the card. 

The props are as follows:

| prop         | Type                | Optional? | Default                | Description                                                                                                                                                  |

|--------------|---------------------|--------------|------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|

| `frontType`  | `String`            | :white_check_mark:          | `'text'`               | Type of the front face of the card. Available options are `graph` or `text`.                                                                                 |

| `frontTitle` | `String`            | :white_check_mark:          | `'Default Card Title'` | Title of the front face of the card.                                                                                                                         |

| `frontData`  | `String` or `Array` | :x:           |  | Data that will be displayed on the front face of the card. If `frontType` is set to `graph`, this must be an array; otherwise, a string. |

| `frontTrendGradients`  | `Array` | :white_check_mark:           | `['#4facfe', '#00f2fe']`                       | Gradient that will be used on the spark line, expected to be an array of color hexas as strings. |

| `backType`   | `String`            | :white_check_mark:          | `'text'`               | Type of the back face of the card. Available options are `graph` or `text`.                                                                                  |

| `backTitle`  | `String`            | :white_check_mark:          | `'Default Card Title'` | Title of the back face of the card.                                                                                                                         |

| `backData`   | `String` or `Array` | :x:           |                        | Data that will be displayed on the back face of the card. If `frontType` is set to `graph`, this must be an array; otherwise, a string. |

| `backTrendGradients`  | `Array` | :white_check_mark:           | `['#4facfe', '#00f2fe']` | Gradient that will be used on the spark line, expected to be an array of color hexas as strings. |

Note that both `frontData` and `backData` props accept HTML as input, which means you can inject elements to the card body directly.

## Credits

The component is based on two main features: spark line and flip effect. The spark line is created with the amazing [vuetrend](https://github.com/QingWei-Li/vue-trend) component, which creates cool and customizable graphs. The flipping effect is implemented in pure CSS, and influenced from the tutorial [here](https://davidwalsh.name/css-flip). 

## Browser Support

The component supports all of the modern browsers, with least versions: Firefox 37, Chrome 42, Safari 8, Opera 29, and IE 10.

## License

The project is under MIT License.