tang-ui-x 1.3.4 → 1.3.5

package/components/TIcon/index.uvue

@@ -30,8 +30,8 @@
 	})
 
 	// 计算图标样式
-	const iconStyle = computed(() : string => {
-		const styles : string[] = []
+	const iconStyle = computed(() : string => {
+		const styles : string[] = []
 
 		styles.push(`font-size: ${iconSize.value}`)
 		styles.push(`color: ${props.color}`)
@@ -40,9 +40,9 @@
 			styles.push('font-weight: bold')
 		}
 
-		if (props.customStyle !== '') {
-			styles.push(props.customStyle)
-		}
+		if (props.customStyle !== '') {
+			styles.push(props.customStyle)
+		}
 
 		return styles.join('; ')
 	})
@@ -51,18 +51,18 @@
 	const iconClass = computed(() : string => {
 		const classes : string[] = ['inline-block', 'leading-none', 'iconfont']
 
-		if (props.name.length > 0) {
-			// 支持传入 icon-xxx 或直接传入 xxx
-			if (props.name.indexOf('icon-') == 0) {
-				classes.push(props.name)
-			} else {
-				classes.push(`icon-${props.name}`)
+		if (props.name.length > 0) {
+			// 支持传入 icon-xxx 或直接传入 xxx
+			if (props.name.indexOf('icon-') == 0) {
+				classes.push(props.name)
+			} else {
+				classes.push(`icon-${props.name}`)
 			}
 		}
 
-		if (props.customClass !== '') {
-			classes.push(props.customClass)
-		}
+		if (props.customClass !== '') {
+			classes.push(props.customClass)
+		}
 
 		return classes.join(' ')
 	})
@@ -84,10 +84,10 @@
 
 <style lang="scss" scoped>
 	/* 导入字体图标 */
-	@import '@/static/font/iconfont.css';
+	@import '../../static/font/iconfont.css';
 
 	.t-icon {
 		display: inline-block;
 		line-height: 1;
 	}
-</style>
+</style>

package/locales/en-US/examples.json

@@ -214,10 +214,20 @@
       "enName": "NavBar",
       "description": "Top navigation bar"
     },
-    "I18nDemo": {
-      "name": "I18n Demo",
-      "enName": "I18n",
-      "description": "Internationalization demo"
-    }
-  }
-}
+    "I18nDemo": {
+      "name": "I18n Demo",
+      "enName": "I18n",
+      "description": "Internationalization demo"
+    },
+    "Request": {
+      "name": "Request",
+      "enName": "Request",
+      "description": "HttpRequest wrapper, interceptor, and response handling demo"
+    },
+    "Utils": {
+      "name": "Utils",
+      "enName": "Utils",
+      "description": "Common utility functions and storage wrapper demo"
+    }
+  }
+}

package/locales/zh-CN/examples.json

@@ -214,10 +214,20 @@
       "enName": "NavBar",
       "description": "顶部导航栏"
     },
-    "I18nDemo": {
-      "name": "多语言测试",
-      "enName": "I18n",
-      "description": "国际化多语言功能演示"
-    }
-  }
-}
+    "I18nDemo": {
+      "name": "多语言测试",
+      "enName": "I18n",
+      "description": "国际化多语言功能演示"
+    },
+    "Request": {
+      "name": "请求封装",
+      "enName": "Request",
+      "description": "HttpRequest 请求封装、拦截器与响应处理示例"
+    },
+    "Utils": {
+      "name": "工具方法",
+      "enName": "Utils",
+      "description": "常用工具函数与 storage 封装示例"
+    }
+  }
+}

package/locales/zh-TW/examples.json

@@ -214,10 +214,20 @@
       "enName": "NavBar",
       "description": "頂部導航欄"
     },
