控件本质是一个多级联下拉菜单,配上多选和
控件本质是一个多级联下拉菜单,配上多选和 Tags 组件,用于数据门户、EMA 的区域筛选功能。
用法 引用<script src="//unpkg.com/eleme-area-selector/dist/index.min.js"></script> NPM
npm i eleme-area-selector
配置
基础配置
new AreaSelector(element[, 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; } } })
版权声明:
1、该文章(资料)来源于互联网公开信息,我方只是对该内容做点评,所分享的下载地址为原作者公开地址。2、网站不提供资料下载,如需下载请到原作者页面进行下载。