开源中国 2018 年度最后一场技术盛会邀你来约~错过就要等明年啦!点此立即预约

TerryZ / v-regionJavaScriptMIT

Watch 47 Star 165 Fork 31
加入码云
与超过 300 万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
基于 Vue2 的简洁、易用的中国行政区划选择器,支持“省/直辖市”、“市”、“区/县”、“乡/镇/街道” 4级行政区域级别 展开 收起

https://terryz.gitee.io/vue/#/region

TerryZ 最后提交于 更新 README.md
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README.md



v-region



v-region

简洁强大的中国行政区划选择器,可选择 “省/直辖市”、“市”、“区/县”、“乡/镇/街道” 4 级行政区域
A simple region selector for Vue2, provide Chinese administrative division data






实例和文档(Demos and Documents)

请浏览(Explorer on)

FOSSA Status



功能特性(Featues)

  • 支持 “省/直辖市”、“市”、“区/县”、“乡/镇/街道” 4级国家行政区域选择
  • 传统表单多下拉列表(Select)联动模式
  • 下拉选择器模式
  • 多列竖排模式选择器模式
  • 下拉选择器模式自带默认呼出按钮,并允许自定义呼出对象(Slot)
  • 纯文本显示模式(指定初始值后)
  • 除省级以外,其它行政区域级别允许通过参数进行“打开/关闭”
  • 完整解决 “直辖市”、“特别行政区” 、 “地级市(直筒子市)” 和 “省辖县/省辖县级市” 的数据和内容的处理



插件预览(Plugin preview)

纯文本显示模式 (plain text view mode)

text

表单元素模式(form element mode)

base

下拉选择器模式(dropdown selector mode)

ui

多列竖排选择器模式 (selector with column group)

column

城市选择器模式 (city picker selector mode)

city-picker



Vue plugin series

Plugin Status Description
v-page npm version A simple pagination bar, including length Menu, i18n support
v-dialogs npm version A simple and powerful dialog, including Modal, Alert, Mask and Toast modes
v-tablegrid npm version A simpler to use and practical datatable
v-uploader npm version A Vue2 plugin to make files upload simple and easier,
you can drag files or select file in dialog to upload
v-ztree npm version A simple tree for Vue2, support single or multiple(check) select tree,
and support server side data
v-gallery npm version A Vue2 plugin make browsing images in gallery
v-region npm version A simple region selector, provide Chinese administrative division data
v-selectpage npm version A powerful selector for Vue2, list or table view of pagination,
use tags for multiple selection, i18n and server side resources supports



Install

npm install v-region --save

Include plugin in your main.js file.

import Vue from 'vue'
import vRegion from 'v-region';
Vue.use(vRegion);

Deploy on your component(base mode)

template code

<template>
    <v-region @values="regionChange"></v-region>
</template>

script code

export default {
    methods:{
        //receive selected region data
        regionChange(data){
            console.log(data);
        }
    }
};

数据源(Data Source)

Region data come from repo: mumuy/data_location

数据说明
省、市、区数据来自于民政局、国务院公告、国家统计局,确保及时更新和权威;
街道(镇、乡)数据由于数据庞大,各地各级之前公函较多,无法保证及时有效(最新数据2016年7月31日);
数据是以行政区为单位的行政区划数据。行政管理区与行政区存在重合,不予收录;
(行政管理区通常包含:***经济特区/经济开发区/高新区/新区/工业区;亦有部分行政管理区升为行政区,需加以区分)



项目点评 ( 4 )

你可以在登录后,发表评论

搜索帮助