PHPackages                             exactquery/xq-select - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. exactquery/xq-select

Abandoned → [deviscoding/xq-select](/?search=deviscoding%2Fxq-select)Library

exactquery/xq-select
====================

Cross browser <select> implementation using CSS, JQuery, and Twitter Bootstrap.

4.0.1(5y ago)02161[2 issues](https://github.com/jonesiscoding/xq-select/issues)MITCSSCI failing

Since Mar 7Pushed 5y ago1 watchersCompare

[ Source](https://github.com/jonesiscoding/xq-select)[ Packagist](https://packagist.org/packages/exactquery/xq-select)[ Docs](https://github.com/jonesiscoding/xq-select)[ RSS](/packages/exactquery-xq-select/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (10)Dependencies (3)Versions (28)Used By (0)

xqSelect
========

[](#xqselect)

The xqSelect package is intended to make HTML5 form selects look and act the same cross browser and platform. A jQuery plugin, CSS and Bootstrap's dropdown.js are used to style and bring additional functionality to normal select boxes.

There are a great many excellent jQuery plugins that do similar things, and credit goes to these authors for the original idea.

xqSelect is differs similar plugins in a few small ways:

- Intentionally feature sparse to reduce size and complications.
- Under 8KB minified - 4KB if you're only using the CSS (see below).
- The original select box is still used, and is not hidden or moved of screen.

Documentation
-------------

[](#documentation)

The documentation for xqSelect is a work in progress and will be updated as possible. For now, please see the basic demo and usage explanation below.

Usage and Demo
--------------

[](#usage-and-demo)

A basic demo may be seen on [BootPly](http://www.bootply.com/tl9ZiekMCQ). A more complete demo should be available soon.

Usage is simple:

```

      Item One
      Item Two
      Item Three
      Item Four

    Item Five
    Item Six
    Item Seven
    Item Eight

```

This does, of course, presume that you have included the distribution JS and CSS somewhere in your HTML page. It's recommended that stylesheet go in the `` and the JS goes just before your closing `` tag.

To automatically switch to a native select with *most* mobile devices, include the attribute **data-mobile="true"** in the `` tag.

Browser Compatibility
---------------------

[](#browser-compatibility)

One of my biggest goals for xqSelect is cross browser compatibility. Reports on issues with a specific browser and platform are encouraged. See below for guidelines.

As of this moment, it is expected that the following browsers are fully supported:

BrowserVersionPlatformStatusChrome?\*Win/Mac/LinuxSupportedFirefox?\*Win/Mac/LinuxSupportedOpera15+Win/Mac/LinuxSupportedSafari6.2+MacSupportedSafariiOS 8/9+iOSCSS OnlyChromeiOS 8/9+iOSCSS OnlyChromeAndroid 5.0+AndroidCSS OnlyFirefoxAndroid 5.0+AndroidCSS OnlyInternet Explorer8WinSupportedInternet Explorer9/10WinSupportedInternet Explorer11WinSupportedEdgeAllWinSupportedThe following browser are still expected to work:

BrowserVersionPlatformStatusOpera11/12Win/Mac/LinuxNeeds TestingOpera10Win/Mac/LinuxUnsupportedSafari5.1.4+MacNeeds TestingSafariiOS 6.1 - 7iOSNeeds Testing\*\*Android BrowserAndroid 5.0+AndroidNeeds Testing\*\*Opera MiniAllAllNeeds Testing\*\*Internet ExplorerAllWindows PhoneNeeds Testing\*\*No intention is present to support IE7, Opera 10, Safari 4, or 'ancient' versions of self-updating browsers such as Firefox and Chrome.

Mobile browsers are marked as *CSS Only* because their native selects should be used whenever possible to ensure the best user experience. Ideally, CSS rules will still ensure that the `` looks uniform across browsers, but when clicked the native select will take over. See [usage](#usage-and-demo) above for how to make this happen.

For additional browser compatibility, see [jQuery Browser Support](https://jquery.com/browser-support/) and [Bootstrap Supported Browsers](http://getbootstrap.com/getting-started/#support-browsers)

\* Need to find the lowest version xqSelect works with.

\*\* Needs testing. Only CSS components are expected to work.

Bugs and feature requests
-------------------------

[](#bugs-and-feature-requests)

Anyone is welcome to contribute. Please read the important information below regarding opening issues!

- [Bug reports](CONTRIBUTING.md#bug-reports)
- [Feature requests](CONTRIBUTING.md#feature-requests)

Copyright and License
---------------------

[](#copyright-and-license)

Copyright (C) 2014-2016 ExactQuery

Licensed under [the MIT license](LICENSE).

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~67 days

Recently: every ~195 days

Total

25

Last Release

2100d ago

Major Versions

v1.x-dev → 2.02017-10-18

2.0.1 → 3.02017-12-01

3.3.4 → 4.02020-03-23

### Community

Maintainers

![](https://www.gravatar.com/avatar/d57a7df632f0f3297af28804aa4d48a6c9bbd67795056353fb3dd8c7ed7e1cb5?d=identicon)[jonesiscoding](/maintainers/jonesiscoding)

---

Top Contributors

[![jonesiscoding](https://avatars.githubusercontent.com/u/5215554?v=4)](https://github.com/jonesiscoding "jonesiscoding (51 commits)")

---

Tags

sassbootstrapselectreplacementexactquery

### Embed Badge

![Health badge](/badges/exactquery-xq-select/health.svg)

```
[![Health](https://phpackages.com/badges/exactquery-xq-select/health.svg)](https://phpackages.com/packages/exactquery-xq-select)
```

###  Alternatives

[snapappointments/bootstrap-select

The jQuery plugin that brings select elements into the 21st century with intuitive multiselection, searching, and much more. Now with Bootstrap 4 support.

9.8k480.4k3](/packages/snapappointments-bootstrap-select)[twbs/bootstrap-sass

bootstrap-sass is a Sass-powered version of Bootstrap 3, ready to drop right into your Sass powered applications.

12.5k1.8M17](/packages/twbs-bootstrap-sass)[istvan-ujjmeszaros/bootstrap-duallistbox

A responsive dual listbox widget optimized for Twitter Bootstrap. It works on all modern browsers and on touch devices.

628199.4k2](/packages/istvan-ujjmeszaros-bootstrap-duallistbox)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)