🔔 Alert..!! Get 2 Month Free Cloud Hosting With $200 Bonus From Digital Ocean ACTIVATE DEAL

A lightweight and simple-to-use jQuery multiple selection (dual list box) plugin which enables the user to move options between two select boxes a button-based interface.

Multiple-Select Dual-List-Box

Documentation

jQuery-Multi-Selection

This is a small jQuery plugin with out many feature but able to work with dynamic added content by JavaScript.

There are many much powerful jQuery plugin for "multiselect" box existing on github (for detail pls refenenec from the end of this page). However, some of them cannot be worked on the dynamic content added by javascipt/jQuery and this is the reason why i write this for a project.

Demonstration

Please reference to demo/index.html in this repository or visit http://www.soyosolution.com/tools/jquery_multi_selection/index.html

Getting Started

Prerequisites

JavaScript library jQuery is required to used.

Installing

Add these few lines to your webpage to import required CSS and JavaScript:

<link rel="stylesheet" type="text/css" href="res/css/jquery-multi-selection.css" /> <script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script> <script src="res/scripts/jQueryMultiSelection.js"></script> 

Copy the html

<div class="jp-multiselect">     <div class="from-panel">         <select name="from[]" class="form-control" size="8" multiple="multiple"></select>     </div>    <div class="move-panel">1         <button type="button" class="btn btn-default btn btn-default btn-move-all-right"></button>         <button type="button" class="btn btn-default btn btn-default btn-move-selected-right"></button>         <button type="button" class="btn btn-default btn btn-default btn-move-all-left"></button>         <button type="button" class="btn btn-default btn btn-default btn-move-selected-left"></button>     </div>     <div class="to-panel">         <select name="to[]" class="form-control" size="8" multiple="multiple"></select>     </div>     <div class="control-panel">         <button type="button" class="btn btn-default btn btn-default btn-delete"></button>         <button type="button" class="btn btn-default btn btn-default btn-up"></button>         <button type="button" class="btn btn-default btn btn-default btn-down"></button>     </div> </div> 

Initial plugin

<script> $(".jp-multiselect").jQueryMultiSelection(); </script> 

An example you can reference is index.html in this repository.

Reminder

If you enabled dynamic added content feature, remember run the code in server (or localhost) otherwise would got this error :

Access to XMLHttpRequest at 'file:///C:/Users/xxx/jQuery-Multi-Selection-master/jQuery-Multi-Selection-master/dist/list.json?format=json' from origin 'null' has been blocked by CORS policy: Cross origin requests are only supported for protocol schemes: http, data, chrome, chrome-extension, https. 

Configuration

You can pass an object to this plugin for configuration, an example:

$("#dynamic-form").jQueryMultiSelection({     ajaxSourceUrl : "http://www.soyosolution.com/tools/jquery_multi_selection/github/dist/list.json",     enableDynamicAddContent : true, }); 

Parameters

Let's look on list of all available parameters:

Parameter Type Default Description
enableDynamicAddContent boolean false If you want add content dynamicly (load json), set as true
ajaxSourceUrl string ../dist/list.json Extental json file path.
btnGetJson jQuery selector string #btn-ajax Text display on button which execute dynamicly add json.
selectMeunFrom jQuery selector string .from-panel select Select menu on left panel.
selectMeunTo jQuery selector string .to-panel select Select menu on right panel.
btnMoveAllRight jQuery selector string .btn-move-all-right Button element for user move all items from left panel to right panel.
btnMoveSelectedRight jQuery selector string .btn-move-selected-right Button element for user move selected item from left panel to right panel.
btnMoveAllLeft jQuery selector string .btn-move-all-left Button element for user move all items from right panel to left panel.
btnMoveSelectedLeft jQuery selector string .btn-move-selected-left Button element for user move selected item from right panel to left panel.
btnDelete jQuery selector string .btn-delete Button element to delete selected item in right panel
btnMoveUp jQuery selector string .btn-up Button element to changing the order: move up
btnMoveDown jQuery selector string .btn-down Button element to changing the order: move down
htmlMoveAllRight string ›› Text display on button which move all items to right panel.
htmlMoveSelectedRight string › Text display on button which move selected item to right panel.
htmlMoveAllLeft string ‹‹ Text display on button which move all items to left panel.
htmlMoveSelectedLeft string ‹ Text display on button which move selected item to left panel.
htmlDelete string Delete Text display on button execute delete action.
htmlMoveUp string Up Text display on button execute move up action.
htmlMoveDown string Down Text display on button execute move down action.

Built With

Authors

  • Adrian Crisan - Initial work - crlcu
  • Xenia L.C Law - This amendment - xenialaw

License

This project is licensed under the MIT License - see the LICENSE file for details


You May Also Like