TIP JQSelect2Contrib is not installed on Foswiki.org.

JQSelect2Contrib

This extension adds support for the Select2 jQuery widget to Foswiki.

Select2 magically turns an existing select tag into a widget that supports type-ahead find, but it can do much more: selecting multiple values, remote data sources, infinite scrolling... you name it.

For more information about the widget and how to customize it, see its homepage.

Usage

Use %JQREQUIRE{"select2"}% to make use of Select2 on a wiki page. Add the jqSelect2 CSS class to a select tag to make it turn into a Select2 widget.

Example

%JQREQUIRE{"select2"}%

<select class='jqSelect2' data-placeholder='Select a burger' data-width='element'>
<option>Hamburger</option>
<option>Hamburger deluxe with gold plating</option>
<option>Cheeseburger</option>
<option>Joppiburger</option>
</select>

If Select2 is enabled, you will see the result below:

No such plugin select2

Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. Use "Find More Extensions" to get a list of available extensions. Select "Install".

If you have any problems, or if the extension isn't available in configure, then you can still install manually from the command-line. See http://foswiki.org/Support/ManuallyInstallingExtensions for more help.

Info

Change History:  
09 Mar 2015: initial release on foswiki.org (Foswiki:Main/MichaelDaum)
04 Oct 2012: initial check-in of select2 3.2 (Foswiki:Main/JanKrueger)
Dependencies:
NameVersionDescription
Foswiki::Plugins::JQueryPlugin>=4.20Required.
Home page: Foswiki:Extensions/JQSelect2Contrib
Topic revision: r1 - 09 Apr 2015, MichaelDaum - This page was cached on 28 May 2016 - 09:00.

The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. See Copyright Statement. Creative Commons License