跳到主要内容

ColorPicker 取色器 ​

uni-appH5微信小程序App

uni-app 跨端颜色选择器。触发器显示色块与 hex 文本,面板含预设色板与 hex 手输。与 Web 版 API 一致。

何时使用 ​

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

何时不使用 ​

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

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
ColorPicker 取色器 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
modelValuestring"\"\""绑定值(v-model),hex '#rrggbb' 格式
presetsstring[]"12 个常用色"预设色板,hex 数组
disabledbooleanfalse禁用
sizestring:'sm' | 'md' | 'lg'"md"尺寸;移动端建议 md 或 lg
placeholderstring"请选择颜色"未选色时触发器占位文案

Events ​

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

示例 ​

基础用法 ​

vue
<ColorPicker v-model="color" />

尺寸与禁用 ​

vue
<view class="row">
  <ColorPicker v-model="color" size="sm" />
  <ColorPicker v-model="color" disabled />
</view>

自定义预设 ​

vue
<ColorPicker v-model="color" :presets="['#3b6ef6', '#22a06b', '#e2a03f', '#f56c6c', '#8b5cf6']" />