-    "I18nDemo": {
-      "name": "多語言測試",
-      "enName": "I18n",
-      "description": "國際化多語言功能演示"
-    }
-  }
-}
+    "I18nDemo": {
+      "name": "多語言測試",
+      "enName": "I18n",
+      "description": "國際化多語言功能演示"
+    },
+    "Request": {
+      "name": "請求封裝",
+      "enName": "Request",
+      "description": "HttpRequest 請求封裝、攔截器與響應處理示例"
+    },
+    "Utils": {
+      "name": "工具方法",
+      "enName": "Utils",
+      "description": "常用工具函數與 storage 封裝示例"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tang-ui-x",
-  "version": "1.3.4",
+  "version": "1.3.5",
   "description": "UniApp X UI 组件库 - 基于 uni-app x 的移动端 UI 组件库",
   "main": "index.uts",
   "module": "index.uts",

package/utils/functions/index.uts

@@ -0,0 +1 @@
+export * from './modules/index'

package/utils/functions/modules/clipboard.uts

@@ -0,0 +1,113 @@
+/**
+ * 复制文本到剪贴板（跨平台支持）
+ * @param text 要复制的文本
+ * @param success 成功回调
+ * @param fail 失败回调
+ */
+export function copyToClipboard(text: string, success?: () => void, fail?: (error?: any) => void) {
+  if (text == '') {
+    fail && fail('文本不能为空')
+    return
+  }
+
+  /* eslint-disable no-unreachable */
+  // #ifdef H5
+  try {
+    const textarea = document.createElement('textarea')
+    textarea.value = text
+    textarea.style.position = 'fixed'
+    textarea.style.top = '-9999px'
+    textarea.style.left = '-9999px'
+    document.body.appendChild(textarea)
+    textarea.select()
+    textarea.setSelectionRange(0, text.length)
+
+    const successful = document.execCommand('copy')
+    document.body.removeChild(textarea)
+
+    if (successful) {
+      uni.showToast({
+        title: '复制成功',
+        icon: 'success',
+        duration: 2000,
+      })
+      success && success()
+    } else {
+      throw new Error('复制失败')
+    }
+    return
+  } catch (error) {
+    console.error('H5 复制失败:', error)
+    uni.showToast({
+      title: '复制失败',
+      icon: 'error',
+      duration: 2000,
+    })
+    fail && fail(error)
+    return
+  }
+  // #endif
+
+  // #ifdef APP-ANDROID || APP-IOS || APP-HARMONY
+  uni.setClipboardData({
+    data: text,
+    success: () => {
+      uni.showToast({
+        title: '复制成功',
+        icon: 'success',
+        duration: 2000,
+      })
+      success && success()
+    },
+    fail: (error) => {
+      console.error('App 复制失败:', error)
+      uni.showToast({
+        title: '复制失败',
+        icon: 'error',
+        duration: 2000,
+      })
+      fail && fail(error)
+    },
+  })
+  return
+  // #endif
+
+  // #ifdef MP-WEIXIN || MP-ALIPAY || MP-BAIDU || MP-QQ || MP-TOUTIAO || MP-KUAISHOU
+  uni.setClipboardData({
+    data: text,
+    success: () => {
+      uni.showToast({
+        title: '复制成功',
+        icon: 'success',
+        duration: 2000,
+      })
+      success && success()
+    },
+    fail: (error) => {
+      console.error('小程序复制失败:', error)
+      uni.showToast({
+        title: '复制失败',
+        icon: 'error',
+        duration: 2000,
+      })
+      fail && fail(error)
+    },
+  })
+  // #endif
+  /* eslint-enable no-unreachable */
+}
+
+/**
+ * 复制文本到剪贴板（Promise 版本，跨平台支持）
+ * @param text 要复制的文本
+ * @returns Promise<void>
+ */
+export function copyToClipboardAsync(text: string): Promise<void> {
+  return new Promise((resolve, reject) => {
+    copyToClipboard(
+      text,
+      () => resolve(),
+      (error) => reject(error)
+    )
+  })
+}

package/utils/functions/modules/date.uts

@@ -0,0 +1,13 @@
+/**
+ * 格式化时间为上午/下午格式
+ * @param date 日期对象
+ * @returns 格式化后的时间字符串，如 "上午 8:10"
+ */
+export function formatChatTime(date: Date): string {
+  const hours = date.getHours()
+  const minutes = date.getMinutes()
+  const period = hours < 12 ? '上午' : '下午'
+  const h = hours % 12 === 0 ? 12 : hours % 12
+  const m = minutes < 10 ? '0' + minutes : minutes.toString()
+  return `${period} ${h}:${m}`
+}

package/utils/functions/modules/function.uts

@@ -0,0 +1,42 @@
+/**
+ * 防抖函数
+ * @param func 要执行的函数
+ * @param delay 延迟时间（ms）
+ * @returns 防抖后的函数
+ */
+export function debounce(
+  func: (...args: Array<any>) => void,
+  delay: number
+): (...args: Array<any>) => void {
+  let timer: number | null = null
+
+  return function (...args: Array<any>): void {
+    if (timer != null) {
+      clearTimeout(timer)
+    }
+    timer = setTimeout(() => {
+      func(...args)
+    }, delay)
+  }
+}
+
+/**
+ * 节流函数
+ * @param func 要执行的函数
+ * @param delay 延迟时间（ms）
+ * @returns 节流后的函数
+ */
+export function throttle(
+  func: (...args: Array<any>) => void,
+  delay: number
+): (...args: Array<any>) => void {
+  let last: number = 0
+
+  return function (...args: Array<any>): void {
+    const now = Date.now()
+    if (now - last >= delay) {
+      last = now
+      func(...args)
+    }
+  }
+}

package/utils/functions/modules/index.uts

@@ -0,0 +1,10 @@
+export * from './clipboard'
+export * from './date'
+export * from './function'
+export * from './number'
+export * from './object'
+export * from './storage'
+export * from './string'
+export * from './type'
+export * from './validate'
+export * from './upload'

package/utils/functions/modules/number.uts

@@ -0,0 +1,44 @@
+/**
+ * 格式化数字（添加千分位分隔符）
+ * @param num 数字
+ * @returns 格式化后的字符串
+ */
+export function formatNumber(num: number | string): string {
+  const text = `${num}`
+  const n = parseFloat(text)
+  if (isNaN(n)) return text
+
+  const parts = text.split('.')
+  const integerPart = parts[0]
+  const decimalPart = parts.length > 1 ? '.' + parts[1] : ''
+  const negative = integerPart.length > 0 && integerPart.charAt(0) == '-'
+  const digits = negative ? integerPart.substring(1) : integerPart
+  let formatted = ''
+  let count = 0
+
+  for (let i = digits.length - 1; i >= 0; i--) {
+    formatted = digits.charAt(i) + formatted
+    count++
+    if (i > 0 && count % 3 == 0) {
+      formatted = ',' + formatted
+    }
+  }
+
+  return (negative ? '-' : '') + formatted + decimalPart
+}
+
+/**
+ * 将字节转换为可读大小
+ * @param bytes 字节数
+ * @param decimals 小数位数
+ * @returns 可读大小字符串
+ */
+export function formatBytes(bytes: number, decimals: number = 2): string {
+  if (bytes === 0) return '0 B'
+
+  const k: number = 1024
+  const sizes: Array<string> = ['B', 'KB', 'MB', 'GB', 'TB']
+  const i = Math.floor(Math.log(bytes) / Math.log(k))
+
+  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(decimals))} ${sizes[i]}`
+}

package/utils/functions/modules/object.uts

@@ -0,0 +1,74 @@
+/**
+ * 安全获取对象属性
+ * @param obj 对象
+ * @param path 属性路径，如 'a.b.c'
+ * @param defaultValue 默认值
+ * @returns 属性值
+ */
+export function get(obj: any, path: string, defaultValue: any | null = null): any | null {
+  const keys: Array<string> = path.split('.')
+  let result: any = obj
+
+  for (const key of keys) {
+    if (result == null || typeof result !== 'object') {
+      return defaultValue
+    }
+    result = result[key]
+  }
+
+  return result == null ? defaultValue : result
+}
+
+/**
+ * 深拷贝对象
+ * @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) {
+    return obj.map((item) => deepClone(item)) as any
+  }
+
+  const source = obj as UTSJSONObject
+  const cloned = {} as UTSJSONObject
+  for (const key in source) {
+    cloned[key] = deepClone(source[key])
+  }
+  return cloned as T
+}
+
+/**
+ * 将对象转换为 Query 字符串
+ * @param obj 要转换的对象
+ * @param prefix 前缀
+ * @returns Query 字符串
+ */
+export function toQueryString(obj: UTSJSONObject, prefix: string = ''): string {
+  const parts: Array<string> = []
+
+  for (const key in obj) {
+    const value = obj[key]
+    const fullKey = prefix != '' ? `${prefix}[${key}]` : key
+
+    if (value == null) {
+      parts.push(`${encodeURIComponent(fullKey)}=`)
+      continue
+    }
+
+    if (typeof value === 'object' && !Array.isArray(value)) {
+      parts.push(toQueryString(value as UTSJSONObject, fullKey))
+    } else {
+      parts.push(`${encodeURIComponent(fullKey)}=${encodeURIComponent(`${value}`)}`)
+    }
+  }
+
+  return parts.join('&')
+}

package/utils/functions/modules/storage.uts

@@ -0,0 +1,91 @@
+/**
+ * 设置本地缓存
+ * @param key 缓存键
+ * @param value 缓存值
+ * @returns 是否设置成功
+ */
+export function setStorage(key: string, value: any): boolean {
+  if (key == '') {
+    return false
+  }
+
+  try {
+    uni.setStorageSync(key, value)
+    return true
+  } catch (error) {
+    console.error('setStorage failed:', error)
+    return false
+  }
+}
+
+/**
+ * 获取本地缓存
+ * @param key 缓存键
+ * @param defaultValue 默认值
+ * @returns 缓存值或默认值
+ */
+export function getStorage(key: string, defaultValue: any | null = null): any | null {
+  if (key == '') {
+    return defaultValue
+  }
+
+  try {
+    const value = uni.getStorageSync(key)
+    return value == '' ? defaultValue : value
+  } catch (error) {
+    console.error('getStorage failed:', error)
+    return defaultValue
+  }
+}
+
+/**
+ * 判断本地缓存是否存在
+ * @param key 缓存键
+ * @returns 是否存在
+ */
+export function hasStorage(key: string): boolean {
+  if (key == '') {
+    return false
+  }
+
+  try {
+    const value = uni.getStorageSync(key)
+    return value != ''
+  } catch (error) {
+    console.error('hasStorage failed:', error)
+    return false
+  }
+}
+
+/**
+ * 移除本地缓存
+ * @param key 缓存键
+ * @returns 是否移除成功
+ */
+export function removeStorage(key: string): boolean {
+  if (key == '') {
+    return false
+  }
+
+  try {
+    uni.removeStorageSync(key)
+    return true
+  } catch (error) {
+    console.error('removeStorage failed:', error)
+    return false
+  }
+}
+
+/**
+ * 清空全部本地缓存
+ * @returns 是否清空成功
+ */
+export function clearStorage(): boolean {
+  try {
+    uni.clearStorageSync()
+    return true
+  } catch (error) {
+    console.error('clearStorage failed:', error)
+    return false
+  }
+}

package/utils/functions/modules/string.uts

@@ -0,0 +1,38 @@
+/**
+ * 截取字符串并添加省略号
+ * @param str 字符串
+ * @param length 最大长度
+ * @returns 截取后的字符串
+ */
+export function truncate(str: string, length: number): string {
+  if (str == '') return ''
+  if (str.length <= length) return str
+  return str.substring(0, length) + '...'
+}
+
+/**
+ * 生成随机字符串
+ * @param length 长度
+ * @returns 随机字符串
+ */
+export function randomString(length: number = 8): string {
+  const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789'
+  let result = ''
+  for (let i = 0; i < length; i++) {
+    result += chars.charAt(Math.floor(Math.random() * chars.length))
+  }
+  return result
+}
+
+/**
+ * 生成UUID
+ * @returns UUID字符串
+ */
+export function generateUUID(): string {
+  const uuid = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
+    const r = (Math.random() * 16) | 0
+    const v = c == 'x' ? r : (r & 0x3) | 0x8
+    return v.toString(16)
+  })
+  return uuid
+}

package/utils/functions/modules/type.uts

@@ -0,0 +1,47 @@
+/**
+ * 检查值是否为空
+ * @param value 要检查的值
+ * @returns 是否为空
+ */
+export function isEmpty(value: any): boolean {
+  if (value == null) return true
+  if (typeof value === 'string') return value.trim().length === 0
+  if (Array.isArray(value)) return value.length === 0
+  if (typeof value === 'object') {
+    const obj = value as UTSJSONObject
+    for (const key in obj) {
+      return false
+    }
+    return true
+  }
+  return false
+}
+
+/**
+ * 检查值是否有效（非空）
+ * @param value 要检查的值
+ * @returns 是否有效
+ */
+export function isValid(value: any): boolean {
+  return value != null
+}
+
+/**
+ * 验证手机号
+ * @param phone 手机号
+ * @returns 是否有效
+ */
+export function isValidPhone(phone: string): boolean {
+  const phoneRegex = /^1[3-9]\d{9}$/
+  return phoneRegex.test(phone)
+}
+
+/**
+ * 验证邮箱
+ * @param email 邮箱
+ * @returns 是否有效
+ */
+export function isValidEmail(email: string): boolean {
+  const emailRegex = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/
+  return emailRegex.test(email)
+}