react-ts-tagsinput

A simple and customizable React tags input component written in TypeScript.

Installation

Install the component using npm package manager:

npm i react-ts-tagsinput

Example

import React from "react";
import type { Tag } from 'react-ts-tagsinput';
import { TagsInput } from "react-ts-tagsinput";
// Import default styling (optional)
import 'react-ts-tagsinput/lib/defaultTheme.css';

export default function App() {

  const [tags, setTags] = React.useState<Array<Tag>>(["Tag 1", "Tag 2", "Tag 3", "Tag 4"]);

  const handleTagsChange = React.useCallback((updatedTags: Array<Tag>) => {
    setTags(updatedTags);
  }, []);
  
  return(
    <div className='app'>
      <TagsInput name="myTags" placeholder="Add a tag" value={tags} onChange={handleTagsChange} />
    </div>
  );
  
}

Documentation

Props

Prop	Type	Description	Required	Default
name	string	The name attribute of the input field.	Yes	-
type	string	The type of the input field.	No	text
placeholder	string	The placeholder of the input field.	No	Add a tag
value	Array<Tag>	The array of tags.	Yes	-
allowDuplicates	boolean	Whether to allow duplicate tags or not.	No	false
disabled	boolean	Whether the input field is disabled or not.	No	false
prepend	string	Text to prepend before each tag. Example: #.	No	-
max	number	Limit the maximum number of tags. Set -1 for no limit.	No	-1
addOnBlur	boolean	Whether to add the tag when the user presses tab on the input.	No	false
autoFocus	boolean	Whether to autofocus the inputfield on component mount.	No	false
hideSubmitButton	boolean	Whether to hide the submit button.	No	false
onChange	Function (newTags: Array<Tag>) => void	The callback function that is called whenever there is a change in the tags array.	No	-
inputProps	Object {[key: string]: unknown}	Use this prop to add extra attributes to the input field.	No	-
tagProps	Object {[key: string]: unknown}	Use this prop to add extra attributes to the 'tag' div.	No	-
formProps	Object {[key: string]: unknown}	Use this prop to add extra attributes to the form.	No	-
tagValidation	Function (tag: Tag) => boolean	The validation function to run after each form submit. Return false to prevent adding the tag. You can add any type of validation including regex. Simply pass your validation function to this prop.	No	() => true
tagFilter	Function (tag: Tag) => Tag	The filter function that lets you modify the tag just before it is added. For example, you can use this to remove all the whitespaces from the tag.	No	-

Changelog

https://github.com/nitishkgupta/react-ts-tagsinput/blob/master/CHANGELOG.md

Contributions

Open to feedback and contributions at nitishkgupta/react-ts-tagsinput.