element-plus-china-area

Element PLUS 中国省市区级联数据(含港澳台)

安装

npm install element-plus-china-area -S

使用

import { provinceAndCityData, regionData, provinceAndCityDataPlus, regionDataPlus, CodeToText, TextToCode } from 'element-plus-china-area'

服务端用法：

const { provinceAndCityData, regionData, provinceAndCityDataPlus, regionDataPlus, CodeToText, TextToCode } = require('element-plus-china-area/dist/app.commonjs')

1. provinceAndCityData是省市二级联动数据（不带“全部”选项）
2. regionData是省市区三级联动数据（不带“全部”选项）
3. provinceAndCityDataPlus是省市区三级联动数据（带“全部”选项）
4. regionDataPlus是省市区三级联动数据（带“全部”选项）
5. "全部"选项绑定的value是空字符串""
6. CodeToText是个大对象，属性是区域码，属性值是汉字 用法例如：CodeToText['110000']输出北京市
7. TextToCode是个大对象，属性是汉字，属性值是区域码 用法例如：TextToCode['北京市'].code输出110000,TextToCode['北京市']['市辖区'].code输出110100,TextToCode['北京市']['市辖区']['朝阳区'].code输出110105

• 省市二级联动（不带“全部”选项）:

  <template>
    <div id="app">
      <el-cascader
        size="large"
        :options="options"
        v-model="selectedOptions"
        @change="handleChange">
      </el-cascader>
    </div>
  </template>
  
  <script>
    import { provinceAndCityData } from 'element-plus-china-area'
    export default {
      data () {
        return {
          options: provinceAndCityData,
          selectedOptions: []
        }
      },
  
      methods: {
        handleChange (value) {
          console.log(value)
        }
      }
    }
  </script>
  

  • 省市二级联动（带“全部”选项）:

    <template>
      <div id="app">
        <el-cascader
          size="large"
          :options="options"
          v-model="selectedOptions"
          @change="handleChange">
        </el-cascader>
      </div>
    </template>
    
    <script>
      import { provinceAndCityDataPlus } from 'element-plus-china-area'
      export default {
        data () {
          return {
            options: provinceAndCityDataPlus,
            selectedOptions: []
          }
        },
    
        methods: {
          handleChange (value) {
            console.log(value)
          }
        }
      }
    </script>
    

  • 省市区三级联动（不带“全部”选项）

  <template>
    <div id="app">
      <el-cascader
        size="large"
        :options="options"
        v-model="selectedOptions"
        @change="handleChange">
      </el-cascader>
    </div>
  </template>
  
  <script>
    import { regionData } from 'element-plus-china-area'
    export default {
      data () {
        return {
          options: regionData,
          selectedOptions: []
        }
      },
  
      methods: {
        handleChange (value) {
          console.log(value)
        }
      }
    }
  </script>
  

  • 省市区三级联动（带“全部”选项）

  <template>
    <div id="app">
      <el-cascader
        size="large"
        :options="options"
        v-model="selectedOptions"
        @change="handleChange">
      </el-cascader>
    </div>
  </template>
  
  <script>
    import { regionDataPlus } from 'element-plus-china-area'
    export default {
      data () {
        return {
          options: regionDataPlus,
          selectedOptions: []
        }
      },
  
      methods: {
        handleChange (value) {
          console.log(value)
        }
      }
    }
  </script>
  

绑定value格式

value是区域码"110000"

数据来源

2021年统计用区划代码和城乡划分代码（截止时间：2021-10-31，发布时间：2021-12-30）

开发过程

npm run dev 是开发

npm run build + npm run build-commonjs + npm run docs 是准备发布