{"_id":"@bluedot-tech/v-region","_rev":"3-5d97833bce5180fc787218d14a7537bd","name":"@bluedot-tech/v-region","dist-tags":{"latest":"0.0.1"},"versions":{"0.0.1":{"name":"@bluedot-tech/v-region","version":"0.0.1","keywords":["front-end","javascript","web","vue","vuejs","region","city","town","area","selector"],"license":"MIT","_id":"@bluedot-tech/v-region@0.0.1","maintainers":[{"name":"bimuyu","email":"1198810568@qq.com"},{"name":"cailin.wang","email":"dreamcailin@hotmail.com"}],"nyc":{"include":["src/components/CityPicker.js","src/components/ColumnGroup.js","src/components/Group.js","src/components/Text.js","src/components/SelectGroup.js"],"sourceMap":false,"instrument":false},"dist":{"shasum":"205996aab7de4d9369b6cd5c5b8c0b0abf655661","tarball":"https://registry.npmjs.org/@bluedot-tech/v-region/-/v-region-0.0.1.tgz","fileCount":2955,"integrity":"sha512-M+wOZJcEP+qjdNtXIUbw48h76wxe67OP7pTvP5aJhjS1xjmnE5dhRDn3st8M4IGR4cpxXKEyB9tJX+RC7F8FjA==","signatures":[{"sig":"MEQCIFLENeaaxnijvZHZkvrVQT/O56P5swcPGBfRh8c8XwdTAiA72ykoCmZsQC5g0k3bqLY9CXzmBezpzJJE45tSklh31Q==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":7341108,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJjAyGYACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmr1IRAAh5QM5Zt6Eowvxq4Eor9RXEAUH+sWZsjx+0FMrgdYlvRYbI1i\r\nJ5yo3lD7T+qob1BYJsmGvDDSB5SWPTAzukjQU7vCgOS8j8pgQf4BtJqTJP85\r\nryKHdy0cR7URleJSLNwwSz1OGIQgfXJcZSSWcUQDDNR8x/42SynZF0P31pAQ\r\njADlwF05KLKq2tXFQxsrzESMuqxCGZahHOI3ngTFMgUxsQ0RikZ1DlniQ89j\r\nS8g127jGyE/ORoXiVaGbseQ8HNMnKIiqbGLrVJsA/l3yw4rjF8UW4HtlLrUs\r\nX4xLStXXz/fRKoiksDgtxXub/X4SOygynzrDw266LOg5Hsu98EqkEf7865Dv\r\ntJmAKuq2Zz2vBQb4L48yJvnEW5cPUtLWXX0BwCWkvAeNQtVXD6ZMwyM8mfUU\r\nwlGcUF2jW7zTkzvdryERBXo9Nq5UdFrqXfoKC2uSvwiufhXAvKSuwACBTMQV\r\nJ0ZdULMawmxgNo5LUR0T2ab/ipanijB2d/mCsn/XbaQ4cb4sFNIJghMet37c\r\n56a+v9+Skatbv1phPsd06swfSOJ3f9nr+wrOn/VeeKGle5SU31bpIOTWYIZ2\r\nV69pj4L0AHCotdMo7fEbxtNcQe8FizP1LNCG6F8hDnB2goDKYv+OHey0Mv3g\r\nYcOE38evEAEHrrJTUqImgb/zRoRE2ddhVj4=\r\n=rAXC\r\n-----END PGP SIGNATURE-----\r\n"},"main":"dist/v-region.js","gitHead":"88621328748f4677251c8762c4fd95f6aa097a3c","scripts":{"dev":"cross-env NODE_ENV=development webpack-dev-server --open --hot","build":"cross-env NODE_ENV=production webpack --progress --hide-modules","cover":"cross-env NODE_ENV=coverage nyc --reporter=lcov --reporter=text npm run test:unit","test:unit":"mocha-webpack --webpack-config webpack.config.js --require tests/unit/setup.js tests/unit/**/*.spec.js"},"_npmUser":{"name":"bimuyu","email":"1198810568@qq.com"},"_npmVersion":"6.14.17","description":"<!-- <br><br>","directories":{},"_nodeVersion":"14.20.0","browserslist":["> 1%","last 2 versions","not ie <= 8"],"dependencies":{"v-dropdown":"2.1.1"},"_hasShrinkwrap":false,"devDependencies":{"nyc":"^14.1.1","vue":"^2.6.10","chai":"^4.2.0","jsdom":"^15.1.1","mocha":"^6.2.1","stylus":"^0.54.7","webpack":"^3.6.0","cross-env":"^5.0.5","node-sass":"^4.12.0","babel-core":"^6.26.3","css-loader":"^3.2.0","url-loader":"^2.2.0","vue-loader":"^15.7.1","sass-loader":"^6.0.6","babel-loader":"^7.1.2","jsdom-global":"^3.0.2","mocha-webpack":"^1.1.0","stylus-loader":"^3.0.2","@vue/test-utils":"^1.0.0-beta.29","babel-preset-env":"^1.7.0","webpack-dev-server":"^3.1.14","babel-preset-es2015":"^6.24.1","babel-preset-stage-3":"^6.24.1","vue-template-compiler":"^2.6.10","webpack-node-externals":"^1.7.2","istanbul-instrumenter-loader":"^3.0.1","babel-plugin-dynamic-import-node":"^2.3.0"},"_npmOperationalInternal":{"tmp":"tmp/v-region_0.0.1_1661149591592_0.3827928086772865","host":"s3://npm-registry-packages"}}},"time":{"created":"2022-08-22T06:26:31.549Z","modified":"2025-06-25T02:23:24.933Z","0.0.1":"2022-08-22T06:26:31.979Z"},"license":"MIT","keywords":["front-end","javascript","web","vue","vuejs","region","city","town","area","selector"],"description":"<!-- <br><br>","maintainers":[{"email":"cailin.wang@outlook.com","name":"cailin.wang"},{"email":"3540172031@qq.com","name":"mars-is-register"}],"readme":"<!--\n<br><br>\n\n<p align=\"center\"><img src=\"https://terryz.github.io/image/v-region/v-region-ui.png\" alt=\"v-region\" ></p>\n\n<h3 align=\"center\">v-region</h3>\n\n<br>\n\n<p align=\"center\">\n    简洁强大的中国行政区划选择器，可选择 “省/直辖市”、“市”、“区/县”、“乡/镇/街道” 4 级行政区域<br>\n    A simple region cascade selector for <strong>Vue2</strong>, provide 4 levels Chinese administrative division data\n</p>\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/v-region\"><img src=\"https://img.shields.io/npm/v/v-region.svg\"></a>\n  <a href=\"https://mit-license.org/\"><img src=\"https://img.shields.io/badge/license-MIT-brightgreen.svg\"></a>\n  <a href=\"https://app.fossa.io/projects/git%2Bgithub.com%2FTerryZ%2Fv-region?ref=badge_shield\"><img src=\"https://app.fossa.io/api/projects/git%2Bgithub.com%2FTerryZ%2Fv-region.svg?type=shield\"></a>\n  <a href=\"https://www.npmjs.com/package/v-region\"><img src=\"https://img.shields.io/npm/dy/v-region.svg\"></a>\n</p>\n\n\n<br><br><br><br><br>\n\n-->\n\n# [v-region](https://terryz.github.io/vue/#/region)\n\n[![circle ci](https://circleci.com/gh/TerryZ/v-region.svg?style=svg)](https://circleci.com/gh/TerryZ/v-region)\n[![code coverage](https://codecov.io/gh/TerryZ/v-region/branch/master/graph/badge.svg)](https://codecov.io/gh/TerryZ/v-region)\n[![npm version](https://img.shields.io/npm/v/v-region.svg)](https://www.npmjs.com/package/v-region)\n[![npm download](https://img.shields.io/npm/dy/v-region.svg)](https://www.npmjs.com/package/v-region)\n[![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)\n\n简洁强大的中国行政区划选择器，可选择 “省/直辖市”、“市”、“区/县”、“乡/镇/街道” 4 级行政区域\n\nA simple region cascade selector for **Vue2**, provide 4 levels Chinese administrative division data\n\n## 实例和文档（Examples and Documentation）\n\n请浏览（Explorer on）\n\n- [English site](https://terryz.github.io/vue/#/region)\n- [国内站点](https://terryz.gitee.io/vue/#/region)\n\n## 功能特性（Featues）\n\n- 支持 “省/直辖市”、“市”、“区/县”、“乡/镇/街道” 4级行政区域选择\n- 传统表单多下拉列表（Select）多级联动模式\n- 下拉选择器模式\n- 多列竖排模式选择器模式\n- 下拉选择器模式自带默认呼出按钮，并允许自定义呼出对象（Slot）\n- 纯文本显示模式（指定初始值后）\n- 除省级以外，其它行政区域级别允许通过参数进行“打开/关闭”\n- 完整解决 “直辖市”、“特别行政区” 、 “地级市（直筒子市）” 和 “省辖县/省辖县级市” 的数据和内容的处理\n\n## 插件预览（Plugin preview）\n\n- *纯文本显示模式 (plain text view mode)*\n\n![text](https://terryz.github.io/image/v-region/v-region-text.png)\n\n- *表单元素模式（form element mode）*\n\n![base](https://terryz.github.io/image/v-region/v-region-base.png)\n\n- *下拉选择器模式（dropdown selector mode）*\n\n![ui](https://terryz.github.io/image/v-region/v-region-ui.png)\n\n- *多列竖排选择器模式 (selector with column group)*\n\n![column](https://terryz.github.io/image/v-region/v-region-column.png)\n\n- *城市选择器模式 (city picker selector mode)*\n\n![city-picker](https://terryz.github.io/image/v-region/v-region-city-picker.png)\n\n\n## 安装插件（Installation）\n\n<a href=\"https://nodei.co/npm/v-region/\"><img src=\"https://nodei.co/npm/v-region.png\"></a>\n\n```\nnpm i -S v-region\n```\n\nInclude plugin in your `main.js` file.\n\n```js\nimport Vue from 'vue'\nimport vRegion from 'v-region';\nVue.use(vRegion, { global config options });\n```\n\n## 在页面中使用（Usage）\n\n```vue\n<template>\n  <v-region @values=\"regionChange\"></v-region>\n</template>\n\n<script>\nexport default {\n    methods:{\n        //receive selected region entries\n        regionChange(data){\n            console.log(data);\n        }\n    }\n};\n</script>\n```\n\n## License\n\n[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2FTerryZ%2Fv-region.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2FTerryZ%2Fv-region?ref=badge_large)\n\n## Star数趋势（Stargazers over time）\n\n[![Stargazers over time](https://starcharts.herokuapp.com/TerryZ/v-region.svg)](https://starcharts.herokuapp.com/TerryZ/v-region)\n\n## 数据源（Data Source）\n\nRegion data come from repo: [mumuy/data_location](https://github.com/mumuy/data_location)\n\n> **数据说明**  \n> 省、市、区数据来自于民政局、国务院公告、国家统计局，确保及时更新和权威；  \n> 街道(镇、乡)数据由于数据庞大，各地各级之前公函较多，无法保证及时有效（最新数据2016年7月31日）；  \n> 数据是以行政区为单位的行政区划数据。行政管理区与行政区存在重合，不予收录;    \n> (行政管理区通常包含:***经济特区/经济开发区/高新区/新区/工业区；亦有部分行政管理区升为行政区，需加以区分)\n\n## 依赖（Dependencies）\n\n- [v-dropdown](https://github.com/TerryZ/v-dropdown) - the dropdown layer container\n\n## Vue 插件作品集（Vue plugin series）\n\n| Plugin | Status | Description |\n| :---------------- | :-- | :-- |\n| [v-page](https://github.com/TerryZ/v-page) | [![npm version](https://img.shields.io/npm/v/v-page.svg)](https://www.npmjs.com/package/v-page) | A simple pagination bar, including length Menu, i18n support |\n| [v-dialogs](https://github.com/TerryZ/v-dialogs) | [![npm version](https://img.shields.io/npm/v/v-dialogs.svg)](https://www.npmjs.com/package/v-dialogs) | A simple and powerful dialog, including Modal, Alert, Mask and Toast modes |\n| [v-tablegrid](https://github.com/TerryZ/v-tablegrid) | [![npm version](https://img.shields.io/npm/v/v-tablegrid.svg)](https://www.npmjs.com/package/v-tablegrid) | A simpler to use and practical datatable |\n| [v-uploader](https://github.com/TerryZ/v-uploader) | [![npm version](https://img.shields.io/npm/v/v-uploader.svg)](https://www.npmjs.com/package/v-uploader) | A Vue2 plugin to make files upload simple and easier, <br>you can drag files or select file in dialog to upload |\n| [v-ztree](https://github.com/TerryZ/v-ztree) | [![npm version](https://img.shields.io/npm/v/v-ztree.svg)](https://www.npmjs.com/package/v-ztree) | A simple tree for Vue2, support single or multiple(check) select tree, <br>and support server side data |\n| [v-gallery](https://github.com/TerryZ/v-gallery) | [![npm version](https://img.shields.io/npm/v/v-gallery.svg)](https://www.npmjs.com/package/v-gallery) | A Vue2 plugin make browsing images in gallery |\n| [v-region](https://github.com/TerryZ/v-region) | [![npm version](https://img.shields.io/npm/v/v-region.svg)](https://www.npmjs.com/package/v-region) | A simple region selector, provide Chinese administrative division data |\n| [v-selectpage](https://github.com/TerryZ/v-selectpage) | [![npm version](https://img.shields.io/npm/v/v-selectpage.svg)](https://www.npmjs.com/package/v-selectpage) | A powerful selector for Vue2, list or table view of pagination, <br>use tags for multiple selection, i18n and server side resources supports |\n| [v-suggest](https://github.com/TerryZ/v-suggest) | [![npm version](https://img.shields.io/npm/v/v-suggest.svg)](https://www.npmjs.com/package/v-suggest) | A Vue2 plugin for input suggestions by autocomplete |\n| [v-playback](https://github.com/TerryZ/v-playback) | [![npm version](https://img.shields.io/npm/v/v-playback.svg)](https://www.npmjs.com/package/v-playback) | A Vue2 plugin to make video play easier |\n| [v-selectmenu](https://github.com/TerryZ/v-selectmenu) | [![npm version](https://img.shields.io/npm/v/v-selectmenu.svg)](https://www.npmjs.com/package/v-selectmenu) | A simple, easier and highly customized menu solution |\n","readmeFilename":"README.md"}