Skip to content

ColorPicker 颜色选择器

用于选择颜色并输出 HEX、RGB、HSV 或 HSL 字符串。

基础用法

禁用状态

尺寸

格式与透明度

预设色

自定义触发器

API

ColorPicker Props

继承自 Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children' | 'defaultValue' | 'onChange' | 'value'>

属性名描述类型默认值
children触发器插槽ReactNode-
value受控颜色值string-
defaultValue默认颜色值string-
format受控输出格式'hex' | 'rgb' | 'hsv' | 'hsl'-
defaultFormat默认输出格式'hex' | 'rgb' | 'hsv' | 'hsl'-
onChange颜色变化时触发(value: string, meta: { alpha: number; css: string; format: 'hex'; valid: boolean } & { hex: string } | { alpha: number; css: string; format: 'rgb'; valid: boolean } & { b: number; g: number; r: number } | { alpha: number; css: string; format: 'hsv'; valid: boolean } & { h: number; s: number; v: number } | { alpha: number; css: string; format: 'hsl'; valid: boolean } & { h: number; l: number; s: number }) => void-
onFormatChange格式变化时触发(format: 'hex' | 'rgb' | 'hsv' | 'hsl') => void-
presets预设色列表Array<string | { label?: string; value: string }>-
size触发器尺寸'small' | 'medium' | 'large'-
disabled禁用状态boolean-
placement浮层位置Placement-
offset浮层偏移OffsetOptions-
portalClassName浮层 Portal 类名string-

ColorPicker.Trigger Props

继承自 HTMLAttributes<HTMLElement>

属性名描述类型默认值
children自定义触发器元素ReactElement<any, string | JSXElementConstructor<any>>-