eleme-area-selector

控件本质是一个多级联下拉菜单，配上多选和 Tags 组件，用于数据门户、EMA 的区域筛选功能。

用法

引用

<script src="//unpkg.com/eleme-area-selector/dist/index.min.js"></script>

NPM

npm i eleme-area-selector

配置

基础配置

new AreaSelector(element[, options])

options 参数

参数名	说明	类型	默认值
api	所有内置数据类型的 base url，需要使用自定义类型时才需要修改	String	/api/other/filter/
style	样式文件的 CDN 地址	String	//unpkg.com/eleme-area-selector/dist/style.css
selectItemStyle	列表中单位的高度和按需加载的单位	Object	{ height: 27, display: 20 }
selectSliceLength	开启按需加载的列表长度，超过这个数值则开启按需加载	Number	200
cache	是否缓存用户的选择状态，开启则存储在 LocalStorage 中，使用页面 URL + Type 来标识	Boolean	false
cacheKey	LocalStorage 使用的 key，只存一条记录，内容使用 JSON 组织	String	EAS-CACHE
defaultSelect	初始状态是否默认选择第一层级的所有项(cache 属性打开时依然优先 cache 的值)	Boolean	true
typeMap	内置的数据门户常用过滤器类型(以前他们说绝对不加新的了 WTF	Object	see
types	当前实例展示的可选类型，大于 1 个时会显示一个下拉菜单供选择(如果不需要，可以直接使用样式来隐藏	Array	['交易平台BU']
onReady	数据加载完毕，默认选项有值	Function	null
onChange	选项的选中状态发生了改变	Function	null
onTypeChange	用户通过下拉菜单改变了 type 值	Function	null
loadingMessage	文案	Array	['正在加载资源...', '正在请求数据...']
responseHandler	得到返回数据后的处理函数，会传入两个参数，第一个为接口返回的原始数据，第二个为后续的 Build 方法，需要把处理完成后的数据传递进去	Function	null

实例方法

var as = new AreaSelector();

as.setParams({ key: 'value' }); // 会立即触发一次数据请求

as.clearAll(); // 清空当前选择项

as.getModel(); // 获取当前的选择信息

调用方式

简单实例

<div id="app"></div>

as = new AreaSelector(document.getElementById('app'), {
  api: '/api/filter',
  typeMap: {
    '交易平台BU': { id: 'bu', params: { key1: 'value1' } }    // 请求会组装成 /api/filter/bu?key1=value1
  },
  types: ['交易平台BU', '城市'],
  cache: true,
  onReady: function() { console.log('ready!') },
  onChange: function() { console.log('changed! current value is:', as.getModel()) }, // { level: 1, data: '123,3453,676,1' }
  onTypeChange: function(type) { console.log('current type is:', type) }
})

内置类型列表

{
  '交易平台BU': { id: 'bu', params: { time: 'hour' } },
  '红包': { id: 'redReward' },
  'BOD': { id: 'bod' },
  '高校': { id: 'business/gx' },
  '白领': { id: 'business/bl' },
  '早餐': { id: 'breakfast' },
  '城市补贴与优惠': { id: 'cityAllowance' },
  '城市': { id: 'cityAllowance' }
}

使用内置类型

new AreaSelector(document.getElementById('app'), {
  types: ['交易平台BU', '城市'],
  responseHandler: (data, success) => {
    if (data && data.code === 200 && data.data) {
      return data.data;
    }
  }
})

使用自定义类型

new AreaSelector(document.getElementById('app'), {
  api: '/api/filter',
  typeMap: {
    '自定义': { id: 'custom', params: { key1: 'value1' } }
  },
  // 请求会组装成 /api/filter/custom?key1=value
  types: ['自定义'],
  responseHandler: (data, success) => {
    if (data && data.code === 200 && data.data) {
      return data.data;
    }
  }
})