vr-uniapp/src/utils/index.ts

429 lines
18 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

import CommonAPI from '@/api/common';
// 定义一组预定义的颜色数组,用于在各种场景中轻松引用这些颜色
// 这些颜色包括从白色到黑色的不同灰度以及一些鲜艳的颜色格式有十六进制、RGB、RGBA、HSV、HSL等
export const predefine_colors = ['#fff', '#ddd', '#ccc', '#999', '#666', '#333', '#000', '#ff4500', '#ff8c00', '#ffd700', '#90ee90', '#00ced1', '#c71585', 'rgba(255, 69, 0, 0.68)', 'rgb(255, 120, 0)', 'hsv(51, 100, 98)', 'hsva(120, 40, 94, 0.5)', 'hsl(181, 100%, 37%)', '#1F93FF', '#c7158577'];
/**
* 判断一个对象是否为空。
*
* 为空的定义是对象的键的数量为0。这适用于任何对象包括普通对象、数组视为对象等。
* 该函数不直接使用`Object.keys(obj).length === 0`进行判断,而是通过封装这个逻辑来提供一个独立的、可重用的函数。
* 这样做可以增加代码的可读性和可维护性,并且抽象了对象为空的检查,使得调用者不需要关心具体的实现细节。
*
* @param obj 要检查的对象。可以是任何类型的对象,包括数组。
* @returns 如果对象为空则返回true否则返回false。
*/
export function is_obj_empty(obj: object): boolean {
return Object.keys(obj).length === 0;
}
/**
* 将对象或数组中的字符串转换为数字
* 此函数递归地遍历给定对象或数组,将所有能转换为数字的字符串转换成数字类型
* 如果字符串不能转换为数字,则保留原字符串
*
* @param obj 任意类型的对象或数组,需要转换其中的字符串
* @param maxDepth 递归的最大深度默认为100用于防止无限递归
* @param currentDepth 当前递归的深度默认为0
* @returns 转换后的对象或数组,结构与原输入相同
*/
export function convert_strings_to_numbers(obj: any, maxDepth: number = 100, currentDepth: number = 0): any {
// 递归深度限制
if (currentDepth >= maxDepth) {
return obj;
}
if (Array.isArray(obj)) {
// 处理数组
return obj.map((item) => convert_strings_to_numbers(item, maxDepth, currentDepth + 1));
} else if (is_obj(obj)) {
// 处理对象
return Object.keys(obj).reduce((acc: any, key: string) => {
const value = obj[key];
if (typeof value === 'string') {
// 处理字符串
const numValue = Number(value);
if (!isNaN(numValue) && value.trim() !== '') {
acc[key] = numValue;
} else {
acc[key] = value;
}
} else if (is_obj(value)) {
// 递归处理子对象
acc[key] = convert_strings_to_numbers(value, maxDepth, currentDepth + 1);
} else {
// 其他类型直接保留
acc[key] = value;
}
return acc;
}, {});
} else {
// 非对象类型直接返回
return obj;
}
}
/**
* 检查给定的参数是否为对象
*
* 此函数用于精确地验证一个变量是否为对象类型它通过以下步骤实现:
* 1. 特殊处理 `null` 值,因为 `null` 在 JavaScript 中被当作对象处理,但实质上它不是
* 2. 使用 `typeof` 操作符初步判断变量是否为对象
* 3. 使用 `Object.prototype.toString.call(obj)` 方法精确判断变量是否为普通的对象
*
* @param obj 未知类型的参数,待检查是否为对象
* @returns 如果参数是对象,则返回 true否则返回 false
*/
export function is_obj(obj: unknown): boolean {
// 特殊处理 null值因为 typeof null 返回 "object",但 null 并不是我们要检查的对象
if (obj === null) return false;
// 使用 typeof 排除非对象类型
if (typeof obj != 'object') return false;
// 确认是普通对象
return Object.prototype.toString.call(obj) === '[object Object]';
}
/**
* 渐变色的方法
* color_list: [] 渐变色的存储
* direction 渐变色的角度
* @param {string[], string} path
* @returns {string}
*/
export function gradient_computer(new_style: gradientStyle, is_return_all: boolean = true) {
let color_list = new_style.color_list;
let direction = new_style.direction;
return gradient_handle(color_list, direction, is_return_all);
}
/**
* 根据给定的颜色列表和方向生成一个线性渐变的CSS样式字符串。
*
* @param color_list 颜色列表,包含渐变中的各个颜色值。
* @param direction 渐变的方向可以是角度或其他CSS支持的渐变方向。
* @param is_return_all 是否返回所有样式包括渐变类型、颜色列表和方向。默认为false只返回渐变样式。
* @returns 返回一个字符串,包含生成的线性渐变样式。
*/
export function gradient_handle(color_list: color_list[], direction: string, is_return_all: boolean = true) {
let container_common_styles = ``;
if (color_list && color_list.length > 0) {
if (is_return_all) {
container_common_styles += `background:`;
}
container_common_styles += `linear-gradient(${direction || '180deg'},`;
const new_color_list = JSON.parse(JSON.stringify(color_list));
new_color_list.forEach((item: any, index: number) => {
container_common_styles += `${item.color ? item.color : 'rgb(255 255 255 / 0%)'}`;
if (color_list.length == 1) {
container_common_styles += ` ${item.color_percentage || 0}%, ${item.color ? item.color : 'rgb(255 255 255 / 0%)'} 100%`;
} else {
if (typeof item.color_percentage === 'number') {
if (index == color_list.length - 1) {
container_common_styles += ` ${item.color_percentage}%`;
} else {
container_common_styles += ` ${item.color_percentage}%,`;
}
} else {
if (index == color_list.length - 1) {
container_common_styles += ` 100%`;
} else if (index == 0) {
container_common_styles += ` 0%,`;
} else {
container_common_styles += ` ${(100 / color_list.length) * index}%,`;
}
}
}
});
container_common_styles += `)`;
if (is_return_all) {
container_common_styles += `;`;
}
}
return container_common_styles;
}
/**
* 设置内边距的方法
* new_style: 内边距的集合
* @param {string[], string} path
* @returns {string}
*/
interface newPaddingStyle extends paddingStyle {
padding_top_safe_value?: number;
}
export function padding_computer(new_style: newPaddingStyle, scale: number = 1) {
let top = new_style.padding_top;
if (typeof new_style.padding_top_safe_value == 'number') {
top += new_style.padding_top_safe_value;
}
return `padding: ${top * scale || 0}px ${new_style.padding_right * scale || 0}px ${new_style.padding_bottom * scale || 0}px ${new_style.padding_left * scale || 0}px;`;
}
/**
* 设置外边距的方法
* new_style: 外边距的集合
* @param {string[], string} path
* @returns {string}
*/
export function margin_computer(new_style: marginStyle) {
return `margin: ${new_style.margin_top || 0}px ${new_style.margin_right || 0}px ${new_style.margin_bottom || 0}px ${new_style.margin_left || 0}px;`;
}
/**
* 设置圆角的方法
* new_style: 外边距的集合
* @param {string[], string} path
* @returns {string}
*/
export function radius_computer(new_style: radiusStyle, scale: number = 1) {
return `border-radius: ${new_style.radius_top_left * scale || 0}px ${new_style.radius_top_right * scale || 0}px ${new_style.radius_bottom_right * scale || 0}px ${new_style.radius_bottom_left * scale || 0}px;`;
}
/**
* 设置阴影样式
* new_style: 外边距的集合
* @param {string[], string} path
* @returns {string}
*/
export function box_shadow_computer(new_style: boxShadowStyle) {
return `box-shadow: ${new_style.box_shadow_x || 0}px ${new_style.box_shadow_y || 0}px ${new_style.box_shadow_blur || 0}px ${new_style.box_shadow_spread || 0}px ${new_style.box_shadow_color || 'rgba(0,0,0,0)'};`;
}
/**
* 设置阴影样式
* new_style: 外边距的集合
* @param {string[], string} path
* @returns {string}
*/
export function background_computer(new_style: backgroundImgUrlStyle) {
if (new_style.background_img.length > 0) {
let url_styke = '';
if (new_style.background_img_style == '1') {
url_styke = 'background-repeat: repeat;';
} else if (new_style.background_img_style == '2') {
} else {
url_styke = `background-repeat: no-repeat;background-position: center;`;
}
switch (new_style.background_img_style) {
case '1':
url_styke = `background-repeat: no-repeat;background-position: bottom;background-size: 100% auto;`;
break;
case '2':
url_styke = `background-repeat: no-repeat;background-position: center;background-size: 100% auto;`;
break;
case '3':
url_styke = 'background-repeat: repeat;';
break;
case '4':
url_styke = 'background-size: cover;background-position: center;';
break;
default:
url_styke = `background-repeat: no-repeat;background-position: top;background-size: 100% auto;`;
break;
}
return `background-image:url(${new_style.background_img[0].url});${url_styke}`;
} else {
return '';
}
}
/**
* 计算并组合组件的常用样式。
*
* 该函数通过调用一系列特定样式的计算函数,来组装一个组件的常用样式字符串。
* 这些样式包括渐变色、内边距、外边距、圆角和阴影等,为组件提供了一套完整的外观定义。
*
* @param new_style 组件的新样式对象,包含了需要计算的样式属性。
* @returns 返回一个字符串,包含了计算后的样式定义,可以被直接应用于组件的样式属性。
*/
export function common_styles_computer(new_style: componentsCommonCommonStyle) {
return gradient_computer(new_style) + margin_computer(new_style) + radius_computer(new_style) + box_shadow_computer(new_style) + `overflow:hidden;`;
}
export function common_img_computer(new_style: componentsCommonCommonStyle) {
return padding_computer(new_style) + background_computer(new_style) + `overflow:hidden;`;
}
/**
* 生成一个随机数学字符串。
* @returns {string} 一个6位的36进制随机字符串。
*/
export function get_math() {
// 通过Math.random()生成随机数并转换为36进制的字符串
let randomString = Math.random().toString(36);
// 确保随机字符串至少有6位因为substring(2)可能会使短于6位的字符串产生错误。
// 如果字符串长度不足6位通过padStart将其前面填充为0直到长度达到6位。
randomString = randomString.length >= 6 ? randomString : randomString.padStart(6, '0');
// 截取掉随机字符串开头的'0.'部分获得最终的6位随机字符串。
return randomString.substring(2);
}
/**
* 附件字节大小转换为单位
* @author Devil
* @blog http://gong.gg/
* @version 1.0.0
* @date 2024-07-21
* @desc description
* @param {int} size [文件大小]
*/
export function annex_size_to_unit(size: number = 0) {
var unit = 'KB';
var kb = size / 1024;
if (kb < 1024) {
unit = 'KB';
size = Math.round(kb * 100) / 100;
} else if (kb < 1024 * 1024) {
unit = 'MB';
size = Math.round((size / (1024 * 1024)) * 100) / 100;
} else if (kb < 1024 * 1024 * 1024) {
unit = 'GB';
size = Math.round((size / (1024 * 1024 * 1024)) * 100) / 100;
}
return size + unit;
}
/**
* 获取文件名的扩展名。
* 该函数用于从给定的文件名中提取扩展名。它通过寻找文件名中最后一个点字符的位置来确定扩展名的开始,
* 并返回从该位置到字符串结尾的所有字符。如果文件名中没有点字符,或者点字符位于文件名的开头,
* 则表示没有扩展名,函数将返回空字符串。
*
* @param name 文件名或路径名。
* @returns 文件名的扩展名,如果不存在扩展名则返回空字符串。
*/
export const ext_name = (name: string) => {
// 查找最后一个点字符的位置。
const i = name.lastIndexOf('.');
// 如果找到了点字符,并且点字符不是在字符串的开头(即确保它是扩展名的一部分)。
if (i >= 0) {
// 从点字符位置到字符串末尾提取扩展名,并转换为小写。
return name.substring(i).toLowerCase();
}
// 如果没有找到点字符,或者点字符在字符串的开头,返回空字符串。
return '';
};
/**
* 将大小计算成百分比
*
* @param num 当前的大小或位置。
* @param size 容器的大小。
* @returns 计算后的百分比值含4位小数
*/
export const percentage_count = (num: number, container_size: number) => {
const marks = (num / container_size) * 100;
return marks.toFixed(4) + '%';
};
/**
* 计算当前偏移量
*
* @param size 当前的组件的大小宽或者高。
* @param location 容器的位置的偏移量。
* @param container_size 对应位置的容器的大小
* @returns 偏移量
*/
export const location_compute = (size: number, location: number, container_size: number) => {
if (size + location >= container_size) {
const deviation = container_size - size;
if (deviation >= 0) {
return deviation;
} else {
return 0;
}
} else {
return location;
}
};
/**
* 读取指定名称的cookie值
* @param name 需要读取的cookie的名称
* @returns 返回cookie的值如果未找到则返回空字符串
*/
export const get_cookie = (name: string) => {
// 初始化cookie值为空字符串
var cookievalue = '';
// 定义要搜索的cookie名称字符串
var search = name + '=';
// 检查是否存在cookie
if (document.cookie.length > 0) {
// 尝试查找cookie名称的位置
let offset = document.cookie.indexOf(search);
// 如果找到了cookie名称
if (offset != -1) {
// 跳过cookie名称的长度
offset += search.length;
// 查找cookie值的结束位置可能是分号或者字符串末尾
let end = document.cookie.indexOf(';', offset);
if (end == -1) end = document.cookie.length;
// 提取并解码cookie值
cookievalue = decodeURIComponent(document.cookie.substring(offset, end));
}
}
// 返回获取到的cookie值
return cookievalue;
};
/**
* 设置cookie
* 该函数用于设置一个cookie包括cookie的名称、值和过期时间
* @param name {string} - cookie的名称
* @param value {string} - cookie的值
* @param expire_time {number} - cookie的过期时间单位为天
*/
export const set_cookie = (name: string, value: string, expire_time?: number) => {
// 构造cookie字符串
var cookie_str = name + '=' + encodeURIComponent(value);
if (expire_time) {
// 获取当前时间
var now = new Date();
// 计算过期时间
var expire_date = new Date(now.getTime() + expire_time * 86400);
cookie_str += ';expires=' + expire_date.toUTCString();
// 将新增的cookie储存到cookie中可以存储多个而不是替换
document.cookie = cookie_str;
} else {
// 将新增的cookie储存到cookie中可以存储多个而不是替换
document.cookie = cookie_str;
}
};
// style 风格
export const tabs_style = (color: string, style: string | number | boolean | undefined) => {
const color_list = ['rgba(51,51,51,1)', 'rgba(255, 34, 34, 1)', 'rgba(255, 255, 255, 1)'];
if (color_list.includes(color)) {
if (style == '2' || style == '4') {
return 'rgba(255, 255, 255, 1)';
} else if (style == '3') {
return 'rgba(255, 34, 34, 1)';
} else {
return 'rgba(51,51,51,1)';
}
} else {
return color;
}
};
/**
* 获取在线资源URL的异步函数
* 该函数根据当前环境变量的配置选择不同的方式来获取资源URL
* 如果环境变量VITE_APP_BASE_API被设置为'/dev-api',则从本地开发环境中导入临时数据
* 否则从cookie中获取资源主机地址
* 这种设计允许开发者在不同的环境中灵活切换资源URL的来源以适应不同的开发和生产需求
* @param directory {string} - 资源目录名称
* @returns {Promise<string>} 返回一个Promise解析为包含资源URL的字符串
*/
export const online_url = async (directory: string = '') => {
if (import.meta.env.VITE_APP_BASE_API == '/dev-api') {
let temp_data = await import(import.meta.env.VITE_APP_BASE_API == '/dev-api' ? '../../temp.d' : '../../temp_pro.d');
return temp_data.default.temp_attachment_host + directory;
} else {
// let attachemnt_host = common.config.attachment_host;
let attachemnt_host = get_cookie('attachment_host') && get_cookie('attachment_host') !== 'null' && get_cookie('attachment_host') !== null ? get_cookie('attachment_host') : '';
if (attachemnt_host.length <= 0) {
await CommonAPI.getInit().then((res: any) => {
set_cookie('attachment_host', res.data.config.attachment_host);
attachemnt_host = res.data.config.attachment_host;
// 将数据存到localStorage中
localStorage.setItem('diy_init_common', res.data);
});
}
return attachemnt_host + directory;
}
};