tang-ui-x 1.0.0

package/utils/color.uts

@@ -0,0 +1,92 @@
+/**
+ * 颜色处理工具函数
+ * @description 提供颜色转换、处理等功能
+ */
+
+/**
+ * 十六进制颜色转 RGB
+ * @param hex 十六进制颜色值，如 #ffffff
+ * @returns RGB 对象 { r, g, b }
+ */
+export function hexToRgb(hex: string): { r: number; g: number; b: number } | null {
+  const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex)
+  return result
+    ? {
+        r: parseInt(result[1], 16),
+        g: parseInt(result[2], 16),
+        b: parseInt(result[3], 16)
+      }
+    : null
+}
+
+/**
+ * RGB 转十六进制颜色
+ * @param r 红色值 0-255
+ * @param g 绿色值 0-255
+ * @param b 蓝色值 0-255
+ * @returns 十六进制颜色值
+ */
+export function rgbToHex(r: number, g: number, b: number): string {
+  return '#' + ((1 << 24) + (r << 16) + (g << 8) + b).toString(16).slice(1)
+}
+
+/**
+ * 颜色加深
+ * @param color 颜色值
+ * @param amount 加深程度 0-1
+ * @returns 加深后的颜色
+ */
+export function darken(color: string, amount: number): string {
+  const rgb = hexToRgb(color)
+  if (!rgb) return color
+
+  const r = Math.max(0, Math.floor(rgb.r * (1 - amount)))
+  const g = Math.max(0, Math.floor(rgb.g * (1 - amount)))
+  const b = Math.max(0, Math.floor(rgb.b * (1 - amount)))
+
+  return rgbToHex(r, g, b)
+}
+
+/**
+ * 颜色变浅
+ * @param color 颜色值
+ * @param amount 变浅程度 0-1
+ * @returns 变浅后的颜色
+ */
+export function lighten(color: string, amount: number): string {
+  const rgb = hexToRgb(color)
+  if (!rgb) return color
+
+  const r = Math.min(255, Math.floor(rgb.r + (255 - rgb.r) * amount))
+  const g = Math.min(255, Math.floor(rgb.g + (255 - rgb.g) * amount))
+  const b = Math.min(255, Math.floor(rgb.b + (255 - rgb.b) * amount))
+
+  return rgbToHex(r, g, b)
+}
+
+/**
+ * 添加透明度
+ * @param color 颜色值
+ * @param opacity 透明度 0-1
+ * @returns rgba 颜色值
+ */
+export function addOpacity(color: string, opacity: number): string {
+  const rgb = hexToRgb(color)
+  if (!rgb) return color
+
+  return `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, ${opacity})`
+}
+
+/**
+ * 判断颜色是否为浅色
+ * @param color 颜色值
+ * @returns 是否为浅色
+ */
+export function isLightColor(color: string): boolean {
+  const rgb = hexToRgb(color)
+  if (!rgb) return false
+
+  // 使用 YIQ 公式计算亮度
+  const yiq = (rgb.r * 299 + rgb.g * 587 + rgb.b * 114) / 1000
+  return yiq >= 128
+}

package/utils/common.uts

