ColorPicker 颜色选择器

用于颜色选择,支持基础色板、完整调色板、弹窗模式和多种色值格式。

参照 TDesign 的颜色选择器面板实现,支持基础色板、完整调色板和弹窗模式。

演示

9:41

代码示例

<!-- 基础颜色选择器 -->
  <re-color-picker class="demo-base" @change="onBaseChange" />

<!-- 带色板的颜色选择器 -->
  <re-color-picker class="demo-multiple" type="multiple" enable-alpha @change="onMultipleChange" />

<!-- 弹窗形式的颜色选择器 -->
  <re-color-picker class="demo-popup-picker" type="multiple" enable-alpha use-popup :visible="popupVisible" @update:visible="onPopupVisibleChange" @change="onPopupChange" />

<!-- 组件模式选择 -->
  <re-color-picker class="demo-format-picker" type="multiple" enable-alpha :format="currentFormat" @change="onFormatChange" />

引入

推荐使用 easycom 模式,配置后无需手动 import 即可直接使用 <re-color-picker />。

API

ColorPicker Props

名称类型默认值描述必传
autoClosebooleantrue自动关闭。在点击遮罩层时自动关闭,不需要手动设置 visibleN
enableAlphabooleanfalse是否开启透明通道N
fixedbooleanfalse如果 color-picker 位于固定定位或滚动容器中,可在外部滚动后重新触发尺寸测量N
formatstring"RGB"格式化色值。支持 HEX/HEX8/RGB/RGBA/HSL/HSLA/HSV/HSVA/CMYK/CSSN
popupPropsUTSJSONObject | nullnull透传弹窗属性,支持 showOverlay/zIndex/safeAreaInsetBottom/overlayProps/customStyleN
swatchColorsArray<string>内置系统色系统预设的颜色样例,传 则不显示系统色N
typestring"base"颜色选择器类型,base 表示仅展示系统预设内容;multiple 表示展示色板和系统预设内容N
usePopupbooleanfalse是否使用弹出层包裹颜色选择器N
valuestring""色值N
defaultValuestring""色值,非受控属性N
visiblebooleanfalse是否显示颜色选择器,usePopup 为 true 时有效N
customStylestring""自定义样式N

ColorPicker Events

名称参数描述
changedetail: UTSJSONObject值变化时触发
palette-bar-changedetail: UTSJSONObject-
closedetail: UTSJSONObject关闭时触发
update:visiblevalue: boolean显隐变化时触发

ColorPicker Slots

名称描述
header-
footer-