scratch – Blame information for rev 125

Subversion Repositories:
Rev:
Rev Author Line No. Line
125 office 1 # Bootstrap Tags Input [![Build Status](https://travis-ci.org/bootstrap-tagsinput/bootstrap-tagsinput.svg?branch=master)](https://travis-ci.org/bootstrap-tagsinput/bootstrap-tagsinput)
2 Bootstrap Tags Input is a jQuery plugin providing a Twitter Bootstrap user interface for managing tags.
3  
4 Current stable version: **v0.8.0**
5  
6 ## Usage
7 Examples can be found [here](http://bootstrap-tagsinput.github.io/bootstrap-tagsinput/examples/).
8  
9 ## Features
10 * Objects as tags
11 * True multi value
12 * Typeahead
13 * Designed for Bootstrap 2.3.2 and 3
14  
15 ### Objects as tags
16 Not just support for using strings! This means you can use different values
17 for a tag's label and value. Each tag also holds a reference to the object
18 by which it was created, so by calling <code>tagsinput('items')</code> an
19 array of the original items is returned.
20  
21 ### True multi value support
22 Other implementations just concatenate the values to a comma separated string.
23 This results in <code>val()</code> returning just this string, and when
24 submitting the form, only one big, concatenated value is sent in the request.
25  
26 Bootstrap Tags Input provides true multivalue support. Just use a
27 <code>&lt;select multiple /&gt;</code> as your input element, and
28 <code>val()</code> will return an array of the tag values. When submitting the
29 form, an array of values will be sent with the request.
30  
31 ### Typeahead support
32 Integrates with Twitter Bootstraps' 2.3.2 typeahead, or use custom typeahead when using Bootstrap 3.
33  
34 ## Development
35 Install dependencies:
36 <pre>
37 npm install
38 grunt install
39 </pre>
40 Test:
41 <pre>
42 grunt test
43 </pre>
44 Build:
45 <pre>
46 grunt build
47 </pre>
48 Current Library Versions:
49  
50 - Bootstrap: 3.3.5
51 - jQuery: 2.1.4
52 - Typeahead: 0.11.1
53  
54 Libraries for testing go in the **/lib** directory.
55  
56 ## History
57 - 0.8.0
58 - [Add possibility skip "change" event after "add", "remove", "removeAll"](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/pull/429)
59 - [Please add version to header of non-minified version.](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/438)
60 - 0.7.1
61 - [allowDuplicates not working](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/419)
62 - [tag text appears when typeahead input looses focus](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/386)
63 - [Remove duplicate method `removeAll` in manual](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/pull/427)
64 - 0.7.0
65 - [.tt-menu etc. styles should be included in bootstrap-tagsinput.css by default](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/426)
66 - [Comma character carried over to new tag input when used as separator](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/422)
67 - [Emails in multi select are being duplicated](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/399)
68 - [The 'itemAdded' Event run on Load the Page!](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/369)
69 - 0.6.1
70 - [Source maps fix](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/371)
71 - 0.6.0
72 - [Allow form submissions when pressing enter if field is empty. Controlled by option](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/368)
73 - [Ability to set different or multiple delimiters](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/397)
74 - [No longer triggering itemRemoved when the field is already empty](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/405)
75 - 0.5
76 - [Added an optional 3rd parameter to the "add" and "remove" methods](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/pull/298)
77 - 0.4
78 - [Fix typeahead when using Bootstrap 3](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/pull/73)
79 - 0.3.13
80 - [#5: Trigger events on original input/select](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/5)
81 - Loads of fixes merged with help of @janvt, @rlidwka and @kuraga: thanks for helping me out!
82 - 0.3.9
83 - [#48: Type ahead stops when entering second character](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/48)
84 - 0.3.8
85 - [#43: Add support for placeholder](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/pull/43)
86 - [#46: ie 8 compatibility, replace indexOf method](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/pull/46)
87 - 0.3.7
88 - [#39: flash when duplicate is entered](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/39)
89 - 0.3.6
90 - [#34: Error in ReloadPage](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/34)
91 - 0.3.5
92 - [#10: confirmKeys option](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/10)
93 - 0.3.4
94 - [#24: Add bsTagsInput angular directive & example for bootstrap3 with typeahea...](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/pull/24)
95 - [#28: Limit number of tags, enable/disable input](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/pull/28)
96 - [#33: Avoid conflict with other selects when checking for value presence](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/pull/33)
97  
98 ## License
99 This project is licensed under [MIT](https://raw.github.com/bootstrap-tagsinput/bootstrap-tagsinput/master/LICENSE "Read more about the MIT license").