Appearance
工具函数
沈孟平
最后更新于 2026-04-23 19:53:53
简介
@gupo-admin/components/utils 提供了一些常用的工具函数,主要服务于组件库本身,也可以在业务项目中按需复用。
当前导出
| 模块 | 代表能力 | 说明 |
|---|---|---|
| color | opacityColor、rgbaToHex、getLightColor | 颜色透明度、混色、亮暗色转换 |
| helper | transformAttrs2kebabCase、camel2kebab、downloadBlob | 属性处理、浏览器判断、下载辅助 |
| define-dict | defineDict | 定义带类型推断的数据字典 |
| bem | createBEM | 组件库内部大量使用的 BEM class 生成工具,也对外导出 |
使用边界
- 这些工具更偏“组件库配套能力”,不是一个追求绝对通用的基础函数库。
- 某些函数和当前项目的命名、浏览器环境或组件实现方式有关,复用时建议先看源码和示例。
核对结果
当前 @gupo-admin/components/utils 的公开导出共有 4 组,分别是:
colorhelperdefine-dictbem
本文档和侧边栏已经按源码导出补齐。
安装
bash
ni @gupo-admin/components使用示例
vue
<script setup>
import { opacityColor } from '@gupo-admin/components/utils'
const color = opacityColor('#000', 0.5)
</script>