README.md

Bootstrap Tags Input

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

This version has been modified for BootsFaces.

Current stable version: v0.8.1

Usage

Examples can be found here.

Features

• Objects as tags
• True multi value
• Typeahead
• Designed for Bootstrap 3.3.7

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 custom typeahead when using Bootstrap 3.

Development

Install dependencies:

npm install
grunt install

Test:

grunt test

Build:

grunt build

Note that the last test of Phantom.js seems to be flaky. Running it multiple time usually makes it pass.

Current Library Versions:

• Bootstrap: 3.3.7
• jQuery: 2.1.4
• Typeahead: 0.11.1

Libraries for testing go in the /lib directory.

History

• 0.7.2

  • Copy the Bootstrap CSS classes to the outer container
  • use a clone of the input field (instead of creating an empty one, which used to strip it of every CSS class, style, listener and so on)

• 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.