{"id":25492236,"url":"https://github.com/athm-fe/select","last_synced_at":"2025-11-08T21:30:24.761Z","repository":{"id":57099850,"uuid":"118088481","full_name":"athm-fe/select","owner":"athm-fe","description":null,"archived":false,"fork":false,"pushed_at":"2018-01-31T11:36:56.000Z","size":19,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-02-10T08:08:41.344Z","etag":null,"topics":["jquery","select"],"latest_commit_sha":null,"homepage":"https://athm-fe.github.io/select/","language":"JavaScript","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/athm-fe.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":"2018-01-19T06:49:12.000Z","updated_at":"2018-01-29T01:22:58.000Z","dependencies_parsed_at":"2022-08-22T23:10:23.230Z","dependency_job_id":null,"html_url":"https://github.com/athm-fe/select","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/athm-fe%2Fselect","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/athm-fe%2Fselect/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/athm-fe%2Fselect/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/athm-fe%2Fselect/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/athm-fe","download_url":"https://codeload.github.com/athm-fe/select/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239561517,"owners_count":19659475,"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","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":["jquery","select"],"created_at":"2025-02-18T22:29:12.576Z","updated_at":"2025-11-08T21:30:24.705Z","avatar_url":"https://github.com/athm-fe.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Select\n\n## TODO\n\n* 键盘功能支持 Up、Down、Enter、ESC\n* 多选支持\n\n## Usage\n\n可以通过两种方式来初始化 Select 控件, 你可以根据自己的需要来进行选择.\n\n### Via data attributes\n\n无需写 JavaScript , 即可启用下拉框.\n\n```html\n\u003cdiv class=\"select\" data-toggle=\"select\"\u003e\n  \u003cdiv class=\"select__picker\" data-select-picker\u003e\n    \u003cspan class=\"select__value\" data-select-value\u003e选择品牌\u003c/span\u003e\n    \u003ci class=\"select__caret\"\u003e\u003c/i\u003e\n  \u003c/div\u003e\n  \u003cdiv class=\"select__dropdown\" data-select-dropdown\u003e\n    \u003cul\u003e\n      \u003cli data-value=\"1\" data-text=\"阿斯顿·马丁1\"\u003e\u003cb\u003eA\u003c/b\u003e\u003cspan\u003e阿斯顿·马丁1\u003c/span\u003e\u003c/li\u003e\n      \u003cli data-value=\"2\" data-text=\"阿斯顿·马丁2\"\u003e\u003cb\u003eA\u003c/b\u003e\u003cspan\u003e阿斯顿·马丁2\u003c/span\u003e\u003c/li\u003e\n      \u003cli data-value=\"3\" data-text=\"阿斯顿·马丁3\"\u003e\u003cb\u003eA\u003c/b\u003e\u003cspan\u003e阿斯顿·马丁3\u003c/span\u003e\u003c/li\u003e\n      \u003cli data-value=\"4\" data-text=\"阿斯顿·马丁4\"\u003e\u003cb\u003eB\u003c/b\u003e\u003cspan\u003e阿斯顿·马丁4\u003c/span\u003e\u003c/li\u003e\n      \u003cli data-value=\"5\" data-text=\"阿斯顿·马丁5\"\u003e\u003cb\u003eC\u003c/b\u003e\u003cspan\u003e阿斯顿·马丁5\u003c/span\u003e\u003c/li\u003e\n      \u003cli data-value=\"6\" data-text=\"阿斯顿·马丁6\"\u003e\u003cb\u003eD\u003c/b\u003e\u003cspan\u003e阿斯顿·马丁6\u003c/span\u003e\u003c/li\u003e\n    \u003c/ul\u003e\n  \u003c/div\u003e\n\u003c/div\u003e\n```\n\n### Via JavaScript\n\n直接在对应的下拉框 DOM 上调用即可.\n\n```javascript\n$('#select').select(options);\n```\n\n## Options\n\n参数可以通过 data attributes 或者 JavaScript 两种方式来配置.\n\nName | Type | Default | Description\n---- | ---- | ------- | -----------\nselectPicker | string | `'[data-select-picker]'` | 触发容器\nselectValue | string | `'[data-select-value]'` | 值容器\nselectDropdown | string | `'[data-select-dropdown]'` | 下拉容器\nselectedClass | string | `'selected'` | 选中选项使用的样式类.\ndisabledClass | string | `'disabled'` | 下拉框禁用状态样式类.\nactiveClass | string | `'active'` | 下拉框激活状态样式类.\n\n## Methods\n\n### `.select(options)`\n\n初始化当前 DOM 内容为一个下拉框, 可以接受参数进行配置.\n\n```javascript\n$('#select').select({});\n```\n\n### `.select('show')`\n\n手动打开对话框.\n\n```javascript\n$('#select').select('show');\n```\n\n### `.select('hide')`\n\n手动关闭对话框.\n\n```javascript\n$('#select').select('hide');\n```\n\n### `.select('toggle')`\n\n手动打开或者关闭.\n\n```javascript\n$('#select').select('toggle');\n```\n\n### `.select('disable')`\n\n禁用.\n\n```javascript\n$('#select').select('disable');\n```\n\n### `.select('enable')`\n\n非禁用.\n\n```javascript\n$('#select').select('enable');\n```\n\n### `.data('fe.select').setValue({})`\n\n设置值\n\n### `.data('fe.select').getValue()`\n\n获取值\n\n## Event\n\nEvent Type | Description\n---------- | -----------\ninit.fe.select | 下拉框初始化时触发.\nshow.fe.select | 当 `show` 方法被调用, 此事件会立即触发.\nshown.fe.select | 下拉框已呈现完毕时触发.\nhide.fe.select | 当 `hide` 方法被调用, 此事件会立即触发.\nhidden.fe.select | 下拉框已隐藏完毕时触发.\nchange.fe.select | 当值发生变化时触发. 回调函数接受参数为 `event` , 当前选项值 `data` (`{text: '', value: ''}`) 和当前选项 `$item` 。\n\n```javascript\n$('#select').on('show.fe.select', function (e) {\n  // 阻止下拉框打开\n  e.preventDefault();\n});\n```\n\n# End\n\nThanks to [Bootstrap](http://getbootstrap.com/)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fathm-fe%2Fselect","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fathm-fe%2Fselect","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fathm-fe%2Fselect/lists"}