工具类库

WARNING

文档未完成

工具类库（@/core/util.js）是预置的实用工具，在@/core/index.js中默认导出，便于引用。

/**
 * 引用内置工具
 * */

// 全部引入
import * as util from "@/core";

// 按需引入
import { storage } from "@/core";

storage(key, [value])

本地存储，基于window.localStorage实现，支持 JSON 格式存取前自动转换

@param key[String] 要存/取的键；自动将process.env.BASE_URL做为命名空间，也可以在vue.config.js里设置process.env.VUE_APP_STORAGE_SPACE更改命名空间。
@param value[any] 要存的值，若缺省则返回 key 的值
@return 只传 key 会返回该 key 的值

deepcopy(source)

对象/数组深拷贝

@param source[Object|Array] 要拷贝的对象
@return 深拷贝后的对象/数组

buildTree(array, [parentKey], [sortFunction])

一维对象数组转树形结构

@param array[对象数组] 对象数组中的对象必须包含 id 和[parentKey]键，如{id: 1, pid: 0}。pid 值为假或等于自身 id，则判定为一级节点
@param parentKey[String] 指向上级 id 的 key，默认"pid"
@param sortFunction[Function] 用于 arrayObject.sort(sortFunction)的排序方法，默认不排序
@return 由 children 键建立层级的对象数组

formatDate(value, [fmt])

日期格式化

@param value[milliseconds/dateString] 可以通过 new Date()方法创建日期对象的毫秒数或日期字符串
@param fmt[String/undefined] 日期格式化模板字符串，例如"yyyy/MM/dd hh:mm:ss"
@return 格式化后的日期字符串
内置四种 fmt 快捷方式：

快捷方式	模板
year	yyyy
month	yyyy/MM
day	yyyy/MM/dd
day-time	yyyy/MM/dd hh:mm

on(eventName, eventHandle)

全局事件监听。重复注册同一个事件，只保留最后一次，使单页面应用反复进入页面不会重复注册事件；可以通过别名方式将一个事件多次注册。

@param eventName[String] 自定义事件名称，支持用双下划线添加别名，如 eventName__ANYSTRING
@param eventHandle[Function] 事件回调方法，参数接收触发事件方法发送的参数；缺省将关闭该事件监听

emit(eventName, [msg])

全局事件触发

@param eventName[String] 要触发的事件名称，不需要包含别名部分，如 "myEvent__alias1"，只需要传 "myEvent"
@param msg[any] 触发事件时携带的参数

getSuffix(filename)

提取文件名中的扩展名

@param filename[String] 要提取扩展名的字符串
@return 转小写后的扩展名

throttle(method, [delay, duration])

函数节流

@param method[Function] 要节流的函数方法
@param delay[Number] 过滤执行的间隔毫秒数，默认 128
@param duration 至少执行一次的间隔毫秒数，默认 1000
@return 具有节流特性的新函数

getUrlParam(keyName, [url])

获取 url 中的 query 值

@param keyName[String] 要获取的参数名
@param url[String] 目标 url，缺省则取当前窗口 url
@return keyName 参数的值，如果获取失败返回null

loadScript(path, options)

加载 JS 文件

@param filePath[String/Array] 文件路径,支持多个
@param option[Object] 配置
@param option.css[Boolean/String] 同时加载 css, 可以指定 css 路径,或传入 true 加载同名 css; 默认 false
@param option.beforeLoad[Function] 加载前执行
@param option.rely[Boolean] 多个脚本是否依次加载; 默认 false

Vue 全局功能

将高频使用的 Vue 功能全局注册可以显著提高开发效率，在多人协作的项目中，Vue 全局功能必须有一个明确、集中的管理方式，否则很容易导致全局功能得不到充分利用，项目内各自造轮子的情况。

注册器

全局功能注册器（@/core/register.js）是一个专门注册 Vue 全局功能的 Vue 插件，在项目入口文件（@/main.js）中调用。原则上项目中的所有 Vue 全局功能都应该在这里注册，包括：方法、组件、过滤器、指令等。

注册全局功能应遵循谨慎且必要原则，通常我们会将通用 UI 组件、高频功能组件全局注册，避免客户端频繁加载同一个组件。

开发须知

由于通用增删改查组件（@/main/components/BaseCURD.vue）的实现机制，数据模型中指定的展示控件也必须注册为全局组件。
全局组件命名应遵守组件命名规范，做到表意清晰、准确。
全局组件有三种组件注册方式：同步加载、合并打包异步加载、常规异步加载。同步加载可以确保界面能第一时间渲染组件，常用于 UI 组件；合并打包异步加载适用于渲染优先级不像 UI 组件那么高，但使用率较高的组件，将他们打成一个包可以避免界面由于频繁异步请求组件导致的卡顿感；其余使用率不是那么高的组件，就使用常规异步加载方式，按需加载，避免不必要的客户端请求。

/**
 * @/core/register.js
 *
 * */

// 全局组件
import BaseHeader from '@/main/components/BaseHeader.vue'

const globalComponents = {
    BaseHeader,
    BaseBreadcrumb: () => import(/* webpackChunkName: "global-components" */ "@/main/components/BaseBreadcrumb.vue"),
    BaseSubNav: () => import(/* webpackChunkName: "global-components" */ "@/main/components/BaseSubNav.vue"),
    BasePagination: () => import(/* webpackChunkName: "global-components" */ "@/main/components/BasePagination.vue"),
    BaseCURD:  () => import(/* webpackChunkName: "global-components" */ "@/main/components/BaseCURD.vue"),
    DictRadio:  () => import(/* webpackChunkName: "global-components" */ "@/main/components/DictRadio.vue"),
    DictCheckbox:  () => import(/* webpackChunkName: "global-components" */ "@/main/components/DictCheckbox.vue"),
    DictSelect:  () => import(/* webpackChunkName: "global-components" */ "@/main/components/DictSelect.vue"),
    DictCascader:  () => import(/* webpackChunkName: "global-components" */ "@/main/components/DictCascader.vue"),
    OrgPicker:  (resolve) => require(["@/system/components/OrgPicker.vue"], resolve),
    TheResourcePicker:  (resolve) => require(["@/system/components/TheResourcePicker.vue"], resolve),

}

export default {
    install: function (Vue) {
        // 注册组件
        Object.keys(globalComponents).forEach(key => {
            Vue.component(key, globalComponents[key])
        })

        ...

# 工具类库

# storage(key, [value])

# deepcopy(source)

# buildTree(array, [parentKey], [sortFunction])

# formatDate(value, [fmt])

# on(eventName, eventHandle)

# emit(eventName, [msg])

# getSuffix(filename)

# throttle(method, [delay, duration])

# getUrlParam(keyName, [url])

# loadScript(path, options)

# Vue 全局功能

# 注册器

# 开发须知