日常业务开发中，有很多场景会使用到枚举值，比如select-options、table-column。

启用方式

{\n    "dependencies": {\n        "@fesjs/fes": "^2.0.0",\n        "@fesjs/plugin-enums": "^2.0.0"\n    }\n}\n

1
2
3
4
5
6

配置

静态配置

// 配置格式：[[key, value], ...]\nexport default {\n    enums: {\n        status: [['0', '无效的'], ['1', '有效的']]\n    }\n}\n

1
2
3
4
5
6

动态配置

import { enums } from '@fesjs/fes';\n// 动态添加\nenums.push('status', [['0', '无效的'], ['1', '有效的']]\nenums.get('status', '1') // 有效的\n

1
2
3
4

场景使用

<template>\n    <div>\n        <!-- 遍历枚举status -->\n        <div v-for="item in enumsGet('status')" :key="item.key">\n            {{item.value}}：{{item.key}}\n        </div>\n        <!-- 遍历枚举扩展后的roles -->\n        <div v-for="item in roles" :key="item.key">\n            {{item.name}}：{{item.disabled}}\n        </div>\n        <!-- 获取枚举roles为2的英文名 -->\n        <div>{{enumsGet('roles', '2', { dir: 'eName' })}}</div>\n    </div>\n</template>\n<script>\nimport { enums } from '@fesjs/fes';\n\nexport default {\n    setup() {\n        // 动态添加枚举，枚举项是对象，并指定key的属性名为id\n        enums.push('roles', [\n            {\n                id: '1',\n                cName: '系统管理员',\n                eName: 'System',\n                perm: ['1', '2', '3']\n            },\n            {\n                id: '2',\n                cName: '业务管理员',\n                eName: 'Business',\n                perm: ['1', '2']\n            },\n            {\n                id: '3',\n                cName: '普通用户',\n                eName: 'User',\n                perm: ['1']\n            }\n        ], { keyName: 'id' });\n        // 导出定制格式的roles，扩展枚举项新的属性name、disabled\n        const roles = enums.get('roles', {\n            extend: [\n                {\n                    key: 'name',\n                    dir: 'cName' // 指定取值路径，取属性cName的值\n                },\n                {\n                    key: 'disabled',\n                    // 传入函数，获取结果值\n                    transfer: item => item.value.perm.some(i => i >= 2)\n                }\n            ]\n        });\n        console.log(roles);\n        // [{key: '1', name: '系统管理员', disabled: true, value: {...}}, ....]\n        return {\n            enumsGet: enums.get,\n            roles\n        };\n    }\n};\n</script>\n\n

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

API

get

get('status')\nget('status', '1')\nget('status', {\n    extend: [\n        {\n            key: 'name',\n            dir: 'value',\n        },\n        {\n            key: 'disabled',\n            transfer: item => item === '0'\n        }\n    ]\n})\nget('status', '1', {dir: 'value'})\n

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

push

枚举项为数组，枚举项的[0]解析为key，枚举项的[1]解析为value

枚举项为对象时，根据opt配置keyName、valueName取枚举项属性值分别作为key和value，如果valueName未设置则value就是枚举项

remove

concat

convert

extend配置

get('status', {\n    extend: [\n        {\n            key: 'name',\n            dir: 'value',\n        },\n        {\n            key: 'disabled',\n            transfer: item => item.key === '0'\n        }\n    ]\n})\n

1
2
3
4
5
6
7
8
9
10
11
12

dir规则

// 假如枚举项value的结构如下\nconst user = {\n    age: 18,\n    name: 'aring',\n    role: [\n        {\n            id: 1,\n            name: '管理员'\n        },\n                    {\n            id: 2,\n            name: '业务操作员'\n        }\n    ]\n}\n// 那么规则解析是：\ndir              value\n'age'        =>  18\n'role[0]'    =>  {id: 1, name: '管理员'}\n'role[1].id' =>  2\n

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

# @fesjs/plugin-enums

# 介绍

# 启用方式

# 配置

# 静态配置

# 动态配置

# 场景使用

# API

# get

# push

# remove

# concat

# convert

# extend配置

# dir规则

@fesjs/plugin-enums

介绍