npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

jb-payment-input

v3.1.2

Published

payment input web component

Downloads

97

Readme

jb-payment-input

payment input web component for 16 digit card number and shaba number with this benefit:

  • easy to add custom regex or function validation.

  • multiple validation with different message.

  • support both RTL and LTR.

  • add label and message in UX friendly format.

  • customizable ui with css variable so you can have multiple style in different scope of your app.

  • will accept persian/arabic number char and convert them to english char

  • you can add iran bank image beside input to show which bank card number is inputted.

  • support smart paste so user can copy text that contains irrelevant words beside card number but we will extract card number from the text.

this superset component on jb-input , just for payment info input with extra filter and ready to use validator

Demo

Demo & Sample in codepen: https://codepen.io/javadbat/pen/rNvWdve

instructions

install

using npm

1- install npm package

npm i jb-payment-input

2- import module in one of your js in page

import 'jb-payment-input';

3- use component in your html or jsx file like any other html tag

<jb-payment-input input-type="CARD" class="" label="card number:" message="subtitle of input box"></jb-payment-input>

using cdn

1- add script tag to your html file.

<script src="https://unpkg.com/jb-input/dist/jb-input.umd.js"></script>
<script src="https://unpkg.com/jb-payment-input/dist/jb-payment-info.umd.js"></script>

2- use web component like any other html tag whenever you need

<div class="some-app-div">
  <jb-payment-input input-type="CARD" class="" label="card number:" message="subtitle of input box"></jb-payment-input>
</div>

get/set value

//get value
const inputValue = document.getElementByTagName('jb-payment-input').value;
//set value
document.getElementByTagName('jb-payment-input').value = "new string";

add bank icons

for card number input you can add bank icon in the start or end of input (currently only support iran banks) so when user type first 6 digit of card number it will show bank logo.
to make this happen you just have to import and add bank-indicator web component

import 'jb-payment-input/bank-indicator';
//or for umd import in some edge cases
import 'jb-payment-input/dist/bank-indicator/bank-indicator.umd.js';

set custom style

| css variable name | description | | ----------------- | ----------- | | --bank-indicator-padding | bank logo padding,the default value is 8px 16px|

 <jb-payment-input input-type="CARD" class="" label="card number:" message="with bank indicator">
   <bank-indicator slot="end-section"></bank-indicator>
 </jb-payment-input>

you can set slot with end-section or start-section for position.
if you want to use bank-indicator outside of jb-payment-input you can set prefix attribute with 6 digit number of bank card number.

   <!-- for example for melli card -->
   <bank-indicator prefix="603799"></bank-indicator>

events

this component use jb-input events for example you can use these events or more:

document.getElementByTagName('jb-payment-input').addEventListener('change',(event)=>{console.log(event.target.value)});
document.getElementByTagName('jb-payment-input').addEventListener('keyup',(event)=>{console.log(event.target.value)});
document.getElementByTagName('jb-payment-input').addEventListener('keydown',(event)=>{console.log(event.target.value)});
document.getElementByTagName('jb-payment-input').addEventListener('keypress',(event)=>{console.log(event.target.value)});
document.getElementByTagName('jb-payment-input').addEventListener('input',(event)=>{console.log(event.target.value)});
document.getElementByTagName('jb-payment-input').addEventListener('beforeinput',(event)=>{console.log(event.target.value)});
// when user press enter on keyboard(dispatched on onKeyup)
document.getElementByTagName('jb-payment-input').addEventListener('enter',(event)=>{console.log(event.target.value)});

separator (divider) string

payment input by default use space to separate part of card number or shaba number. for example it will show 1234123412341234 as 1234 1234 1234 1234 but you can change it to what char or even string you want for example divide it by - and you will see 1234-1234-1234-1234.
to make this happen you just have to set separator attribute in html or set separatorString property with js.

<jb-payment-input separator="-" input-type="CARD"></jb-payment-input>

or

document.getElementByTagName('jb-payment-input').separatorString = "";

validation

you can set custom validation to your input like any other jb design system component by

    const validationList = [
        {
            validator: /.{3}/g,
            message: 'عنوان حداقل باید سه کاکتر طول داشته باشد'
        },
        //you can use function as a validator too
        {
            validator: ({displayValue,value})=>{return value !== "50413731111111"},
            message: 'this id card in banned'
        },
        {
            validator: ({displayValue,value})=>{
                if(value.startsWith('11111111')){
                    return 'we dont accept foo bank cards'
                }
                if(displayValue.startsWith('2222 2222')){
                    return 'we dont accept bar bank cards'
                }
                if(value.startsWith('3333')){
                    return false
                }
                return true
            },
            message: 'default message when return false'
        },
    ]
    document.getElementByTagName('jb-payment-input').validation.list = validationList;

other attribute

you may use all jb-input attribute + below attributes

| attribute name | description | | ------------- | ------------- | | input-type | CARD for 16 card number and SHABA to type shaba number input | | separator | separation char. default is (space) but you can set any text you want like - or _ |

set custom style

in some cases in your project you need to change default style of web-component for example you need zero margin or different border-radius and etc.
if you want to set a custom style to this web-component all you need is to set css variable in parent scope of web-component. since jb-payment-input use jb-input underneath, read jb-input custom style list

Other Related Docs: