dict-plus
字典工具
安装
npm install @duying/dict-plus
示例
import DictPlus from '@duying/dict-plus'
DictPlus.register('OrderStatusEnum', new Map([
['code1', { label: '1', value: 1, alias: 'label-1' }],
['code2', { label: '2', value: 2, alias: 'label-2' }],
['code3', { label: '3', value: 3, alias: 'label-3' }]
]))
DictPlus.getValues('OrderStatus') // => 字典不存在，返回 []
/**
=> [
{ label: '1', value: 1, alias: 'label-1' },
{ label: '2', value: 2, alias: 'label-2' },
{ label: '3', value: 3, alias: 'label-3' }
]
* */
DictPlus.getValues('OrderStatusEnum')
DictPlus.getValues('OrderStatusEnum', { mapKeys: 'code1, code2, code3' }) // 同上
DictPlus.getValues('OrderStatusEnum', { fields: 'label, value, alias' }) // 同上
/**
=> [
{ label: '2', value: 2 },
{ label: '3', value: 3 },
]
* */
DictPlus.getValues('OrderStatusEnum', { mapKeys: 'code2, code3', fields: 'label, value' })
DictPlus.getValueByIndex('OrderStatus', 0) // => 字典不存在，返回 undefined
DictPlus.getValueByIndex('OrderStatusEnum', 0) // => { label: '1', value: 1, alias: 'label-1' }
DictPlus.getValueByIndex('OrderStatusEnum', 3) // => 同上
DictPlus.getValueByIndex('OrderStatusEnum', 1, { targetField: 'value' }) // => 2
DictPlus.getValueByIndex('OrderStatusEnum', -2) // => { label: '3', value: 3, alias: 'label-3' }
DictPlus.getValueByKey('OrderStatus', 'code2') // => 字典不存在，返回 undefined
DictPlus.getValueByKey('OrderStatusEnum', 'code4') // => {}
DictPlus.getValueByKey('OrderStatusEnum', 'code2') // => { label: '2', value: 2, alias: 'label-2' }
DictPlus.getValueByKey('OrderStatusEnum', 'code2', { targetField: 'alias' }) // => 'label-2'
DictPlus.getValueBySearch('OrderStatus', 'value', 2, 'alias') // => 字典不存在，返回 undefined
DictPlus.getValueBySearch('OrderStatusEnum', 'value', 2, 'alias') // => 'label-2'DictPlus 类静态方法
| 方法名 | 说明 |
|---|---|
| register(dictName: String, mapObj: Map): void | 注册字典数据 |
| getValues(dictName: String, { mapKeys?: Array<String>|String = [], fields?: Array<String>|String = [] } = {}): Array | 获取字典数据 |
| getValueByIndex (dictName: String, index: Number, { targetField?: String } = {}): any | 通过索引值 index 获取字典数据 |
| getValueByKey (dictName: String, mapKey: String, { targetField?: String } = {}): any | 通过键值 mapKey 获取字典数据 |
| getValueBySearch (dictName: String, searchField: String, searchValue: any, targetField: String): any | 以 searchField + searchValue 做查询条件，获取 targetField 对应的字典值 |