@@ -0,0 +1,245 @@
+/**
+ * 通用工具函数
+ * @description 提供常用的工具函数
+ */
+
+/**
+ * 防抖函数
+ * @param func 要执行的函数
+ * @param wait 等待时间（毫秒）
+ * @returns 防抖后的函数
+ */
+export function debounce<T extends (...args: any[]) => any>(
+  func: T,
+  wait: number
+): (...args: Parameters<T>) => void {
+  let timeout: number | null = null
+
+  return function (this: any, ...args: Parameters<T>) {
+    const context = this
+
+    if (timeout !== null) {
+      clearTimeout(timeout)
+    }
+
+    timeout = setTimeout(() => {
+      func.apply(context, args)
+    }, wait)
+  }
+}
+
+/**
+ * 节流函数
+ * @param func 要执行的函数
+ * @param wait 等待时间（毫秒）
+ * @returns 节流后的函数
+ */
+export function throttle<T extends (...args: any[]) => any>(
+  func: T,
+  wait: number
+): (...args: Parameters<T>) => void {
+  let timeout: number | null = null
+  let previous = 0
+
+  return function (this: any, ...args: Parameters<T>) {
+    const context = this
+    const now = Date.now()
+
+    if (now - previous > wait) {
+      if (timeout !== null) {
+        clearTimeout(timeout)
+        timeout = null
+      }
+      func.apply(context, args)
+      previous = now
+    } else if (!timeout) {
+      timeout = setTimeout(() => {
+        func.apply(context, args)
+        previous = Date.now()
+        timeout = null
+      }, wait)
+    }
+  }
+}
+
+/**
+ * 深拷贝
+ * @param obj 要拷贝的对象
+ * @returns 拷贝后的对象
+ */
+export function deepClone<T>(obj: T): T {
+  if (obj === null || typeof obj !== 'object') {
+    return obj
+  }
+
+  if (obj instanceof Date) {
+    return new Date(obj.getTime()) as any
+  }
+
+  if (obj instanceof Array) {
+    const cloneArr: any[] = []
+    obj.forEach((item) => {
+      cloneArr.push(deepClone(item))
+    })
+    return cloneArr as any
+  }
+
+  if (obj instanceof Object) {
+    const cloneObj: any = {}
+    for (const key in obj) {
+      if (obj.hasOwnProperty(key)) {
+        cloneObj[key] = deepClone(obj[key])
+      }
+    }
+    return cloneObj
+  }
+
+  return obj
+}
+
+/**
+ * 生成唯一 ID
+ * @param prefix 前缀
+ * @returns 唯一 ID
+ */
+export function generateId(prefix: string = 'id'): string {
+  return `${prefix}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`
+}
+
+/**
+ * 格式化文件大小
+ * @param bytes 字节数
+ * @param decimals 小数位数
+ * @returns 格式化后的文件大小
+ */
+export function formatFileSize(bytes: number, decimals: number = 2): string {
+  if (bytes === 0) return '0 Bytes'
+
+  const k = 1024
+  const dm = decimals < 0 ? 0 : decimals
+  const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB']
+
+  const i = Math.floor(Math.log(bytes) / Math.log(k))
+
+  return parseFloat((bytes / Math.pow(k, i)).toFixed(dm)) + ' ' + sizes[i]
+}
+
+/**
+ * 格式化日期
+ * @param date 日期对象或时间戳
+ * @param format 格式化模板，如 'YYYY-MM-DD HH:mm:ss'
+ * @returns 格式化后的日期字符串
+ */
+export function formatDate(date: Date | number, format: string = 'YYYY-MM-DD HH:mm:ss'): string {
+  const d = typeof date === 'number' ? new Date(date) : date
+
+  const year = d.getFullYear()
+  const month = d.getMonth() + 1
+  const day = d.getDate()
+  const hour = d.getHours()
+  const minute = d.getMinutes()
+  const second = d.getSeconds()
+
+  const pad = (n: number): string => (n < 10 ? '0' + n : String(n))
+
+  return format
+    .replace('YYYY', String(year))
+    .replace('MM', pad(month))
+    .replace('DD', pad(day))
+    .replace('HH', pad(hour))
+    .replace('mm', pad(minute))
+    .replace('ss', pad(second))
+}
+
+/**
+ * 获取 URL 参数
+ * @param url URL 地址
+ * @returns 参数对象
+ */
+export function getUrlParams(url: string): Record<string, string> {
+  const params: Record<string, string> = {}
+  const queryString = url.split('?')[1]
+
+  if (!queryString) return params
+
+  const pairs = queryString.split('&')
+  pairs.forEach((pair) => {
+    const [key, value] = pair.split('=')
+    params[decodeURIComponent(key)] = decodeURIComponent(value || '')
+  })
+
+  return params
+}
+
+/**
+ * 对象转 URL 参数
+ * @param obj 参数对象
+ * @returns URL 参数字符串
+ */
+export function objectToUrlParams(obj: Record<string, any>): string {
+  const params: string[] = []
+
+  for (const key in obj) {
+    if (obj.hasOwnProperty(key) && obj[key] !== undefined && obj[key] !== null) {
+      params.push(`${encodeURIComponent(key)}=${encodeURIComponent(obj[key])}`)
+    }
+  }
+
+  return params.join('&')
+}
+
+/**
+ * 数组去重
+ * @param arr 数组
+ * @returns 去重后的数组
+ */
+export function unique<T>(arr: T[]): T[] {
+  return Array.from(new Set(arr))
+}
+
+/**
+ * 数组分组
+ * @param arr 数组
+ * @param size 每组大小
+ * @returns 分组后的二维数组
+ */
+export function chunk<T>(arr: T[], size: number): T[][] {
+  const result: T[][] = []
+  for (let i = 0; i < arr.length; i += size) {
+    result.push(arr.slice(i, i + size))
+  }
+  return result
+}
+
+/**
+ * 延迟执行
+ * @param ms 延迟时间（毫秒）
+ * @returns Promise
+ */
+export function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms))
+}
+
+/**
+ * 随机数
+ * @param min 最小值
+ * @param max 最大值
+ * @returns 随机数
+ */
+export function random(min: number, max: number): number {
+  return Math.floor(Math.random() * (max - min + 1)) + min
+}
+
+/**
+ * 随机字符串
+ * @param length 长度
+ * @returns 随机字符串
+ */
+export function randomString(length: number): string {
+  const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789'
+  let result = ''
+  for (let i = 0; i < length; i++) {
+    result += chars.charAt(Math.floor(Math.random() * chars.length))
+  }
+  return result
+}

