@shawon3719/vue-bank-card-input

Vue Bank Card Input

Vue Component for user data entry of the bank card

Demonstration is available here.

Installation

npm i --save @shawon3719/vue-bank-card-input

or

yarn add @shawon3719/vue-bank-card-input

You can import the library and styles, then use it as a Vue plugin to enable the functionality globally on all components.

import Vue from "vue"
import VueBankCard from "@shawon3719/vue-bank-card-input"
import "@shawon3719/vue-bank-card-input/dist/vue-bank-card-input.css"

Vue.component("VueBankCard", VueBankCard)

Basic usage

<VueBankCard is-new />

Properties

Name	Required	Type	Default	Description
card_number_label	no	String	"Card number"	You can use your locale text
expiration_label	no	String	"MM/YY"	You can use your locale text
cvv_label	no	String	"CVV"	You can use your locale text
card_number_placeholder	no	String	"Enter Card Number"	You can use your locale text
number_required	no	String	"You need to fill this field"	You can use your locale text
expiration_invalid	no	String	"Date invalid"	You can use your locale text
cvv_invalid	no	String	"Invalid data"	You can use your locale text
number	no	String, Object	""	Number of card
isSmall	no	Boolean	false	View card controller: base or small
isNew	no	Boolean	false	View card controller: saved or new
disableDelete	no	Boolean	false	Disable delete option on small card
errors	no	Object	{}	Errors from outside the component. From server etc.
isReset	no	Boolean	false	Trigger for reset form
isFocus	no	Boolean	false	Card number field focus when component mounted (available if isNew is true)
imagesBasePath	no	String	default	Base path and banks or payment systems logotypes

Events

Name	Type	Parameters	Description
enter	Function	event - Event of keydown	Handler of keydown on enter event
clear-errors	Function	errors - Object of errors	Clearing errors from outside
reset	Function	isReset - State of isReset property, type Boolean	Turn off isReset property
delete-card	Function	event - Event of click	Handler of click on trash button
getCardInfo	Function	event - get all input data

Example

<template>
  <VueBankCard
    is-small
    is-new
    is-focus
    :errors="errors"
    :is-reset="resetForm"
    @enter="onEnter"
    @clear-errors="clearErrors"
    @reset="resetForm = $event"
  ></VueBankCard>
</template>

<script>
export default {
  data() {
    return {
      errors: {
          cardNumber: "Enter valid card",
          expDateMonth: "Card has been expired",
          cvv: "Invalid CVV"
      },
      resetForm: false
    }
  },
  methods: {
    onEnter(event) {
      event.preventDefault();
      console.log(event);
    },
    clearErrors(errors) {
      this.errors = { ...errors };
    }
  }
}
</script>

Use your own logotypes

By default banks logos provided from CDN: https://cdn.jsdelivr.net/gh/shawon3719/vue-bank-card-input@master/public/images/%image_path%.

If you want to use your own logotypes you can pass base images path by prop images-base-path. For example:

<template>
  <VueBankCard
    is-new
    :images-base-path="imagesPath"
  ></VueBankCard>
</template>

<script>
export default {
  data() {
    return {
      imagesPath: "//your-own-cdn-or-host.com/path/to/assets/"
    }
  },
}
</script>

Now path to logotype would be //your-own-cdn-or-host.com/path/to/assets/banks-logos/ru-sberbank.png.

So you must have two folders in your defined path:

• banks-logos - Must contain bank logos;
• brands-logos - Must contain payment systems (VISA, Master Card, etc) logos.

Name of files with logotypes should be the same that come with this package.

Testing

For package testing we use jest framework and docker-ce + docker-compose as develop environment. So, just write into your terminal after repository cloning:

$ make install
$ make test

Changes log

Changes log can be found here.

Support

If you will find any package errors, please, make an issue in current repository.

License

This is open-sourced software licensed under the MIT License.