jb-input-react v3.0.6

JBInput React

this component is React.js wrapper for jb-input web component.

text input react component 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.

• custom display for password and number input.

• support typescript

##demo image:

install

using npm

npm i jb-input-react

in your jsx file

import {JBInput} from 'jb-input-react';

<JBInput class="" label="لیبل" message="متن ثابت زیر کادر متن"></JBInput>

events

• onChange

    <JBInput onChange={(event) => console.log(event.target.value)}></JBInput>

• onKeyUp

    <JBInput onKeyUp={(event) => console.log(event.target.value)}></JBInput>

• onEnter

    <JBInput onEnter={(event) => console.log(event.target.value)}></JBInput>

• onKeydown

    <JBInput onKeydown={(event) => console.log(event.target.value)}></JBInput>

• onFocus

    <JBInput onFocus={(event) => console.log(event.target.value)}></JBInput>

• onBlur

    <JBInput onBlur={(event) => console.log(event.target.value)}></JBInput>

set validation

you can set validation to your input by creating a validationList array and passing in to validationList props:

    const validationList = [
        {
            validator: /.{3}/g,
            message: 'عنوان حداقل باید سه کاکتر طول داشته باشد'
        },
        #you can use function as a validator too
        {
            validator: (inputedText)=>{return inputedText == "سلام"},
            message: 'شما تنها میتوانید عبارت سلام را وارد کنید'
        },
    ]

    <JBInput validationList={validationList}></JBInput>

check validation

you can check if an input value meet your validation standad by creating a ref of the element using React.createRef().

    const elementRef = React.createRef();
    const isValid = elementRef.current.triggerInputValidation(true).isAllValid;

if isValid is true the value of input is valid.

number input extra feature

if you set type="number" JBInput will add some feature for you. for example your input will only get number chart and wont accept other string and we add 2 + & - button to the input so user can change number without keyboard by just taping on these buttons. you can also use Up and Down arrow keys too increase or decrease number value in your field. JBInput will also let you control some aspect of user input too for example you can limit decimal precision or change increase/decrease step of + - button. too achive this you must call one function and set value you need to change.

number input events

click on + - button will call onChange event.

  const numberFieldParameter = {
        //how many number you want to + or  - on user press buttons or use arrow keys defualt is 1
        step:100,
        // how many decimal input accept defualt is infinty
        decimalPrecision:2,
        // what char replaced to input if user paste some illeglal value defualt is '' (empty string)
        invalidNumberReplacement:'0',
        // separate every 3 number with comma like 1000000 => 1,000,000
        useThousandSeparator:false,
        // which char we use to separate thousand number
        thousandSeparator:',',
        //can input accept negativenumber or not
        acceptNegative:true,
    }

    <JBInput numberFieldParameter={numberFieldParameter}></JBInput>

other props

set custome style

in some cases in your project you need to change defualt 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

number input special style

add custom element in input box

in JBInput you can put icon or any other custom html DOM in input box. to doing so you just have to plae custom DOM in JBInput tag and add slot="start-section" or slot="end-section" to place it before or after input field. for better result i suggest you use JBInput-inbox-element tag but its optional and you can use your own custom tag too. JBInput-inbox-element will add some style to make sure your icon will place in center and will not overflow and make your job easier if you want more controll you can skip it and use your own tag. example:

<JBInput>
    <JBInput-inbox-element slot="end-section">
        <div>after</div>
    </JBInput-inbox-element>
    <JBInput-inbox-element slot="start-section">
        <div>before</div>
    </JBInput-inbox-element>
</JBInput>