{"id":30873750,"url":"https://github.com/jonesiscoding/xq-select","last_synced_at":"2025-10-19T21:20:38.081Z","repository":{"id":56966744,"uuid":"49017024","full_name":"jonesiscoding/xq-select","owner":"jonesiscoding","description":"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.","archived":false,"fork":false,"pushed_at":"2020-08-13T20:13:51.000Z","size":245,"stargazers_count":0,"open_issues_count":2,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-20T03:38:31.243Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jonesiscoding.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-01-04T19:04:37.000Z","updated_at":"2020-03-23T18:44:30.000Z","dependencies_parsed_at":"2022-08-21T06:10:24.598Z","dependency_job_id":null,"html_url":"https://github.com/jonesiscoding/xq-select","commit_stats":null,"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/jonesiscoding/xq-select","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonesiscoding%2Fxq-select","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonesiscoding%2Fxq-select/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonesiscoding%2Fxq-select/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonesiscoding%2Fxq-select/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jonesiscoding","download_url":"https://codeload.github.com/jonesiscoding/xq-select/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonesiscoding%2Fxq-select/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274113046,"owners_count":25224334,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-07T02:00:09.463Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-09-07T23:50:09.781Z","updated_at":"2025-10-19T21:20:33.044Z","avatar_url":"https://github.com/jonesiscoding.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"xqSelect\n=========\n\nThe 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.\n\nThere are a great many excellent jQuery plugins that do similar things, and credit goes to these authors for the original idea.\n\nxqSelect is differs similar plugins in a few small ways:\n\n* Intentionally feature sparse to reduce size and complications.  \n* Under 8KB minified - 4KB if you're only using the CSS (see below).\n* The original select box is still used, and is not hidden or moved of screen.\n\n## Documentation\n\nThe 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.\n\n## Usage and Demo\n\nA basic demo may be seen on [BootPly](http://www.bootply.com/tl9ZiekMCQ).  A more complete demo should be available soon.\n\nUsage is simple:\n```\n\u003cdiv class=\"xq-select\"\u003e\n  \u003cselect id=\"xqSelectDemo\"\u003e\n    \u003coptgroup label=\"Group One\"\u003e\n      \u003coption value=\"1\" data-subtext=\"First Thing\"\u003eItem One\u003c/option\u003e\n      \u003coption value=\"2\"\u003eItem Two\u003c/option\u003e\n      \u003coption value=\"3\"\u003eItem Three\u003c/option\u003e\n      \u003coption value=\"4\"\u003eItem Four\u003c/option\u003e\n    \u003c/optgroup\u003e\n    \u003coption value=\"5\"\u003eItem Five\u003c/option\u003e\n    \u003coption value=\"6\"\u003eItem Six\u003c/option\u003e\n    \u003coption value=\"7\"\u003eItem Seven\u003c/option\u003e\n    \u003coption value=\"8\"\u003eItem Eight\u003c/option\u003e\n  \u003c/select\u003e\n\u003c/div\u003e\n```\nThis 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 ```\u003chead\u003e``` and the JS goes just before your closing ```\u003c/body\u003e``` tag.\n\nTo automatically switch to a native select with *most* mobile devices, include the attribute **data-mobile=\"true\"** in the ```\u003cdiv class=\"xq-select\"\u003e``` tag.\n\n## Browser Compatibility\n\nOne 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.  \n\nAs of this moment, it is expected that the following browsers are fully supported:\n\n| Browser  | Version | Platform | Status\n| ------------- | ------------- | ------------- | ------------- |\n| Chrome  | ?* | Win/Mac/Linux | Supported |\n| Firefox | ?* | Win/Mac/Linux | Supported |\n| Opera | 15+ | Win/Mac/Linux | Supported |\n| Safari | 6.2+ | Mac | Supported |\n| Safari | iOS 8/9+ | iOS | CSS Only |\n| Chrome | iOS 8/9+ | iOS | CSS Only |\n| Chrome | Android 5.0+ | Android | CSS Only |\n| Firefox | Android 5.0+ | Android | CSS Only |\n| Internet Explorer | 8 | Win | Supported |\n| Internet Explorer | 9/10 | Win | Supported |\n| Internet Explorer | 11 | Win | Supported |\n| Edge | All | Win | Supported |\n\nThe following browser are still expected to work:\n\n| Browser  | Version | Platform | Status\n| ------------- | ------------- | ------------- | ------------- |\n| Opera  | 11/12 | Win/Mac/Linux | Needs Testing |\n| Opera | 10 | Win/Mac/Linux | Unsupported |\n| Safari  | 5.1.4+ | Mac | Needs Testing |\n| Safari | iOS 6.1 - 7 | iOS | Needs Testing** |\n| Android Browser | Android 5.0+ | Android | Needs Testing** |\n| Opera Mini | All | All | Needs Testing** |\n| Internet Explorer | All | Windows Phone | Needs Testing** |\n\nNo intention is present to support IE7, Opera 10, Safari 4, or 'ancient' versions of self-updating browsers such as Firefox and Chrome.  \n\nMobile 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 ```\u003cselect\u003e``` 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.\n\nFor additional browser compatibility, see [jQuery Browser Support](https://jquery.com/browser-support/) and [Bootstrap Supported Browsers](http://getbootstrap.com/getting-started/#support-browsers)\n\n\\*   Need to find the lowest version xqSelect works with.\n\n\\*\\*  Needs testing.  Only CSS components are expected to work.\n\n## Bugs and feature requests\n\nAnyone is welcome to contribute. Please read the important information below regarding opening issues!\n\n* [Bug reports](CONTRIBUTING.md#bug-reports)\n* [Feature requests](CONTRIBUTING.md#feature-requests)\n\n## Copyright and License\n\nCopyright (C) 2014-2016 ExactQuery\n\nLicensed under [the MIT license](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonesiscoding%2Fxq-select","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjonesiscoding%2Fxq-select","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonesiscoding%2Fxq-select/lists"}