README.md

Bootstrap Tags Input is a jQuery plugin providing a Twitter Bootstrap user interface for managing tags.

Current stable version: v0.9.0

As the original repo is unmaintained, I have pulled in various bugfixes from other forks and made numerous fixes myself.

I am not using this any more and will not be maintaining it See the original repo or other projects

Usage

Examples can be found here.

Features

• Objects as tags
• True multi value
• Typeahead
• Designed for Bootstrap 2.3.2 and 3

Objects as tags

Not just support for using strings! This means you can use different values for a tag's label and value. Each tag also holds a reference to the object by which it was created, so by calling tagsinput('items') an array of the original items is returned.

True multi value support

Other implementations just concatenate the values to a comma separated string. This results in val() returning just this string, and when submitting the form, only one big, concatenated value is sent in the request.

Bootstrap Tags Input provides true multivalue support. Just use a <select multiple /> as your input element, and val() will return an array of the tag values. When submitting the form, an array of values will be sent with the request.

Typeahead support

Integrates with Twitter Bootstraps' 2.3.2 typeahead, or use custom typeahead when using Bootstrap 3.

Development

Install dependencies:

npm install
grunt install

Test:

grunt test

Build:

grunt build

Current Library Versions:

• Bootstrap: 3.3.5
• jQuery: 2.1.4
• Typeahead: 0.11.1

Libraries for testing go in the /lib directory.

History

• 0.9.0
  • From iivmok : Fix typeaheadjs examples
  • From OlehBoiko : Make case sensitivity optional
  • From OlehBoiko : Allow specifying of delete keys like confirm keys
  • From xhaggi : add support for latest version of bootstrap3-typeahead v4.0.2 and bloodhound v0.11.1
  • From ObjectivityLtd (some hunks) : Handle special characters
  • Switch from using event.which to event.key as which is deprecated
  • Support pasting into the input
  • Suppress default behaviour of confirm key
  • Fix bug with cancelConfirmKeysOnEmpty behaviour being opposite to what it says
  • Use Home and End to navigate the tab list
  • Fix bug passing typeaheadjs arguments
  • Angular Directive
    • From xper : Expose maxTags, maxChars, trimValue, allowDuplicates
    • Directive no longer overrides tagsinputs default options
• 0.8.0
  • Add possibility skip "change" event after "add", "remove", "removeAll"
  • Please add version to header of non-minified version.
• 0.7.1
  • allowDuplicates not working
  • tag text appears when typeahead input looses focus
  • Remove duplicate method removeAll in manual
• 0.7.0
  • .tt-menu etc. styles should be included in bootstrap-tagsinput.css by default
  • Comma character carried over to new tag input when used as separator
  • Emails in multi select are being duplicated
  • The 'itemAdded' Event run on Load the Page!
• 0.6.1
  • Source maps fix
• 0.6.0
  • Allow form submissions when pressing enter if field is empty. Controlled by option
  • Ability to set different or multiple delimiters
  • No longer triggering itemRemoved when the field is already empty
• 0.5
  • Added an optional 3rd parameter to the "add" and "remove" methods
• 0.4
  • Fix typeahead when using Bootstrap 3
• 0.3.13
  • #5: Trigger events on original input/select
  • Loads of fixes merged with help of @janvt, @rlidwka and @kuraga: thanks for helping me out!
• 0.3.9
  • #48: Type ahead stops when entering second character
• 0.3.8
  • #43: Add support for placeholder
  • #46: ie 8 compatibility, replace indexOf method
• 0.3.7
  • #39: flash when duplicate is entered
• 0.3.6
  • #34: Error in ReloadPage
• 0.3.5
  • #10: confirmKeys option
• 0.3.4
  • #24: Add bsTagsInput angular directive & example for bootstrap3 with typeahea...
  • #28: Limit number of tags, enable/disable input
  • #33: Avoid conflict with other selects when checking for value presence

License

This project is licensed under MIT.