msidolphin / element-ui-area

An area component bases on Vue and ElementUI

element-ui-area

基于Vue和ElementUI的**行政区划选择器

安装

npm install element-ui-area -S

使用方式

项目依赖于Element-UI，您需要先进行引入

引入

import AreaComponent from 'element-ui-area'
Vue.use(AreaComponent, {})

// or
import {Cascader, Select} from 'element-ui-area'
Vue.use(Cascader, {})
Vue.use(Select, {})

配置项

属性	类型	说明	默认值
dataSource	Object	数据源	-

使用

Cascader

<template>
    <area-cascader v-model="value" :level="3" @change="onChange"/>
</template>
<script>
export default {
    data () {
        return {
            value: []
        }
    },
    methods: {
        onChange (val, text) {
            console.log(val)
            console.log(text) // 地区中文
        }
    }
}
</script>

Select

<template>
    <div style="width:600px;margin:10px auto;">
      <area-select v-model="value" :level="1"/>
      <area-select v-model="value1" :level="2"/>
      <area-select v-model="value2" :level="3"/>
    </div>
</template>
<script>
export default {
    data () {
        return {
            value: [],
            value1: [],
            value2: []
        }
    }
}
</script>

配置项

area-cascader

属性	类型	说明	默认值
value	String	绑定值	[ ]
level	Number	层级，由于数据原因，目前最多只支持三级	3
disabled	Boolean	是否禁用	false
size	String	尺寸	small
noMatchText	String	无匹配项时展现的文字	无匹配数据
noDataText	String	无数据时展现的文字	无数据
clearable	Boolean	是否支持清空	true
placeholder	String	占位符	请选择地区
immediate	Boolean	是否立即触发change事件	true
dataSource	Object	数据源	6位短编码行政区划

area-select

属性	类型	说明	默认值
value	String	绑定值	[ ]
level	Number	层级，由于数据原因，目前最多只支持三级	3
disabled	Boolean	是否禁用	false
size	String	尺寸	small
gutter	number	间距	10
noMatchText	String	无匹配项时展现的文字	无匹配数据
noDataText	String	无数据时展现的文字	无数据
clearable	Boolean	是否支持清空	true
placeholder	Array	占位符	['请选择省', '请选择市', '请选择区县', '请选择街道']
filterable	Boolean	是否支持搜索	false
immediate	Boolean	是否立即触发change事件	true
dataSource	Object	数据源	6位短编码行政区划

事件

名称	说明	参数
change	选中值改变事件，初始化时会触发一次	改变后的值, 中文名称
blur	失去焦点	事件对象
focus	聚焦	事件对象

数据源格式范例

{
	"86": {
		"110000": "北京市",
	},
	"110000": {
		"110100": "市辖区"
	},
	"110100": {
		"110101": "东城区",
		"110102": "西城区",
		"110105": "朝阳区",
		"110106": "丰台区",
		"110107": "石景山区",
		"110108": "海淀区",
		"110109": "门头沟区",
		"110111": "房山区",
		"110112": "通州区",
		"110113": "顺义区",
		"110114": "昌平区",
		"110115": "大兴区",
		"110116": "怀柔区",
		"110117": "平谷区",
		"110118": "密云区",
		"110119": "延庆区"
    }
}