package/utils/dom.uts

@@ -0,0 +1,275 @@
+/**
+ * DOM 操作工具函数
+ * @module utils/dom
+ */
+
+/**
+ * 获取元素的边界信息
+ * @param {string} selector - 选择器
+ * @param {any} instance - 组件实例
+ * @returns {Promise<any>} 元素边界信息
+ */
+export function getRect(selector: string, instance: any): Promise<any> {
+  return new Promise((resolve) => {
+    uni.createSelectorQuery()
+      .in(instance)
+      .select(selector)
+      .boundingClientRect((rect: any) => {
+        resolve(rect)
+      })
+      .exec()
+  })
+}
+
+/**
+ * 获取所有匹配元素的边界信息
+ * @param {string} selector - 选择器
+ * @param {any} instance - 组件实例
+ * @returns {Promise<any[]>} 元素边界信息数组
+ */
+export function getRectAll(selector: string, instance: any): Promise<any[]> {
+  return new Promise((resolve) => {
+    uni.createSelectorQuery()
+      .in(instance)
+      .selectAll(selector)
+      .boundingClientRect((rects: any[]) => {
+        resolve(rects)
+      })
+      .exec()
+  })
+}
+
+/**
+ * 获取滚动位置
+ * @param {string} selector - 选择器
+ * @param {any} instance - 组件实例
+ * @returns {Promise<any>} 滚动位置信息
+ */
+export function getScrollOffset(selector: string, instance: any): Promise<any> {
+  return new Promise((resolve) => {
+    uni.createSelectorQuery()
+      .in(instance)
+      .select(selector)
+      .scrollOffset((res: any) => {
+        resolve(res)
+      })
+      .exec()
+  })
+}
+
+/**
+ * 获取系统信息
+ * @returns {any} 系统信息对象
+ */
+export function getSystemInfo(): any {
+  try {
+    return uni.getSystemInfoSync()
+  } catch (e) {
+    console.error('获取系统信息失败:', e)
+    return {
+      windowWidth: 375,
+      windowHeight: 667,
+      pixelRatio: 2,
+      platform: 'unknown'
+    }
+  }
+}
+
+/**
+ * px 转 rpx
+ * @param {number} px - 像素值
+ * @returns {number} rpx值
+ */
+export function pxToRpx(px: number): number {
+  const systemInfo = getSystemInfo()
+  return px * 750 / systemInfo.windowWidth
+}
+
+/**
+ * rpx 转 px
+ * @param {number} rpx - rpx值
+ * @returns {number} 像素值
+ */
+export function rpxToPx(rpx: number): number {
+  const systemInfo = getSystemInfo()
+  return rpx * systemInfo.windowWidth / 750
+}
+
+/**
+ * 添加单位
+ * @param {string | number} value - 值
+ * @param {string} unit - 单位，默认 'rpx'
+ * @returns {string} 带单位的值
+ */
+export function addUnit(value: string | number, unit: string = 'rpx'): string {
+  if (!value) return '0'
+
+  // 如果已经有单位，直接返回
+  if (typeof value === 'string') {
+    const hasUnit = /(rpx|px|%|vh|vw|rem|em)$/.test(value)
+    if (hasUnit) return value
+  }
+
+  return `${value}${unit}`
+}
+
+/**
+ * 获取元素样式
+ * @param {any} element - 元素
+ * @param {string} property - 样式属性
+ * @returns {string} 样式值
+ */
+export function getStyle(element: any, property: string): string {
+  if (!element) return ''
+
+  try {
+    return element.style[property] || ''
+  } catch (e) {
+    console.error('获取样式失败:', e)
+    return ''
+  }
+}
+
+/**
+ * 设置元素样式
+ * @param {any} element - 元素
+ * @param {string} property - 样式属性
+ * @param {string} value - 样式值
+ */
+export function setStyle(element: any, property: string, value: string): void {
+  if (!element) return
+
+  try {
+    element.style[property] = value
+  } catch (e) {
+    console.error('设置样式失败:', e)
+  }
+}
+
+/**
+ * 批量设置样式
+ * @param {any} element - 元素
+ * @param {Record<string, string>} styles - 样式对象
+ */
+export function setStyles(element: any, styles: Record<string, string>): void {
+  if (!element || !styles) return
+
+  Object.keys(styles).forEach(key => {
+    setStyle(element, key, styles[key])
+  })
+}
+
+/**
+ * 判断是否支持某个 CSS 属性
+ * @param {string} property - CSS 属性
+ * @returns {boolean} 是否支持
+ */
+export function supportsCss(property: string): boolean {
+  // #ifdef H5
+  if (typeof document !== 'undefined' && document.documentElement) {
+    const style = document.documentElement.style
+    return property in style
+  }
+  // #endif
+
+  // 非 H5 平台默认返回 true
+  return true
+}
+
+/**
+ * 获取元素的计算样式
+ * @param {any} element - 元素
+ * @returns {any} 计算样式对象
+ */
+export function getComputedStyle(element: any): any {
+  // #ifdef H5
+  if (typeof window !== 'undefined' && window.getComputedStyle) {
+    return window.getComputedStyle(element)
+  }
+  // #endif
+
+  return element.style || {}
+}
+
+/**
+ * 判断元素是否在视口内
+ * @param {any} rect - 元素边界信息
+ * @param {number} offset - 偏移量
+ * @returns {boolean} 是否在视口内
+ */
+export function isInViewport(rect: any, offset: number = 0): boolean {
+  if (!rect) return false
+
+  const systemInfo = getSystemInfo()
+  const { windowHeight } = systemInfo
+
+  return rect.top < windowHeight + offset && rect.bottom > -offset
+}
+
+/**
+ * 获取节点信息
+ * @param {string} selector - 选择器
+ * @param {any} instance - 组件实例
+ * @returns {Promise<any>} 节点信息
+ */
+export function getNodeInfo(selector: string, instance: any): Promise<any> {
+  return new Promise((resolve) => {
+    uni.createSelectorQuery()
+      .in(instance)
+      .select(selector)
+      .fields({
+        id: true,
+        dataset: true,
+        rect: true,
+        size: true,
+        scrollOffset: true,
+        properties: ['scrollX', 'scrollY']
+      }, (res: any) => {
+        resolve(res)
+      })
+      .exec()
+  })
+}
+
+/**
+ * 平滑滚动到指定位置
+ * @param {number} scrollTop - 滚动位置
+ * @param {number} duration - 动画时长
+ * @param {string} selector - 选择器
+ */
+export function smoothScrollTo(scrollTop: number, duration: number = 300, selector: string = ''): void {
+  if (selector) {
+    uni.pageScrollTo({
+      selector,
+      duration
+    })
+  } else {
+    uni.pageScrollTo({
+      scrollTop,
+      duration
+    })
+  }
+}
+
+/**
+ * 获取安全区域信息
+ * @returns {any} 安全区域信息
+ */
+export function getSafeArea(): any {
+  const systemInfo = getSystemInfo()
+  const { safeArea, screenHeight, statusBarHeight = 0 } = systemInfo
+
+  if (safeArea) {
+    return safeArea
+  }
+
+  // 如果没有 safeArea，计算一个默认值
+  return {
+    top: statusBarHeight,
+    bottom: screenHeight,
+    left: 0,
+    right: systemInfo.windowWidth,
+    width: systemInfo.windowWidth,
+    height: screenHeight - statusBarHeight
+  }
+}

package/utils/index.uts

@@ -0,0 +1,10 @@
+/**
+ * 工具函数入口文件
+ * @module utils
+ * @description 导出所有工具函数
+ */
+
+export * from './color.uts'
+export * from './validator.uts'
+export * from './common.uts'
+export * from './dom.uts'