快速开始
介绍
比起现成的功能丰富的 HSV 风格的 <ColorPicker/>
组件。
color-picker-kit
只实现 HSV 风格拖拽调色部分组件,其余功能交给使用者自行组装。
打个不恰当的比方:
- 如果说
<ColorPicker/>
组件 提供的是<ProLayout/>
- color-picker-kit 提供的就是
<Layout/>
/<Layout.Header/>
/<Layout.Content/>
/<Layout.Footer/>
color-picker-kit 与 X 不同的是
当下,越来越多的组件库,都内置了 HSV 风格的 <ColorPicker/>
颜色选择器组件, 可以使我们可以更方便的交付一个用户可以自定义主题色的项目
例如:Arco Design Ant Design TDesign
X
- Ant Design 并没有针对 vue 的实现版
- Arco Design 的颜色选择器缺乏后续维护
- TDesign 兼容性要求
Chrome >= 84
,无法满足部分业务场景 - 在使用不包含
<color-picker/>
组件库的情况下,引入内置了<color-picker/>
颜色选择器的组件库,存在一定的样式混搭处理问题,部分打包体积问题
color-picker-kit
- 仅实现 HSV 风格的拖拽调色部分组件,不提供完整功能的组件,只用于可以快速组成一个您自己的
<color-picker/>
颜色选择器组件 - 组件和样式默认分离封装,样式可以按照您的需要引入和覆盖
- 组件包默认摇树无副作用,您也可以参考默认的样式,自行从零实现样式,自行决定样式兼容的浏览器目标
安装
sh
npm i @vrx/color-picker-kit
sh
yarn add @vrx/color-picker-kit
sh
pnpm add @vrx/color-picker-kit
sh
bun add @vrx/color-picker-kit
使用默认样式
sh
npm i @vrx/color-picker-kit-style
sh
yarn add @vrx/color-picker-kit-style
sh
pnpm add @vrx/color-picker-kit-style
sh
bun add @vrx/color-picker-kit-style
简易实现
提示
封装时使用双向绑定的提示
不建议您封装的时候将
HSVA
格式化为另一种格式值(例如:hex,rgba)
的时候,完全依赖于双向绑定赋值。遇到
#000
,这种特殊颜色时,tinyColor 解析为hsv
时会丢失部分信息,可能会导致拖拽色盘时出现闪烁的问题。如执意想要实现一个完全双向绑定监听的颜色选择器的话,需自行解决例如
hex 转 hsv
带来的信息丢失问题