index.ts 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524
  1. import { toNumber } from 'lodash-es'
  2. /**
  3. *
  4. * @param component 需要注册的组件
  5. * @param alias 组件别名
  6. * @returns any
  7. */
  8. export const withInstall = <T>(component: T, alias?: string) => {
  9. const comp = component as any
  10. comp.install = (app: any) => {
  11. app.component(comp.name || comp.displayName, component)
  12. if (alias) {
  13. app.config.globalProperties[alias] = component
  14. }
  15. }
  16. return component as T & Plugin
  17. }
  18. /**
  19. * @param str 需要转下划线的驼峰字符串
  20. * @returns 字符串下划线
  21. */
  22. export const humpToUnderline = (str: string): string => {
  23. return str.replace(/([A-Z])/g, '-$1').toLowerCase()
  24. }
  25. /**
  26. * @param str 需要转驼峰的下划线字符串
  27. * @returns 字符串驼峰
  28. */
  29. export const underlineToHump = (str: string): string => {
  30. if (!str) return ''
  31. return str.replace(/\-(\w)/g, (_, letter: string) => {
  32. return letter.toUpperCase()
  33. })
  34. }
  35. /**
  36. * 驼峰转横杠
  37. */
  38. export const humpToDash = (str: string): string => {
  39. return str.replace(/([A-Z])/g, '-$1').toLowerCase()
  40. }
  41. export const setCssVar = (prop: string, val: any, dom = document.documentElement) => {
  42. dom.style.setProperty(prop, val)
  43. }
  44. /**
  45. * 查找数组对象的某个下标
  46. * @param {Array} ary 查找的数组
  47. * @param {Functon} fn 判断的方法
  48. */
  49. // eslint-disable-next-line
  50. export const findIndex = <T = Recordable>(ary: Array<T>, fn: Fn): number => {
  51. if (ary.findIndex) {
  52. return ary.findIndex(fn)
  53. }
  54. let index = -1
  55. ary.some((item: T, i: number, ary: Array<T>) => {
  56. const ret: T = fn(item, i, ary)
  57. if (ret) {
  58. index = i
  59. return ret
  60. }
  61. })
  62. return index
  63. }
  64. export const trim = (str: string) => {
  65. return str.replace(/(^\s*)|(\s*$)/g, '')
  66. }
  67. /**
  68. * @param {Date | number | string} time 需要转换的时间
  69. * @param {String} fmt 需要转换的格式 如 yyyy-MM-dd、yyyy-MM-dd HH:mm:ss
  70. */
  71. export function formatTime(time: Date | number | string, fmt: string) {
  72. if (!time) return ''
  73. else {
  74. const date = new Date(time)
  75. const o = {
  76. 'M+': date.getMonth() + 1,
  77. 'd+': date.getDate(),
  78. 'H+': date.getHours(),
  79. 'm+': date.getMinutes(),
  80. 's+': date.getSeconds(),
  81. 'q+': Math.floor((date.getMonth() + 3) / 3),
  82. S: date.getMilliseconds()
  83. }
  84. if (/(y+)/.test(fmt)) {
  85. fmt = fmt.replace(RegExp.$1, (date.getFullYear() + '').substr(4 - RegExp.$1.length))
  86. }
  87. for (const k in o) {
  88. if (new RegExp('(' + k + ')').test(fmt)) {
  89. fmt = fmt.replace(
  90. RegExp.$1,
  91. RegExp.$1.length === 1 ? o[k] : ('00' + o[k]).substr(('' + o[k]).length)
  92. )
  93. }
  94. }
  95. return fmt
  96. }
  97. }
  98. /**
  99. * 生成随机字符串
  100. */
  101. export function toAnyString() {
  102. const str: string = 'xxxxx-xxxxx-4xxxx-yxxxx-xxxxx'.replace(/[xy]/g, (c: string) => {
  103. const r: number = (Math.random() * 16) | 0
  104. const v: number = c === 'x' ? r : (r & 0x3) | 0x8
  105. return v.toString()
  106. })
  107. return str
  108. }
  109. /**
  110. * 根据支持的文件类型生成 accept 属性值
  111. *
  112. * @param supportedFileTypes 支持的文件类型数组,如 ['PDF', 'DOC', 'DOCX']
  113. * @returns 用于文件上传组件 accept 属性的字符串
  114. */
  115. export const generateAcceptedFileTypes = (supportedFileTypes: string[]): string => {
  116. const allowedExtensions = supportedFileTypes.map((ext) => ext.toLowerCase())
  117. const mimeTypes: string[] = []
  118. // 添加常见的 MIME 类型映射
  119. if (allowedExtensions.includes('txt')) {
  120. mimeTypes.push('text/plain')
  121. }
  122. if (allowedExtensions.includes('pdf')) {
  123. mimeTypes.push('application/pdf')
  124. }
  125. if (allowedExtensions.includes('html') || allowedExtensions.includes('htm')) {
  126. mimeTypes.push('text/html')
  127. }
  128. if (allowedExtensions.includes('csv')) {
  129. mimeTypes.push('text/csv')
  130. }
  131. if (allowedExtensions.includes('xlsx') || allowedExtensions.includes('xls')) {
  132. mimeTypes.push('application/vnd.ms-excel')
  133. mimeTypes.push('application/vnd.openxmlformats-officedocument.spreadsheetml.sheet')
  134. }
  135. if (allowedExtensions.includes('docx') || allowedExtensions.includes('doc')) {
  136. mimeTypes.push('application/msword')
  137. mimeTypes.push('application/vnd.openxmlformats-officedocument.wordprocessingml.document')
  138. }
  139. if (allowedExtensions.includes('pptx') || allowedExtensions.includes('ppt')) {
  140. mimeTypes.push('application/vnd.ms-powerpoint')
  141. mimeTypes.push('application/vnd.openxmlformats-officedocument.presentationml.presentation')
  142. }
  143. if (allowedExtensions.includes('xml')) {
  144. mimeTypes.push('application/xml')
  145. mimeTypes.push('text/xml')
  146. }
  147. if (allowedExtensions.includes('md') || allowedExtensions.includes('markdown')) {
  148. mimeTypes.push('text/markdown')
  149. }
  150. if (allowedExtensions.includes('epub')) {
  151. mimeTypes.push('application/epub+zip')
  152. }
  153. if (allowedExtensions.includes('eml')) {
  154. mimeTypes.push('message/rfc822')
  155. }
  156. if (allowedExtensions.includes('msg')) {
  157. mimeTypes.push('application/vnd.ms-outlook')
  158. }
  159. // 添加文件扩展名
  160. const extensions = allowedExtensions.map((ext) => `.${ext}`)
  161. return [...mimeTypes, ...extensions].join(',')
  162. }
  163. /**
  164. * 首字母大写
  165. */
  166. export function firstUpperCase(str: string) {
  167. return str.toLowerCase().replace(/( |^)[a-z]/g, (L) => L.toUpperCase())
  168. }
  169. export const generateUUID = () => {
  170. if (typeof crypto === 'object') {
  171. if (typeof crypto.randomUUID === 'function') {
  172. return crypto.randomUUID()
  173. }
  174. if (typeof crypto.getRandomValues === 'function' && typeof Uint8Array === 'function') {
  175. const callback = (c: any) => {
  176. const num = Number(c)
  177. return (num ^ (crypto.getRandomValues(new Uint8Array(1))[0] & (15 >> (num / 4)))).toString(
  178. 16
  179. )
  180. }
  181. return '10000000-1000-4000-8000-100000000000'.replace(/[018]/g, callback)
  182. }
  183. }
  184. let timestamp = new Date().getTime()
  185. let performanceNow =
  186. (typeof performance !== 'undefined' && performance.now && performance.now() * 1000) || 0
  187. return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
  188. let random = Math.random() * 16
  189. if (timestamp > 0) {
  190. random = (timestamp + random) % 16 | 0
  191. timestamp = Math.floor(timestamp / 16)
  192. } else {
  193. random = (performanceNow + random) % 16 | 0
  194. performanceNow = Math.floor(performanceNow / 16)
  195. }
  196. return (c === 'x' ? random : (random & 0x3) | 0x8).toString(16)
  197. })
  198. }
  199. /**
  200. * element plus 的文件大小 Formatter 实现
  201. *
  202. * @param row 行数据
  203. * @param column 字段
  204. * @param cellValue 字段值
  205. */
  206. // @ts-ignore
  207. export const fileSizeFormatter = (row, column, cellValue) => {
  208. const fileSize = cellValue
  209. const unitArr = ['Bytes', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB']
  210. const srcSize = parseFloat(fileSize)
  211. const index = Math.floor(Math.log(srcSize) / Math.log(1024))
  212. const size = srcSize / Math.pow(1024, index)
  213. const sizeStr = size.toFixed(2) //保留的小数位数
  214. return sizeStr + ' ' + unitArr[index]
  215. }
  216. /**
  217. * 将值复制到目标对象,且以目标对象属性为准,例:target: {a:1} source:{a:2,b:3} 结果为:{a:2}
  218. * @param target 目标对象
  219. * @param source 源对象
  220. */
  221. export const copyValueToTarget = (target: any, source: any) => {
  222. const newObj = Object.assign({}, target, source)
  223. // 删除多余属性
  224. Object.keys(newObj).forEach((key) => {
  225. // 如果不是target中的属性则删除
  226. if (Object.keys(target).indexOf(key) === -1) {
  227. delete newObj[key]
  228. }
  229. })
  230. // 更新目标对象值
  231. Object.assign(target, newObj)
  232. }
  233. /**
  234. * 获取链接的参数值
  235. * @param key 参数键名
  236. * @param urlStr 链接地址,默认为当前浏览器的地址
  237. */
  238. export const getUrlValue = (key: string, urlStr: string = location.href): string => {
  239. if (!urlStr || !key) return ''
  240. const url = new URL(decodeURIComponent(urlStr))
  241. return url.searchParams.get(key) ?? ''
  242. }
  243. /**
  244. * 获取链接的参数值(值类型)
  245. * @param key 参数键名
  246. * @param urlStr 链接地址,默认为当前浏览器的地址
  247. */
  248. export const getUrlNumberValue = (key: string, urlStr: string = location.href): number => {
  249. return toNumber(getUrlValue(key, urlStr))
  250. }
  251. /**
  252. * 构建排序字段
  253. * @param prop 字段名称
  254. * @param order 顺序
  255. */
  256. export const buildSortingField = ({ prop, order }) => {
  257. return { field: prop, order: order === 'ascending' ? 'asc' : 'desc' }
  258. }
  259. // ========== NumberUtils 数字方法 ==========
  260. /**
  261. * 数组求和
  262. *
  263. * @param values 数字数组
  264. * @return 求和结果,默认为 0
  265. */
  266. export const getSumValue = (values: number[]): number => {
  267. return values.reduce((prev, curr) => {
  268. const value = Number(curr)
  269. if (!Number.isNaN(value)) {
  270. return prev + curr
  271. } else {
  272. return prev
  273. }
  274. }, 0)
  275. }
  276. // ========== 通用金额方法 ==========
  277. /**
  278. * 将一个整数转换为分数保留两位小数
  279. * @param num
  280. */
  281. export const formatToFraction = (num: number | string | undefined): string => {
  282. if (typeof num === 'undefined') return '0.00'
  283. const parsedNumber = typeof num === 'string' ? parseFloat(num) : num
  284. return (parsedNumber / 100.0).toFixed(2)
  285. }
  286. /**
  287. * 将一个数转换为 1.00 这样
  288. * 数据呈现的时候使用
  289. *
  290. * @param num 整数
  291. */
  292. // TODO @芋艿:看看怎么融合掉
  293. export const floatToFixed2 = (num: number | string | undefined): string => {
  294. let str = '0.00'
  295. if (typeof num === 'undefined') {
  296. return str
  297. }
  298. const f = formatToFraction(num)
  299. const decimalPart = f.toString().split('.')[1]
  300. const len = decimalPart ? decimalPart.length : 0
  301. switch (len) {
  302. case 0:
  303. str = f.toString() + '.00'
  304. break
  305. case 1:
  306. str = f.toString() + '0'
  307. break
  308. case 2:
  309. str = f.toString()
  310. break
  311. }
  312. return str
  313. }
  314. /**
  315. * 将一个分数转换为整数
  316. * @param num
  317. */
  318. // TODO @芋艿:看看怎么融合掉
  319. export const convertToInteger = (num: number | string | undefined): number => {
  320. if (typeof num === 'undefined') return 0
  321. const parsedNumber = typeof num === 'string' ? parseFloat(num) : num
  322. // TODO 分转元后还有小数则四舍五入
  323. return Math.round(parsedNumber * 100)
  324. }
  325. /**
  326. * 元转分
  327. */
  328. export const yuanToFen = (amount: string | number): number => {
  329. return convertToInteger(amount)
  330. }
  331. /**
  332. * 分转元
  333. */
  334. export const fenToYuan = (price: string | number): string => {
  335. return formatToFraction(price)
  336. }
  337. /**
  338. * 计算环比
  339. *
  340. * @param value 当前数值
  341. * @param reference 对比数值
  342. */
  343. export const calculateRelativeRate = (value?: number, reference?: number) => {
  344. // 防止除0
  345. if (!reference || reference == 0) return 0
  346. return ((100 * ((value || 0) - reference)) / reference).toFixed(0)
  347. }
  348. // ========== ERP 专属方法 ==========
  349. const ERP_COUNT_DIGIT = 3
  350. const ERP_PRICE_DIGIT = 2
  351. /**
  352. * 【ERP】格式化 Input 数字
  353. *
  354. * 例如说:库存数量
  355. *
  356. * @param num 数量
  357. * @package digit 保留的小数位数
  358. * @return 格式化后的数量
  359. */
  360. export const erpNumberFormatter = (num: number | string | undefined, digit: number) => {
  361. if (num == null) {
  362. return ''
  363. }
  364. if (typeof num === 'string') {
  365. num = parseFloat(num)
  366. }
  367. // 如果非 number,则直接返回空串
  368. if (isNaN(num)) {
  369. return ''
  370. }
  371. return num.toFixed(digit)
  372. }
  373. /**
  374. * 【ERP】格式化数量,保留三位小数
  375. *
  376. * 例如说:库存数量
  377. *
  378. * @param num 数量
  379. * @return 格式化后的数量
  380. */
  381. export const erpCountInputFormatter = (num: number | string | undefined) => {
  382. return erpNumberFormatter(num, ERP_COUNT_DIGIT)
  383. }
  384. // noinspection JSCommentMatchesSignature
  385. /**
  386. * 【ERP】格式化数量,保留三位小数
  387. *
  388. * @param cellValue 数量
  389. * @return 格式化后的数量
  390. */
  391. export const erpCountTableColumnFormatter = (_, __, cellValue: any, ___) => {
  392. return erpNumberFormatter(cellValue, ERP_COUNT_DIGIT)
  393. }
  394. /**
  395. * 【ERP】格式化金额,保留二位小数
  396. *
  397. * 例如说:库存数量
  398. *
  399. * @param num 数量
  400. * @return 格式化后的数量
  401. */
  402. export const erpPriceInputFormatter = (num: number | string | undefined) => {
  403. return erpNumberFormatter(num, ERP_PRICE_DIGIT)
  404. }
  405. // noinspection JSCommentMatchesSignature
  406. /**
  407. * 【ERP】格式化金额,保留二位小数
  408. *
  409. * @param cellValue 数量
  410. * @return 格式化后的数量
  411. */
  412. export const erpPriceTableColumnFormatter = (_, __, cellValue: any, ___) => {
  413. return erpNumberFormatter(cellValue, ERP_PRICE_DIGIT)
  414. }
  415. /**
  416. * 【ERP】价格计算,四舍五入保留两位小数
  417. *
  418. * @param price 价格
  419. * @param count 数量
  420. * @return 总价格。如果有任一为空,则返回 undefined
  421. */
  422. export const erpPriceMultiply = (price: number, count: number) => {
  423. if (price == null || count == null) {
  424. return undefined
  425. }
  426. return parseFloat((price * count).toFixed(ERP_PRICE_DIGIT))
  427. }
  428. /**
  429. * 【ERP】百分比计算,四舍五入保留两位小数
  430. *
  431. * 如果 total 为 0,则返回 0
  432. *
  433. * @param value 当前值
  434. * @param total 总值
  435. */
  436. export const erpCalculatePercentage = (value: number, total: number) => {
  437. if (total === 0) return 0
  438. return ((value / total) * 100).toFixed(2)
  439. }
  440. /**
  441. * 适配 echarts map 的地名
  442. *
  443. * @param areaName 地区名称
  444. */
  445. export const areaReplace = (areaName: string) => {
  446. if (!areaName) {
  447. return areaName
  448. }
  449. return areaName
  450. .replace('维吾尔自治区', '')
  451. .replace('壮族自治区', '')
  452. .replace('回族自治区', '')
  453. .replace('自治区', '')
  454. .replace('省', '')
  455. }
  456. /**
  457. * 解析 JSON 字符串
  458. *
  459. * @param str
  460. */
  461. export function jsonParse(str: string) {
  462. try {
  463. return JSON.parse(str)
  464. } catch (e) {
  465. console.error(`str[${str}] 不是一个 JSON 字符串`)
  466. return ''
  467. }
  468. }
  469. /**
  470. * 截取字符串
  471. *
  472. * @param name
  473. * @param start
  474. * @param end
  475. */
  476. export const sliceName = (name: string,start: number, end : number) => {
  477. if (name.length > end) {
  478. return name.slice(start, end)
  479. }
  480. return name
  481. }