pqselect
v2.2.0
Published
jQuery plugin to select multiple or single options with checkboxes, radio buttons, and jQueryUI theme support.
Downloads
64
Maintainers
Readme
jQuery Multiple Select Plugin
ParamQuery Select (pqSelect)
Copyright (c) 2015–2026 Paramvir Dhindsa
Released under the MIT license
ParamQuery Select is a jQuery plugin that converts ordinary multiple and single <select> lists into a theme‑ready jQuery UI widget. It supports virtual rendering to handle tens of thousands of records without performance loss.
Dependencies
- jQuery ≥ 2.2.x
- jQuery ui ≥ 1.12.x
- Include
jquery-ui.structure.cssand a theme file of your choice (themes are not bundled).
Features
- Checkboxes with options in multiple select lists
- Radio buttons with options in single select lists
- Search box
- Grouping via
<optgroup>tag - Disabled options via
disabledattribute - Keyboard navigation
- Collision/edge detection
- Bootstrap support (v1.3.0)
- ThemeRoller ready
- AMD support (v1.3.0)
- UMD/ESM builds available (v2.2.0)
- Works in major browsers: Edge, Chrome, Firefox, Safari, Opera
Usage
Classic jQuery (UMD)
<link rel="stylesheet" href="jquery-ui.structure.css">
<link rel="stylesheet" href="jquery-ui.theme.css">
<link rel="stylesheet" href="pqselect.min.css">
<script src="jquery.js"></script>
<script src="jquery-ui.js"></script>
<script src="pqselect.min.js"></script>
<script>
$("#mySelect").pqSelect();
</script>ES Module (ESM)
If you are using modern bundlers like Rollup, Webpack, or Vite, you can import pqSelect directly:
import jQuery from "jquery-ui-pack";
import pq from "./pqselect.mjs";
jQuery("#mySelect").pqSelect( options );
//or
pq.select("#mySelect", options);jquery-ui-packis a bundled distribution of jQuery UI packaged as ESM/UMD.pqselect.mjsis the ES Module build that exports thepqnamespace.- Consumers can simply
import pqand use it with jQuery.
Notes
- pqSelect integrates seamlessly with jQuery UI themes.
- For Bootstrap styling, ensure Bootstrap CSS is loaded before pqSelect.
- Virtual rendering is especially useful for large datasets (10k+ options).
