Vertical list style item selection
Facebook style item selection
This is a jQuery plugin to allow users to select multiple items from a predefined list, using autocompletion as they type to find each item. You may have seen a similar type of text entry when filling in the recipients field sending messages on facebook.
Features:
- Intuitive UI for selecting multiple items from a large list
- Layout controlled fully in CSS, easily customizable
- Result caching reduces server load
- No images required, just the plugin’s .js file and some CSS
- Handles json search data for auto-completion
- Smooth animations when results load
- Select items using the mouse or keyboard
Usage:
- Make sure you have jquery script included on your page
- Include jquery.tokeninput.js on your page
- Include one of the provided stylesheets, or make your own
- Create a server-side script (php/rails/django anything goes) to generate the search results.
The script itself can fetch data from wherever you like, for example a database or a hardcoded list, but it must do the following: - Take exactly one GET parameter named “q” which will contain the query string. E.g. http://www.example.com/myscript?q=query
- Output JSON search results in the following format:
[{"id":"856","name":"House"}, {"id":"1035","name":"Desperate Housewives"}, {"id":"1048","name":"Dollhouse"}, {"id":"1113","name":"Full House"} ]
- Turn text inputs into tokeninputs using jQuery and point them to your results script:
<script type="text/javascript"> $(document).ready(function () { $("#my-text-input").tokenInput("/url/to/your/script/"); }); </script>
- A list of selected item ids is created inside the original text entry, process them as usual when the form is submitted.
No comments:
Post a Comment