{"id":15295003,"url":"https://github.com/dwqs/vue-area-linkage","last_synced_at":"2025-04-12T19:48:30.549Z","repository":{"id":43200514,"uuid":"99870319","full_name":"dwqs/vue-area-linkage","owner":"dwqs","description":"省市区联动选择: https://dwqs.github.io/vue-area-linkage/","archived":true,"fork":false,"pushed_at":"2018-10-31T10:32:25.000Z","size":5100,"stargazers_count":480,"open_issues_count":12,"forks_count":95,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-12T19:48:26.990Z","etag":null,"topics":["area","area-linkage","area-picker","china","picker","vuejs2"],"latest_commit_sha":null,"homepage":"","language":"Vue","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/dwqs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-08-10T02:04:01.000Z","updated_at":"2025-03-24T11:40:55.000Z","dependencies_parsed_at":"2022-09-09T16:51:37.858Z","dependency_job_id":null,"html_url":"https://github.com/dwqs/vue-area-linkage","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dwqs%2Fvue-area-linkage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dwqs%2Fvue-area-linkage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dwqs%2Fvue-area-linkage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dwqs%2Fvue-area-linkage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dwqs","download_url":"https://codeload.github.com/dwqs/vue-area-linkage/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248625500,"owners_count":21135513,"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":["area","area-linkage","area-picker","china","picker","vuejs2"],"created_at":"2024-09-30T17:08:16.708Z","updated_at":"2025-04-12T19:48:30.528Z","avatar_url":"https://github.com/dwqs.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"![npm-version](https://img.shields.io/npm/v/vue-area-linkage.svg) ![license](https://img.shields.io/npm/l/vue-area-linkage.svg)\n# vue-area-linkage\n省市区联动选择. 组合数据来源：[area-data](https://github.com/dwqs/area-data)\n\n## Installation\nInstall the pkg with npm:\n```\n// v5之前的版本\nnpm i --save vue-area-linkage\n\n// v5及之后的版本\nnpm i --save vue-area-linkage area-data\n```\nor yarn\n```\n// v5之前的版本\nyarn add vue-area-linkage\n\n// v5及之后的版本\nyarn add vue-area-linkage area-data\n```\n\n## Usage\n```\nimport Vue from 'vue';\nimport { pca, pcaa } from 'area-data'; // v5 or higher\nimport 'vue-area-linkage/dist/index.css'; // v2 or higher\nimport VueAreaLinkage from 'vue-area-linkage';\n\nVue.use(VueAreaLinkage)\n```\n\n```\n// v5之前的版本\n\u003carea-select v-model=\"selected\"\u003e\u003c/area-select\u003e\n\u003carea-cascader v-model=\"selected2\"\u003e\u003c/area-cascader\u003e\n\n// v5及之后的版本\n\u003carea-select v-model=\"selected\" :data=\"pca\"\u003e\u003c/area-select\u003e // 省市\n// 省市区：\u003carea-select v-model=\"selected\" :data=\"pcaa\"\u003e\u003c/area-select\u003e\n\u003carea-cascader v-model=\"selected2\" :data=\"pca\"\u003e\u003c/area-cascader\u003e // 省市\n// 省市区：\u003carea-cascader v-model=\"selected2\" :data=\"pcaa\"\u003e\u003c/area-cascader\u003e\n\n//setting\n\u003carea-select type='all' :level='2' v-model=\"selected\" :data=\"pcaa\"\u003e\u003c/area-select\u003e\n\u003carea-cascader type='all' v-model=\"selected2\" :level='1' :data=\"pcaa\"\u003e\u003c/area-cascader\u003e\n```\n\nMore demo to visit [here](https://dwqs.github.io/vue-area-linkage/).\n\n## On Demand Import\n\u003e version \u003e= 2.1.2\n\n安装 [babel-plugin-on-demand-import](https://github.com/dwqs/babel-plugin-on-demand-import):\n\n```\nnpm i babel-plugin-on-demand-import -D\n```\n\n修改 `.babelrc`:\n\n```\n{\n    // ...\n    \"plugins\": [\n        [\"on-demand-import\" {\n            \"libraryName\": \"vue-area-linkage\",\n            \"libraryPath\": \"dist/lib\"\n        }]\n    ]\n}\n```\n\n```\nimport 'vue-area-linkage/dist/index.css'; // v2 or higher\nimport pcaa from 'area-data/pcaa';\n// Only import AreaCascader component\nimport { AreaCascader } from 'vue-area-linkage';\nVue.use(AreaCascader);\n\n\u003carea-cascader v-model=\"val\" level={1} :data=\"pcaa\"\u003e\u003c/area-cascader\u003e\n\n// Only import AreaSelect component\nimport { AreaSelect } from 'vue-area-linkage';\nVue.use(AreaSelect);\n\n\u003carea-select v-model=\"val2\" level={2} :data=\"pcaa\"\u003e\u003c/area-select\u003e\n```\n\n## 属性\n### area-select 组件\n|  参数  |  类型  |  可选值  |  默认值  |  说明  |\n|  :--:  |  :--:  |  :--:  |  :--:  |  :--:  |\n| type | String |  all/code/text | code | 设置返回的数据格式 |\n| placeholders | Array | - | [] | 设置 placeholder text |\n| level | Number | 0/1/2 | 1 | 设置联动层级(0-只选省份/1-省市联动/2-省市区联动) |\n| size | String | small/medium/large | medium | 设置输入框的大小 |\n| disabled | Boolean | - | false | 是否禁用 |\n| data | Object | - | - | 地区数据(v5需要传入) |\n| icon | String | - | area-select-icon | 自定义下拉小图标 |\n| disableLinkage | Boolean | - | true | 地区选择是否进行联动 |\n\n\u003ev4 仅支持省市区联动，即 v4 不再支持 level 的值为 3(省市区街联动)\n\n### area-cascader 组件\n|  参数  |  类型  |  可选值  |  默认值  |  说明  |\n|  :--:  |  :--:  |  :--:  |  :--:  |  :--:  |\n| type | String |  all/code/text | code | 设置返回的数据格式 |\n| placeholder | String | - | '' | 设置 placeholder text |\n| level | Number | 0/1 | 0 | 设置联动层级(0-省市联动/1-省市区联动) |\n| size | String | small/medium/large | medium | 设置输入框的大小 |\n| separator | String | - | '-' | 显示选中文本的分隔符 |\n| disabled | Boolean | - | false | 是否禁用 |\n| data | Object | - | - | 地区数据(v5需要传入) |\n\n## 事件\n\n|  事件名  |  说明  |  参数 |\n|  :--:  |  :--:  |  :--: |\n| change | 选中值发生变化时触发 | 目前选择的值 |\n\n\u003e change 事件在 1.2.5 之后提供\n\n## Related Project\n* [react-area-linkage](https://github.com/dwqs/react-area-linkage)\n## License\nMIT.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdwqs%2Fvue-area-linkage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdwqs%2Fvue-area-linkage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdwqs%2Fvue-area-linkage/lists"}