项目正在快速迭代中,API 与视觉细节可能随版本调整,请勿用于生产环境。

工具类总览 ​

除组件外,@wil-works/evoke-business-ui 还导出一组与组件零耦合的工具函数与组合式函数(Composables),可在任何 B 端项目中独立使用:

js
import { formatNumber, setPrimaryColor, useClipboard } from '@wil-works/evoke-business-ui'

格式化工具 ​

函数用途
formatNumber千分位 + 精度
formatFileSize字节数 → KB/MB/GB
formatDate日期模板格式化(YYYY-MM-DD HH:mm:ss)
formatRelativeTime相对时间(3 分钟前 / 昨天 14:30)
formatDuration秒数 → mm:ss / HH:mm:ss
formatPercent小数 → 百分数

详见 格式化工具。

主题与颜色 ​

函数用途
normalizeHex / hexToRgb / rgbToHex / mixHex颜色解析与混合
generatePrimaryRamp由主色生成 7 档色阶
setPrimaryColor运行时切换全库主色(色阶 + 图表色板自动重算)
setDensity / getDensity全局密度切换与读取
avatarColor由字符串稳定映射头像底色

详见 主题与颜色。

组合式函数(Composables) ​

函数用途
useDarkMode暗色模式开关({ isDark, toggleDark, setDark })
useClipboard剪贴板复制({ copied, copy })
useFullscreen全屏控制({ isFullscreen, enter, exit, toggle })
usePermission权限判定({ permissions, has, hasAny, hasAll })
useTable表格状态管理(分页/排序/筛选/加载)
useConfigProvider / useFormItem全局配置与表单契约(组件内部使用)
useFloating / useClickOutside / useFocusTrap / useLockScroll / useTeleport浮层基元
useZIndex弹层 z-index 递增管理
useLocale / usePlatform语言包与平台形态

详见 组合式函数。

基础 DOM 与事件 ​

函数用途
on事件绑定(自动清理友好)
stopEvent / isEnter / isEsc事件工具
inBrowser / resolveTarget / contains / getOffsetDOM 工具
storageGet / storageSetlocalStorage 安全读写(SSR/隐私模式不抛错)