通用工具函数
日期格式化
import { formatDateTime, formatDate } from '@/utils/common'
// 日期时间
formatDateTime(new Date()) // '2024-01-15 10:30:00'
formatDateTime(Date.now(), 'YYYY-MM-DD HH:mm')
// 日期
formatDate(new Date()) // '2024-01-15'
formatDate(new Date(), 'YYYY/MM/DD')
防抖与节流
import { debounce, throttle } from '@/utils/common'
// 防抖：延迟执行，重复调用会重置计时
const handleSearch = debounce((keyword) => {
console.log('搜索:', keyword)
}, 300)
// 立即执行模式
const handleSave = debounce(() => {
saveData()
}, 300, true)
// 节流：固定间隔执行
const handleScroll = throttle(() => {
console.log('滚动中...')
}, 200)
UUID 生成
import { generateUUID } from '@/utils/common'
const id = generateUUID() // 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'
JSON 解析判断
import { canParseToJson } from '@/utils/common'
canParseToJson('{"name":"test"}') // true
canParseToJson('invalid json') // false
睡眠函数
import { sleep } from '@/utils/common'
async function loadData() {
loading.value = true
await sleep(1000) // 等待 1 秒
loading.value = false
}
尺寸监听
import { useResize } from '@/utils/common'
const observer = useResize(element, (rect) => {
console.log('尺寸变化:', rect.width, rect.height)
})
// 销毁监听
observer.disconnect()
API 参考
| 函数 |
参数 |
返回值 |
说明 |
| formatDateTime |
time?, format? |
string |
格式化日期时间 |
| formatDate |
date?, format? |
string |
格式化日期 |
| debounce |
fn, wait, immediate? |
Function |
防抖函数 |
| throttle |
fn, wait |
Function |
节流函数 |
| generateUUID |
- |
string |
生成 UUID |
| canParseToJson |
str |
boolean |
判断是否可解析为 JSON |
| sleep |
time |
Promise |
睡眠函数 |
| useResize |
el, cb |
ResizeObserver |
尺寸监听 |
