什么是枚举Enum

枚举 Enum是在众多语言中都有的一种数据类型,JavaScript中还没有(TypeScript有)。用来表示一些特定类别的常量数据,如性别、学历、方向、账户状态等,项目开发中是很常用的。

Text文字(界面显示)key编码(编码、存储使用)数字value值(存储使用)
male/man/nan1
female/woman/nv2
其他other3

如上表中的性别枚举结构,前端页面上显示文字男、女,代码中一般使用编码key,后端数据库存储可能会用编码key,也可能用数字value值。用数字存储,占用空间会更小,还能用位运算存储多个值(算是稍微高级一点的玩法了)。


前端应用场景

表格数据绑定时,需要显示性别的文字信息,而后端返回的JSON数据中可能是key/value值。

Element 的 table组件 支持绑定一个格式化函数formatter来转换数据,函数定义:Function(row, column, cellValue, index)
表单中提供用户的性别选项,如下拉框、单选按钮组等。

Element 的下拉框通过v-for 来绑定生成 选项:


封装Enum数据结构

枚举数据的使用、绑定是比较常见的,针对Element UI组件进行简单封装一下,让枚举数据的使用、绑定更轻松。

  • 新建一个管理枚举数据的JS文件:enums.js
  • 定义一个枚举工厂构造函数EnumFactory,用来封装枚举结构的基础方法,详见注释。
  • 工厂方法中通过 Object.defineProperty(obj, prop, descriptor) 添加属性/方法,该方法添加的默认是不能被枚举、修改的。
  • 申明项目中公共枚举数据,并导出。
  • 枚举元数据结构:
    • 支持 {key , text} 结构:{ male: '男', female: '女', other: '其他' }
    • 也支持 {key :{text, value }}结构:{ male: { text: '男', value: 1 }, female: { text: '女', value: 2 } }
//枚举构造器,提供的属性:// keys:枚举的key集合[key]// texts:枚举的文本text集合[text]// values:枚举的数值value集合[value]// entries:枚举的key、text、value集合[{key,text,value}]// tableFormater:element中表格绑定枚举数据文本的formatter函数function EnumFactory(enumObj) {    //复制(继承)enumObj    Object.assign(this, enumObj);    // keys:枚举的key集合[key]    Object.defineProperty(this, 'keys', {        value: Object.keys(enumObj)    });    //处理texts、values、entries        let values = [], texts = [], entries = [];    const vobjs = Object.values(enumObj);    if (typeof vobjs[0] === 'string') {        texts = vobjs;        vobjs.forEach((item, index) => {            entries.push({ key: this.keys[index], text: texts[index] });        })    }    else {        vobjs.forEach((item, index) => {            texts.push(item.text);            values.push(item.value);            entries.push({ key: this.keys[index], text: item.text, value: item.value });        })    }    // texts:枚举的文本text集合[text]    Object.defineProperty(this, 'texts', { value: texts });    // values:枚举的数值value集合[value]    Object.defineProperty(this, 'values', { value: values });    // entries:枚举的key、text、value集合[{key,text,value}]    Object.defineProperty(this, 'entries', { value: entries });    // tableFormater:element中表格绑定枚举数据文本的formatter函数    Object.defineProperty(this, 'tableFormater', {        value: function (r, c, value) {            return entries.filter(v => v.key === value || v.value === value)[0]?.text || 'notfound';        }    });    //枚举定义的数据都是常量,不可修改,冻结一下    Object.freeze(this);}//********************** 定义项目公共枚举 ********************** *///性别枚举:key、text模式// const enumSex = new EnumFactory({ male: '男', female: '女', other: '其他' });//性别枚举:key、text、value模式const enumSex = new EnumFactory({ male: { text: '男', value: 1 }, female: { text: '女', value: 2 } });//水平对齐const enumAlign = new EnumFactory({ left: '左对齐', center: '居中', right: '右对齐' });//用户状态const enumUserStatus = new EnumFactory({ default: '正常', delete: '删除', lock: '锁定' });//**********************  export  ********************** */export { enumSex, enumAlign, enumUserStatus }//testconsole.log(enumSex.keys);console.log(enumSex.texts);console.log(enumSex.values);console.log(JSON.stringify(enumSex.entries));// ['male', 'female']// ['男', '女']// [1, 2]// [{"key":"male","text":"男","value":1},{"key":"female","text":"女","value":2}]

Element中使用

表格绑定formatter

修改查看删除

表单选型组件绑定选项:

{{item.text}}


©️版权申明:版权所有@安木夕(kanding),本文内容仅供学习,欢迎指正、交流,转载请注明出处!
原文编辑地址:https://www.yuque.com/kanding