跳到主要内容

ColorPicker 取色器 ​

WebH5

颜色选择器。触发器显示色块与 hex 文本,下拉含预设色板、hex 手输与原生取色器自定义。

何时使用 ​

需要用户挑选颜色:主题色、标签色、画板取色。

何时不使用 ​

只需从少量固定色中选一个时,直接用 RadioGroup + 色块更轻。

Props ​

名称类型默认值说明
modelValuestring"\"\""绑定值(v-model),hex '#rrggbb' 格式
presetsstring[]"12 个常用色"预设色板,hex 数组
disabledbooleanfalse禁用
sizestring:'sm' | 'md' | 'lg'"md"尺寸

Events ​

名称载荷说明
update:modelValuestring选中预设、手输合法 hex 或取色器选色时触发
changestring颜色提交时触发

示例 ​

基础 ​

示例加载中…

自定义预设 ​

示例加载中…

禁用态 + 选中值回显 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 ColorPicker 文档(含手机预览)。