ColorPicker 取色器
uni-appH5微信小程序App
uni-app 跨端颜色选择器。触发器显示色块与 hex 文本,面板含预设色板与 hex 手输。与 Web 版 API 一致。
何时使用
需要用户挑选颜色:主题色、标签色、画板取色。
何时不使用
只需从少量固定色中选一个时,直接用 RadioGroup + 色块更轻。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string | "\"\"" | 绑定值(v-model),hex '#rrggbb' 格式 |
presets | string[] | "12 个常用色" | 预设色板,hex 数组 |
disabled | boolean | false | 禁用 |
size | string:'sm' | 'md' | 'lg' | "md" | 尺寸;移动端建议 md 或 lg |
placeholder | string | "请选择颜色" | 未选色时触发器占位文案 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | 选中预设或手输合法 hex 时触发 |
change | string | 颜色提交时触发 |
示例
基础用法
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']" />