iview-area-zhaofinger-fork

iview-area

一款基于Vue框架和iView-UI组件库开发的城市级联组件，数据包含中国的省(直辖市)、市、县区和乡镇街，数据来源area-data

English Document 线上DEMO

iview-area有两种形式的级联:

• 下拉菜单(基于iview的Select组件)
• 级联选择(基于iview的Cascader组件)

install 安装

    npm install iview-area --save

use 使用

在main.js中写入下面的代码

    import iviewArea from 'iview-area';
    import Vue from 'vue';
    Vue.use(iviewArea);

接下来，你就可以在页面中使用iview-area了

<template>
    <al-selector v-model="res_s"/>
    <al-cascader v-model="res_c"/>
</template>
<script>
    export default {
        data () {
            return {
                res_s: [],
                res_c: []
            }
        }
    }
</script>

config 配置

al-selector:

属性	说明	类型	默认值
value	用于存放结果的数组，建议使用v-model来做双向绑定	Array	无
v-model	用于存放结果的数组，选择了数据后会自动更新，可传入默认显示的数据，详见表格下补充	Array	无
gutter	设置各级别选择器之间的距离，单位px	String | Number	10
level	要显示的级别，如设为2则显示省、市和县，即3级，级别可设为0、1、2、3四级	String | Number	3
data-type	返回数据的类型，'all':城市编码和名称，'code':只返回编码，'name':只返回名称，数据格式请看表格下面的补充说明	String	all
searchable	是否可搜索，添加该属性则点击选择器后可输入名称搜索	Boolean	false
size	选择器尺寸，该属性同iview组件select的size属性，可选值为small，large，default	String	default
auto	是否在选择一级之后自动选择之后所有等级的选择器（自动选中为列表第一项）	Boolean	false
placeholder	选择器未选择时显示的占位字符,若为字符串，则各级别选择器均使用该作为占位字符，若为数组，根据数组对应位置的字符串设置选择器占位字符，若数组元素少于级别数，缺省的则设为默认数组中对应的占位字符	Array | String	['请选择省', '请选择市', '请选择县区', '请选择街道']
not-found-text	无数据时显示的文字提示，规则同placeholder属性	Array | String	['无匹配市', '无匹配县区', '无匹配街道']
disabled	设置禁用整个级联选择器或某个级别的选择器，可只写disabled，也可写:disabled="true"或"false"，或传入一个数组，如禁用二级和四级选择器则为[1, 3]，也可传入数值指定从指定级别开始禁用	Boolean | Array | Number	false

事件	说明	返回值
on-change	选择完成后的回调，返回值此时已选的数据数组	data

补充说明：

data-type数据格式补充说明:

• data-type="all"时，返回数据格式如下：

  [
      {
          code: '130000',
          name: '河北省'
      },
      {
          code: '130100',
          name: '石家庄市'
      }
  ]
  

• data-type="name"时，返回数据格式如下：

  ['河北省', '石家庄市']
  

• data-type="code"时，返回数据格式如下：

  ['130000', '130100']
  

v-model属性补充说明:

• 传入名称数组，若所设地方名称未找到或地方所属关系不对，则显示该等级列表中第一个地方，若数组地方个数少于城市及联选择器的等级数目，则后面缺省的地方名默认已列表中第一个地方显示；且如果设置了数组且不为空，则每次选择一个等级的地方后下面级别的选择器的列表都会更新，且默认选中的为对应列表中第一个地方

  ex: ['河北省', '长春市']

- 传入编号数组，若所设编号未找到对应地方或地方所属关系不对，则显示该等级列表中第一个地方，规则同上

ex: ['130000', '120100']

- 传入空数组 []

al-cascader:

属性	说明	类型	默认值
value	用于存放结果的数组，建议使用v-model来做双向绑定	无	无
v-model	用于存放结果的数组，选择了数据后会自动更新	无	无
level	要显示的级别，如设为2则显示省、市和县，即3级，级别可设为0、1、2、3四级	String | Number	3
data-type	返回数据的类型，'all':城市编码和名称，'code':只返回编码，'name':只返回名称，数据格式同al-selector补充说明	String	all
size	选择器尺寸，该属性同iview组件cascader的size属性，可选值为small，large	String	无
placeholder	选择器未选择时显示的占位字符	String	'请选择']
disabled	是否禁用选择器	Boolean	false
render-format	选择后展示的函数，用于自定义显示格式	Function	label => label.join(' / ')

事件	说明	返回值
on-change	选择完成后的回调，返回值此时已选的数据数组	data