lecen：一个更好的开源可视化系统搭建项目--全局对象使用--全低代码|所见即所得|利用可视化设计器构建你的应用系统-做一个懂你的人

利用可视化设计器构建你的应用系统-做一个懂你的人

全局对象
- Company
- Loading
- Menu
- Message
- Page
- Route
- Router
- Tool
- TurnToPage

全局对象

不同于 B、R、P，全局 G 对象是整个系统内部共享的，所有页面都可以访问它

这里面存放了一些全局对象、公共属性和工具方法等，都是可以在任何地方能够直接获取和使用的

对象	说明
Company	可以获取当前公司配置的所有信息
Loading	element-plus中loading服务的引用
Menu	系统菜单，包含菜单的相关属性以及操作
Message	element-plus中message服务的引用
Page	页面对象，包含页面的相关属性以及操作
Route	当前路由
Router	路由管理器
Tool	包含了预置的各种工具函数。
TurnToPage	跳转页面的方法，用来跳转到新路由
User	用户对象，包含用户信息和权限等

Company

基础包含 auth 和 service 两个对象，分别存放着认证标识和后端服务地址

当进入系统时，会将获取到的所有系统配置信息放入到 Company 对象中

系统配置信息可参照基本信息配置

Loading

js 复制代码

//显示弹窗
const loading = this.G.Loading.service({
    lock: true,
    text: '加载中...',
    background: 'rgba(0, 0, 0, 0.7)',
})
//关闭弹窗
loading.close()

详情参照 Loading 加载

属性	说明
current	当前菜单
opened	已打开的菜单
menus	所有菜单

方法	说明	参数
addOpened	添加打开的菜单	路由对象
removeOpened	移除打开的菜单	路由路径
removeOpenedExcept	移除给定路径之外的所有已打开的菜单	路由路径
removeOpenedMost	移除已打开的所有可关闭的菜单	-
find	查找打开的菜单中指定路径的菜单	路由路径
has	判断已打开的菜单中是否包含指定菜单	路由路径
setTitle	给当前打开的菜单设置标题	标题名称
setAffix	设置已打开菜单中指定菜单的可关闭状态	是否不可关闭

Message

js 复制代码

  // 字符串参数
  this.G.Message('this is a message.')

  // 对象参数
  this.G.Message({
    message: 'Congrats, this is a success message.',
    type: 'success',
  })

详情参照 Message 消息提示

Page

内置属性	说明
current	当前页面
opened	已打开的页面
settled	区分是否手动打开

方法	说明	参数
addOpened	添加打开的页面	1.页面对象，2.是否手动打开
removeOpened	移除打开的页面	路由路径
removeOpenedExcept	移除给定路径之外的所有已打开的页面	路由路径
removeOpenedMost	移除已打开的所有可关闭的页面	-
find	查找打开的页面中指定路径的页面	路由路径
has	判断已打开的页面中是否包含指定页面	路由路径
isSameFullPath	判断两个路径是否一样	1.路径一，2.路径二

Route

当前路由对象，包含了当前路由的所有信息，详情参考 RouteLocation API

Router

路由实例，包含了路由的所有操作，详情参考 Router API

Tool

工具类，包含一些对象或者函数

$Vue

包含两个属性和三个方法

app：当前根实例app对象，即当前的应用实例，也就是createApp方法返回的那个对象
self：vue包，可以获取到vuejs中的所有属性和方法
get(): 返回值与self相同
getConfig(): 返回当前应用实例的配置信息
getGlobalProperties(): 获取应用内的全局属性对象

UUID

用于生成uuid，详情参考 uuid npm

arrayToMapByKey

根据指定的标识将数组转成对象，不指定标识将默认使用 key 进行处理

指定 key 进行处理

b64

base64转码和解码

camelCase

连字符或者下划线转驼峰

camelCaseObj

将对象的连字符或下划线格式的key转换为驼峰格式

接收两个参数：第一个参数是要转换的对象，第二个参数表示是否只要转换后的驼峰格式的对象，如果为 true 的话，将返回新对象，并且只包含驼峰格式的字段，如果为 false 那么将改变原对象，保留原对象的属性，然后增加转换后的属性

causeError

抛出一个错误

connectorCase

驼峰转连字符

dateStrToLocalString

将日期字符串转换为本地时间格式的字符串，输出的是一个字符串，实际上输入的可以是任何可以实例化成日期的值

dater

用来处理日期的工具函数，可以对日期进行各种操作，详情参考 Day.js

emptyObject

清空一个对象

filterANotInB

接收两个参数，过滤出第一个对象中有的但是第二个对象中没有的属性

filterObjExclude

第一个参数为一个对象，后面可以跟多个参数，找出在这个对象中不以其他参数为 key 的属性对象

filterObjInclude

第一个参数为一个对象，后面可以跟多个参数，找出在这个对象中以其他参数为 key 的属性对象

findIndex

接收两个参数，第一个是数组，第二个是要查找的元素，返回该元素在数组中的索引

findTreeDataById

在树中查找id为给定值的数据，接收两个参数，第一个是树结构的数组，第二个是要查找的id，返回跟id匹配的元素对象

findTreeParentDataById

根据给定id，查找树中对应对象的父对象数据，接收两个参数，第一个是树结构的数组，第二个是要查找的id，返回跟id匹配的元素父对象

getABdiff

获取两个数组的差异，返回两个数组 A 和 B，A 中存放第一个数组中有但第二个数组中没有的元素，B 中存放第二个数组中有但第一个数组中没有的元素

