Skip to content

ColorPicker 颜色选择器

用于颜色选择的交互组件

参数

Props

名称类型默认值描述
modelValueColor | nullnull选中的颜色值
showAlphabooleantrue是否显示透明度选择
showTextbooleantrue是否显示下方文本框
formatColorFormat'hex'指定输出颜色格式
inlinebooleanfalse是否内联模式
sizeComponentSize'medium'颜色选择器大小

Events

名称描述参数
update:modelValue颜色值更新事件(value: string | null) => void
change颜色值变化事件(value: string | null) => void

示例

基础用法

基本的颜色选择功能

大小

提供三种不同大小的选择器

透明度选择

控制是否显示透明度选择

内联模式

直接内联显示完整的颜色选择面板

TypeScript

ts
// 颜色格式类型
export type ColorFormat = "hex" | "rgb" | "hsl";

// 组件尺寸
export type ComponentSize = "small" | "medium" | "large";

// 颜色类型
export type Color = string | RGBColor | HSLColor;

// RGB颜色对象
export interface RGBColor {
  r: number; // 红色 0-255
  g: number; // 绿色 0-255
  b: number; // 蓝色 0-255
  a?: number; // 透明度 0-1
}

// HSL颜色对象
export interface HSLColor {
  h: number; // 色相 0-360
  s: number; // 饱和度 0-100
  l: number; // 亮度 0-100
  a?: number; // 透明度 0-1
}