Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
13cf1d5
commit 07c6cf1
Showing
1 changed file
with
1 addition
and
99 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,99 +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) | ||
Bootstrap Tags Input is a jQuery plugin providing a Twitter Bootstrap user interface for managing tags. | ||
|
||
Current stable version: **v0.8.0** | ||
|
||
## Usage | ||
Examples can be found [here](http://bootstrap-tagsinput.github.io/bootstrap-tagsinput/examples/). | ||
|
||
## 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 <code>tagsinput('items')</code> 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 <code>val()</code> 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 | ||
<code><select multiple /></code> as your input element, and | ||
<code>val()</code> 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: | ||
<pre> | ||
npm install | ||
grunt install | ||
</pre> | ||
Test: | ||
<pre> | ||
grunt test | ||
</pre> | ||
Build: | ||
<pre> | ||
grunt build | ||
</pre> | ||
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.8.0 | ||
- [Add possibility skip "change" event after "add", "remove", "removeAll"](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/pull/429) | ||
- [Please add version to header of non-minified version.](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/438) | ||
- 0.7.1 | ||
- [allowDuplicates not working](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/419) | ||
- [tag text appears when typeahead input looses focus](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/386) | ||
- [Remove duplicate method `removeAll` in manual](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/pull/427) | ||
- 0.7.0 | ||
- [.tt-menu etc. styles should be included in bootstrap-tagsinput.css by default](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/426) | ||
- [Comma character carried over to new tag input when used as separator](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/422) | ||
- [Emails in multi select are being duplicated](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/399) | ||
- [The 'itemAdded' Event run on Load the Page!](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/369) | ||
- 0.6.1 | ||
- [Source maps fix](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/371) | ||
- 0.6.0 | ||
- [Allow form submissions when pressing enter if field is empty. Controlled by option](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/368) | ||
- [Ability to set different or multiple delimiters](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/397) | ||
- [No longer triggering itemRemoved when the field is already empty](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/405) | ||
- 0.5 | ||
- [Added an optional 3rd parameter to the "add" and "remove" methods](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/pull/298) | ||
- 0.4 | ||
- [Fix typeahead when using Bootstrap 3](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/pull/73) | ||
- 0.3.13 | ||
- [#5: Trigger events on original input/select](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/5) | ||
- 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](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/48) | ||
- 0.3.8 | ||
- [#43: Add support for placeholder](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/pull/43) | ||
- [#46: ie 8 compatibility, replace indexOf method](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/pull/46) | ||
- 0.3.7 | ||
- [#39: flash when duplicate is entered](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/39) | ||
- 0.3.6 | ||
- [#34: Error in ReloadPage](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/34) | ||
- 0.3.5 | ||
- [#10: confirmKeys option](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/issues/10) | ||
- 0.3.4 | ||
- [#24: Add bsTagsInput angular directive & example for bootstrap3 with typeahea...](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/pull/24) | ||
- [#28: Limit number of tags, enable/disable input](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/pull/28) | ||
- [#33: Avoid conflict with other selects when checking for value presence](https://github.com/bootstrap-tagsinput/bootstrap-tagsinput/pull/33) | ||
|
||
## License | ||
This project is licensed under [MIT](https://raw.github.com/bootstrap-tagsinput/bootstrap-tagsinput/master/LICENSE "Read more about the MIT license"). | ||
# Bootstrap Templates collection |