也可以理解为第一个数组相对于第二个数组有哪些变化，添加了哪些元素和删除了哪些元素

getKebabFirst

获取连字符格式的字符串的首字母

getQueryObject

根据给定的URL参数返回他们的对象形式，参数要跟 location.search 类似，以问号开头，如果不传将默认解析当前地址栏

getQueryVariable

获取URL参数的某个参数值

getRandomStr

生成给定长度的随机串，默认长度为6

getRandomStr2

生成给定长度的随机串，不包含大写字母，默认长度为6

getStyleByName

根据给定的样式名称获取对应的样式对象

getSuffixName

获取文件后缀名，其中也包括文件实际的名字

getToken

获取当前登录用户的token，如果不传参将默认获取以lecenToken为标识的token，也可以传入一个参数，如 Company.auth.token 的设定的值来获取token

getTypeStr

获取给定参数的类型

interchange

交换数组中两个元素的位置，会改变原数组

isArray

判断是否为数组

isBoolean

判断是否为布尔值

isCustom

判断是否为自定以资源，字符串中是否包含 custom 字符串

isDate

判断是否为日期类型

isEmptyArray

判断是否为空数组

isEmptyObject

判断是否为空对象

isExternal

判断是否为外部地址

isFunction

判断是否为函数类型

isIcon

判断是否为 icon- 开头的icon图标

isLocal

判断是否为本地资源，如果既不是自定义的 custom 资源，也不是外部地址的 external 资源，那么就是本地资源

isNumber

判断是否为数值类型

isObject

判断是否为对象类型

isRegExp

判断是否为正则表达式类型

isString

判断是否为字符串类型

isSymbol

判断是否为 Symbol 类型

loadJS

加载js文件，可以传入一个字符串形式的地址，也可以传入多个地址的数据

lowerCaseObj

转换对象的键名为全部小写字母，第一个参数为要转换的对象，第二个参数表示是否为纯净版，如果为是，那么将返回一个新对象，并且只包含转换后的所有小写key的属性，如果为否，那么将修改原对象，增加转换后的属性

mapToArray

将对象转为数组

pathCompile

将参数路径转换为实际路径

removeArrayValue

移除数组中的某个元素

removeSurplusSpace

移除字符串中多余的空白符，只保留一个空格

removeToken

删除当前登录用户的token，如果不传参将默认删除以lecenToken为标识的token，也可以传入一个参数，如 Company.auth.token 的设定的值来删除token

resetToken

清空所有cookie数据

setToken

接收三个参数，第一个参数是token的标识，第二个是实际的token值，第三个是cookie的配置，包括生效的域名、路径以及过期时间等

setTokens

接收两个参数，第一个是包含多个token键值对的对象，第二个是cookie的配置信息

toTreeByCategory

根据 category 字段生成树结构，只能生成父子层级

transferToTreeByParent

根据 parent 生成树结构，可以生成多层级

turnToString

将传入的参数转成字符串

turnToString2

将传入的参数转成字符串,与上面的方法唯一不同就是处理字符串的逻辑

underlineCase

驼峰转下划线

upperFirst

首字母转大写

validAlphabets

验证字符串是否全部为字母组成

validEmail

判断是否为邮件地址

validLowerCase

判断字符串是否全部为小写字母

validURL

判断是否为一个链接地址

validUpperCase

判断是否全部为大写字母

TurnToPage

根据给定的参数跳转到指定页面

调用方式为 G.TurnToPage(params, query)

第一个参数为对象，formId 属性必传，可以设置 title 也可以添加其他属性，作为页面的属性添加到store中，第二个参数可以为路由指定查询参数。

params 跳转到新页面并传递过去的数据
query 地址参数

params 中必须有 formId 属性（就是跳转页面的pageId）

params 参数的数据最终可在 G.Page.current 中获得。

params 中的 title 属性能够作为跳转之后显示页面 tab 的标题文字，最多支持显示6个字符。

params 中的 detail 属性能设定跳转页面的 URL，值为一个数组。可按数组元素顺序生成路径。比如值为 ['a','b','c']，那么生成的路径就为 a/b/c

如果不传 params 或者不是一个对象，或者 params 中没有 formId 字段，那么将直接报错

如果传入了 path 那么就以它的值作为实际路径进行跳转

如果 params 中没传 detail 属性，或者 detail 不是一个数组，或者是个空数组，那么将取 path 的值来生成 detail 的值，如果 path 也没传，那么就使用默认规则生成的 detail

否则如果传了 detail 并且是一个非空数组，并且 path 也没传，那么将使用 detail 来生成 path

我们先只传入一个 formId 属性

看下实际发生的效果

这时已经跳转到我们指定的页面了，并且查询参数也添加成功，页面的标题也设置成功，页面也加载成功了

然后我们再多传几个自定义参数

我们看下 store 中的数据，也就是我们前面提到的 Page.current 对象

在实际页面设计中，我们可能有多种场景需要跳转页面，不光只是从配置的菜单点击跳转页面

以列表的 link 组件的 on_click 事件为例:

js 复制代码

function(){
  let row = this.scopeData.row
  row.title = row.biaoTi.slice(0,6)
  row.detail = ['page', 'formId', row.formId]
  this.G.TurnToPage(row, {
    _t: new Date().getTime()
  })
}

TurnToPageLocal

跳转本地地址，也就是管理端中的非设计页面的菜单