0.1.5 • Published 5 years ago

react-dynamic-input v0.1.5

Weekly downloads
19
License
(ISC OR GPL-3.0)
Repository
github
Last release
5 years ago

Create Multiple Inputs!

react-dynamic-input allows you to create multiple inputs that each have their own unique state that you define. It also comes with a built in onSubmit button which takes a function that you ceate. Add it to a form or whatever user input you need!

Installation & Usage

  1. npm i react-dynamic-input

  2. Add DynamicInput to your components like this:

import DynamicInput from "react-dynamic-input"

class YourComponent extends React.Component {
  render() {
    return <DynamicInput />
  }
}

props for the <DynamicInput/>:

NameRequiredDefaultTypeDescription
inputNameyesstringThe key you would like to be assigned to the state of each of the inputs that are created [{ [inputName]: ""}]
addButtonTextno"Add Input"stringThe text you would like to appear on the button to create another input
setInputyesFunctionThe setState function you would like to be executed when a user types into the input (setState, or useState)
inputyes[]ArrayThe state you will pass to the component. Must be the shape of [{ [inputName]: ""}]
onSubmitnoFunctionThe onSubmit function you would like to execute when a user submits the form. If nothing is provided there will be no button and you can add your own.
submitButtonTextno"Submit"stringThe text you would like to appear on the submit button
addPositionno"top"stringThe position you would like the "Add Input" button to be. "top" will make it above the inputs, "bottom" will place it below and next to the submit button
typeno"text"stringThe type of input you would like to use
removeTextno"Remove"stringThe text you would like to have in the remove input button
placeholderNumberednofalsebooleanIf you would like the placeholder text to have a number after the text, set this to true
toolTipnofalsebooleanYou can have a tooltip pop up when you scroll your mouse over the add button
toolTipTextnostringThe text you would like to appear in the tooltip above the add button
labelno""stringIf you would like a label for the inputs you can put the text here (will appear as an <h4></h4 element above the inputs)

Example

import React, { useState } from "react"
import DynamicInput from "react-dynamic-input"

const App = () => {
  const [input, setInput] = useState([{ name: "" }])

  const showState = () => {
    alert(input.map(item => item.name))
  }
  return (
    <div>
      <DynamicInput
        inputName="name"
        addButtonText="Add Another Input"
        setInput={setInput}
        input={input}
        onSubmit={showState}
        submitButtonText="Submit"
        addPosition="bottom"
        type="text"
        placeholderNumbered={true}
        toolTip={true}
        toolTipText="Add another input"
        label="My Input"
      />
      {input.map((item, index) => (
        <p key={(index + 1) * 2}>{item.name}</p>
      ))}
    </div>
  )
}

export default App

Styling

Each of the Elements in the react-dynamic-input Component can be targeted througn CSS with a className attribute (the entire component can be targeted with an id):

  • Enitre Component:
#DynamicInput {
  /* Add whatever CSS you'd like! */
}
  • Add Button:
.addButton {
  /* Add whatever CSS you'd like! */
}
  • Remove Button:
.removeButton {
  /* Add whatever CSS you'd like! */
}
  • Submit Button:
.submitButton {
  /* Add whatever CSS you'd like! */
}
  • Input:
.dynamicInput {
  /* Add whatever CSS you'd like! */
}
  • Label:
.dynamicLabel {
  /* Add whatever CSS you'd like! */
}
  • Tool Tip:
.dynamicTooltip {
  /* Add whatever CSS you'd like! */
}
.dynamicTooltipText {
  /* Add whatever CSS you'd like! */
}

Wish List:

  • Basic Styling for inputs (Styled Components?)
  • (Possible) Add a submit button for eact of the inputs individually to only submit one thing
  • Tooltip for other buttons?

Contributing

I am open to ideas and improvments! If you have a feature or bug fix open a PR or submit an issue! Thank you! 🛰

0.1.5

5 years ago

0.1.4

5 years ago

0.1.3

5 years ago

0.1.2

5 years ago

0.1.1

5 years ago

0.1.0

5 years ago